# Snagajob Job Listings Scraper (`parseforge/snagajob-scraper`) Actor

Scrapes Snagajob job listings by keyword and location. Returns each listing as a flat row with title, wage, employer, and location. Export to CSV, JSON, Excel, or XML.

- **URL**: https://apify.com/parseforge/snagajob-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Jobs, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $18.99 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Snagajob Job Listings Scraper

**Scrape Snagajob job listings by keyword and location, up to a million per run.** Every listing comes with its title, wage, employer, and location in one flat row. No login or API key. Export to CSV, JSON, Excel, or XML.

Snagajob's official site is built for job seekers, not for bulk data collection. This reads the public job search results directly, filtered by keyword, location, and radius, and returns each match in one fixed schema. You get the hourly job data you need without writing a scraper or dealing with rate limits.

| Who uses it | What they scrape Snagajob for |
|---|---|
| Market researchers | Track which hourly jobs are open in a metro area this week |
| Job board operators | Fill a niche job board with fresh Snagajob listings |
| Workforce analysts | Measure wage ranges and employer demand for hourly roles |
| Recruiters | Find active hourly job postings to source candidates |

### What it does

This Actor collects Snagajob job listings by keyword and location, and returns each one as a flat row.

- 🔍 **Keyword search:** any job title or keyword, like cashier, warehouse, or restaurant.
- 📍 **Location filter:** city, state, or ZIP code, with a radius from 1 to 100 miles.
- 📊 **Flat output:** one row per listing, ready for CSV, JSON, Excel, or XML export.
- ⚡ **High volume:** collect up to 1,000,000 listings in a single run.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Snagajob data

**📈 Track hourly job demand.**

A market researcher runs the Actor weekly for a metro area and compares the number of cashier and warehouse listings to spot hiring trends.

**🛠️ Build a niche job board.**

A developer scrapes Snagajob listings for restaurant jobs in Chicago and feeds them into a local hospitality job board.

**💰 Analyze wage ranges.**

A workforce analyst collects listings for retail roles and aggregates the wage fields to report on pay by employer and location.

**🎯 Source candidates faster.**

A recruiter scrapes active hourly postings for a client and filters by location to build a list of employers that are hiring now.

### Why choose this scraper

|  | What you get |
|---|---|
| **No API key** | Public search results, no registration or OAuth |
| **One fixed schema** | Every listing returns the same fields, no parsing surprises |
| **Runs on Apify** | Schedule it, proxy it, and store results automatically |

### How it compares

This Actor and the Snagajob Jobs Search Scraper both collect Snagajob search results, but they differ in field depth and configuration.

| Feature | ParseForge | Snagajob Jobs Search Scraper |
|---|---|---|
| Keyword search | Yes | Yes |
| Location filter | Yes | Yes |
| Radius filter | Yes | Not listed |
| 40+ fields per listing | Not listed | Yes |
| Max items per run | Up to 1,000,000 | Not listed |

### Configure the run

Drive the Actor from a keyword and a location, and the radius filter runs as each listing is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "maxItems": 10,
  "keyword": "cashier",
  "location": "New York, NY"
}
```

A larger pull:

```json
{
  "maxItems": 200,
  "keyword": "cashier",
  "location": "New York, NY"
}
```

### Pricing

Pay-per-result: **$0.02534 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $2.53 |
| 1,000 results | $25.34 |
| 10,000 results | $253.40 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Snagajob Job Listings Scraper](https://apify.com/parseforge/snagajob-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Snagajob through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/snagajob-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Make sure the keyword and location are valid and the radius is not too small. Try a broader keyword or a larger radius. Also check that Snagajob has listings for that search in a normal browser.

**Why did the run stop before reaching maxItems?**

The Actor stops when there are no more results to paginate. If Snagajob only has 50 listings for your search, you will get 50, not maxItems.

**Why are some fields empty?**

Snagajob does not show every field for every listing. If a wage or employer is missing on the site, it will be missing in your dataset.

**Why did I get blocked or see a captcha?**

Snagajob may rate-limit aggressive scraping. Use Apify's proxy options and increase the delay between requests if needed.

**Can I get more than 1,000,000 listings?**

The maxItems limit is 1,000,000 per run. If you need more, split your search into multiple runs by location or keyword.

### FAQ

| Question | Answer |
|---|---|
| Do I need a Snagajob account or API key? | No. The Actor reads the public search results that anyone can see in a browser. No login, no API key, no OAuth. |
| What data does each listing include? | Each row includes the job title, employer, wage, location, and other fields that Snagajob shows on the search results page. The exact fields are listed in the sample output. |
| Can I filter by job type or schedule? | The current input supports keyword, location, and radius. Job type and schedule filters are not available in this version. |
| How many listings can I get in one run? | You can set maxItems up to 1,000,000. The actual number depends on how many listings match your search. |
| Is this legal? | You are responsible for complying with Snagajob's terms of service and applicable laws. Apify provides the tool, not legal advice. |
| Can I schedule this to run daily? | Yes. Once you have the Actor configured, you can set up a schedule in Apify to run it as often as you need. |
| What output formats are supported? | You can export the dataset as CSV, JSON, Excel, or XML from the Apify console or via API. |
| Does it handle pagination? | Yes. The Actor follows the search result pages until it reaches maxItems or there are no more results. |
| Can I search by ZIP code? | Yes. The location field accepts city, state, or ZIP code, and the radius filter works with all of them. |
| What if I get no results? | Check that your keyword and location are spelled correctly and that the radius is wide enough. Snagajob may also have no listings for that combination. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Snagajob, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `maxItems` (type: `integer`):

How many job listings to collect per run.

## `keyword` (type: `string`):

Search jobs by keyword (e.g. "cashier", "warehouse", "restaurant")

## `location` (type: `string`):

Search by city, state, or zip code (e.g. "New York, NY", "90210")

## `radiusInMiles` (type: `integer`):

Search radius in miles from the location

## Actor input object example

```json
{
  "maxItems": 10,
  "keyword": "cashier",
  "location": "New York, NY",
  "radiusInMiles": 20
}
```

# Actor output Schema

## `overview` (type: `string`):

Overview of job listings with key fields

## `fullData` (type: `string`):

Complete dataset with all scraped job fields

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "keyword": "cashier",
    "location": "New York, NY"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/snagajob-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "keyword": "cashier",
    "location": "New York, NY",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/snagajob-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "keyword": "cashier",
  "location": "New York, NY"
}' |
apify call parseforge/snagajob-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/snagajob-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/i5p8mCBs0idHTjCQb/builds/PdD858tRTvNgoMc1O/openapi.json