# SEEK Scraper (`datahamster/seek-scraper`) Actor

SEEK scraper for Australian and New Zealand jobs. Search seek.com.au and seek.co.nz by keyword and location, filter by classification, work type, remote, salary and date, and get title, company, salary, location and teaser, plus the full description on demand. Monitor mode returns only new jobs.

- **URL**: https://apify.com/datahamster/seek-scraper.md
- **Developed by:** [Viktor Dubnytskiy](https://apify.com/datahamster) (community)
- **Categories:** Jobs
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.12 / 1,000 result items

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEEK Scraper

Search SEEK job ads in Australia (seek.com.au) and New Zealand (seek.co.nz) by keyword and location, and get one flat row per job: title, company, location, salary as advertised, work type, on-site/hybrid/remote, classification and sub-classification, listing date, the teaser and the bullet points, and on request the full job description and expiry date. No SEEK account and no cookies. Monitor mode turns the same search into an alert on new jobs.

**Try it:** the prefilled example returns 20 rows in about 6 seconds and costs about $0.03. Results cost $1.40 per 1,000.

### What you get

Real rows from the example dataset, which is the prefilled input (`queries: ["python developer", "data analyst"]`, `country: "AU"`, 10 per keyword):

| title / company | location | salary | work type | listed | query / rank |
|---|---|---|---|---|---|
| Data Analyst / NSW Police Force | Sydney Olympic Park, Sydney NSW | $116,981 - $129,492 | Contract/Temp | 2026-11-02 | data analyst / 6 |
| Senior Python Developer - Investments/Funds / Profusion Group | Melbourne VIC | min $1250+ pd + GST | Contract/Temp | 2026-10-28 | python developer / 2 |
| Software Engineer / Ucroo Pty Ltd | Melbourne VIC |  | Full time | 2026-10-28 | python developer / 3 |
| Data Analyst / Natural Selection Group | Melbourne VIC | $600-$700 inclusive of super | Contract/Temp | 2026-10-28 | data analyst / 4 |
| Senior Developer / Telair | Murarrie, Brisbane QLD |  | Full time | 2026-10-22 | python developer / 8 |

One full row:

```json
{
  "id": "95626176",
  "url": "https://www.seek.com.au/job/95626176",
  "jobId": "95626176",
  "title": "Data Analyst",
  "company": "NSW Police Force",
  "location": "Sydney Olympic Park, Sydney NSW",
  "locations": [
    "Sydney Olympic Park, Sydney NSW"
  ],
  "country": "AU",
  "salary": "$116,981 - $129,492",
  "workType": "Contract/Temp",
  "workArrangement": null,
  "classification": "Consulting & Strategy",
  "subClassification": "Analysts",
  "listedAt": "2026-11-02T00:04:52Z",
  "teaser": "We have an opportunity for a Data Analyst to join our Police Prosecutions & Licensing Enforcement Command in Sydney Olympic Park.",
  "bulletPoints": [],
  "isFeatured": false,
  "query": "data analyst",
  "rank": 6,
  "detailsFetched": false,
  "description": null,
  "expiresAt": null,
  "scrapedAt": "2026-11-02T18:14:07.219827Z"
}
```

With `includeDetails: true` the row also gets `description` (the full ad as plain text) and `expiresAt`.

Full row: `id` / `jobId`, `url`, `title`, `company`, `location`, `locations`, `country`, `salary`, `workType`, `workArrangement`, `classification`, `subClassification`, `listedAt`, `teaser`, `bulletPoints`, `isFeatured`, `query`, `rank`, `detailsFetched`, `scrapedAt`, and with `includeDetails: true` also `description` and `expiresAt`.

`id` is SEEK's job id, so a job found by two keywords is one row, and monitor mode tracks it across runs. `company` is the hiring company, or the advertiser account when SEEK shows no company name; jobs posted by private advertisers keep SEEK's own label "Private Advertiser". E-mail addresses and phone numbers typed into the teaser, bullet points or description are removed.

### Use cases

- **Daily job alert.** One saved task per search (`"queries": ["registered nurse"]`, `"location": "Brisbane QLD"`, `"listedWithin": "today"`) in monitor mode, scheduled every morning. Each run returns only the jobs that were not there yesterday.
- **Hiring signal for sales and recruiting.** Track which companies advertise roles in your niche across Australia or New Zealand and act on the `company` list.
- **Salary and market research.** Pull a few hundred ads for a role and compare advertised salaries, work types and remote/hybrid shares across cities.

### Try it

Hit **Start**: the prefilled input searches `python developer` and `data analyst` across Australia, 10 jobs per keyword, 20 rows in total. Set `country` to `NZ` for New Zealand, add a `location` such as `Sydney NSW` or `Auckland`, or set `includeDetails: true` for the full description.

**Monitor mode.** Save the input as a task and set:

```json
{
  "mode": "monitor",
  "monitorStateId": "nurse-brisbane-daily",
  "queries": ["registered nurse"],
  "location": "Brisbane QLD",
  "listedWithin": "3d",
  "webhookUrl": "https://your-endpoint.example.com/hook"
}
```

Put the task on a schedule (Apify, Schedules, cron `0 7 * * *` for daily). Monitor mode always reads the search newest first (`sortBy` is ignored), so a fresh ad is not buried behind older, better-matching ones. Each run compares against the previous one and returns only jobs whose id it has not seen before, and with `includeDetails` it fetches the description only for those new jobs. An edited ad or a changed salary label does not come back as new. Point `webhookUrl` or the Telegram fields at your own channel to get the new jobs pushed to you.

### Input

| Field | Meaning | Default |
|---|---|---|
| `queries` | Keywords, one per line | `["python developer"]` |
| `country` | `AU` (seek.com.au) or `NZ` (seek.co.nz) | `AU` |
| `location` | Suburb, city, region or state as SEEK spells it, e.g. `Sydney NSW`, `Melbourne`, `Auckland`. Empty = the whole country | empty |
| `classification` | SEEK classifications, e.g. `Information & Communication Technology`, `Healthcare & Medical` | all |
| `workType` | `full-time`, `part-time`, `contract-temp`, `casual-vacation` | all |
| `workArrangement` | `on-site`, `hybrid`, `remote` | all |
| `listedWithin` | `any`, `today`, `3d`, `7d`, `14d`, `31d` | `any` |
| `salaryType`, `salaryMin`, `salaryMax` | SEEK's salary filter: `annual`, `monthly` or `hourly`, with a lower and/or upper bound | none |
| `sortBy` | `relevance` or `date` (newest first); monitor mode always uses `date` | `relevance` |
| `includeDetails` | Add the full description and expiry date (one extra request per job) | `false` |
| `maxResultsPerQuery` | Stop each keyword after this many jobs | `100` |
| `maxItems` | Stop the whole run after this many rows | `100` |
| `mode` | `scrape`, or `monitor` for new jobs only | `scrape` |
| `monitorStateId`, `webhookUrl`, `telegramBotToken`, `telegramChatId` | Monitor-mode state key and alert targets | empty |

### Pricing

| Event | Price |
|---|---|
| result | $0.0014 per job ($1.40 per 1,000) |
| monitor-check | $0.005 per monitor run |
| change | $0.0014 per new job in monitor mode |

Apify Store discounts: SILVER -10%, GOLD and higher -20% on every event.

You pay only for rows that are pushed, and a search that finds nothing charges no result events. Apify platform usage is billed by Apify on top. Runs start without a proxy and move to a datacenter, then a residential proxy only when SEEK refuses the cheaper one.

**Found it useful?** A short review on the Store page helps other people find this actor. If a search misbehaves, open an issue on the actor page.

### Related actors

- [LinkedIn Jobs Scraper](https://apify.com/datahamster/linkedin-jobs-scraper) for the same roles on LinkedIn, in Australia, New Zealand or anywhere else.
- [Glassdoor Jobs Scraper: Salary Estimates, Ratings, Monitor](https://apify.com/datahamster/glassdoor-jobs) for employer ratings and salary estimates next to the postings.
- [Career Site Jobs Monitor: Greenhouse, Lever, Ashby, Workday](https://apify.com/datahamster/ats-jobs) to watch a specific employer's own career site.
- [Remote Jobs Scraper: RemoteOK, Remotive +4](https://apify.com/datahamster/remote-jobs-aggregator) for remote roles from six remote job boards in one feed.

### Limits

- One run searches one country. Run a second task for the other one.
- A location SEEK does not recognise returns nothing, and the run ends as `no_matches` with a warning in the log. Write it the way SEEK's own location box suggests it (`Sydney NSW`, `Parramatta NSW`, `Wellington`).
- `salary` is the free-text label the advertiser typed (`$116,981 - $129,492`, `min $1250+ pd + GST`), so it is not always a number and is sometimes not a salary at all. About two thirds of ads show no salary label. SEEK applies its salary filter to the pay the advertiser entered behind the label, so a matched ad can show a label in another unit or no label at all.
- `workArrangement` is filled only when the advertiser set it on the ad.
- `description` needs `includeDetails: true` and costs one extra request per job, so runs with it are slower. Ads from a "Private Advertiser" keep the teaser only, without the full description. If SEEK refuses three description requests in a row, the rest of the run returns search fields only (`SEEK_STATS.detailsStopped`).
- SEEK's search has no "no results" padding: a keyword it cannot match returns nothing and charges nothing.

### FAQ

**Do I need a SEEK account or cookies?** No. The actor reads the same public search that seek.com.au shows a visitor who is not signed in.

**Why did my keyword return nothing?** Either SEEK has no jobs for it with your filters, or the `location` was not recognised. The `RUN_SUMMARY` record in the run's key-value store has `emptyReason` (`no_matches` or `blocked`), and `SEEK_STATS` lists `emptyQueries` and `unresolvedLocation`.

**Can I get the recruiter's contact details?** No. Rows hold job and company data only, and e-mail addresses and phone numbers are removed from the job text.

### Changelog

- 0.1: initial release with keyword and location search in Australia and New Zealand, classification, work type, work arrangement, salary and listing-date filters, sort by date, optional full description, and monitor mode for new jobs.

# Actor input Schema

## `queries` (type: `array`):

Job keywords to search on SEEK, one per line, e.g. "python developer", "registered nurse", "electrician". Each keyword is a separate SEEK search with the filters below.

## `country` (type: `string`):

Which SEEK site to search. Example: AU.

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

Suburb, city, region or state the way SEEK's location box spells it, e.g. "Sydney NSW", "Melbourne", "Brisbane QLD", "Auckland". Leave empty for the whole country. A location SEEK does not recognise returns nothing.

## `classification` (type: `array`):

Keep only jobs in these SEEK classifications, e.g. \["Information & Communication Technology"]. Empty = all.

## `workType` (type: `array`):

Keep only these work types, e.g. \["full-time", "contract-temp"]. Empty = all.

## `workArrangement` (type: `array`):

Keep only jobs with these work arrangements, e.g. \["remote"]. Only ads where the advertiser set it match. Empty = all.

## `listedWithin` (type: `string`):

Only jobs listed within this window. SEEK applies it on its side. Example: today for a daily alert.

## `salaryType` (type: `string`):

Unit of Salary from / Salary to. Used only when one of them is set.

## `salaryMin` (type: `integer`):

Lower salary bound in the chosen unit, e.g. 120000 (annual) or 50 (hourly). Empty = no lower bound.

## `salaryMax` (type: `integer`):

Upper salary bound in the chosen unit. Empty = no upper bound.

## `sortBy` (type: `string`):

SEEK's sort order. Monitor mode always sorts by date. Example: date for a feed of the newest ads.

## `includeDetails` (type: `boolean`):

true = fetch every job's full description (plain text, contacts removed) and expiry date. One extra request per job, so slower. Ads from a Private Advertiser keep the teaser only. Example: false.

## `maxResultsPerQuery` (type: `integer`):

Stop each keyword after this many jobs, so one broad keyword cannot use up Max items for the others. Example: 100.

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

Stop the whole run after this many jobs (you are charged only for pushed jobs). Example: 20.

## `mode` (type: `string`):

scrape = full results; monitor = only new/changed items since the previous run of this task

## `monitorStateId` (type: `string`):

Optional state id when not running as a saved task (monitor mode)

## `webhookUrl` (type: `string`):

POST a change summary here in monitor mode

## `telegramBotToken` (type: `string`):

Optional: bot token for monitor-mode change summaries

## `telegramChatId` (type: `string`):

Optional: chat id that receives monitor-mode summaries

## Actor input object example

```json
{
  "queries": [
    "python developer",
    "data analyst"
  ],
  "country": "AU",
  "location": "",
  "listedWithin": "any",
  "salaryType": "annual",
  "sortBy": "relevance",
  "includeDetails": false,
  "maxResultsPerQuery": 10,
  "maxItems": 20,
  "mode": "scrape"
}
```

# Actor output Schema

## `results` (type: `string`):

All pushed rows (dataset, JSON)

## `resultsTable` (type: `string`):

Dataset in the Console viewer

## `runSummary` (type: `string`):

RUN_SUMMARY record

# 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 = {
    "queries": [
        "python developer",
        "data analyst"
    ],
    "maxResultsPerQuery": 10,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("datahamster/seek-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 = {
    "queries": [
        "python developer",
        "data analyst",
    ],
    "maxResultsPerQuery": 10,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("datahamster/seek-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 '{
  "queries": [
    "python developer",
    "data analyst"
  ],
  "maxResultsPerQuery": 10,
  "maxItems": 20
}' |
apify call datahamster/seek-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datahamster/seek-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/GU0wgbo6UDUoXjK2a/builds/MdUx5L0AhfOAZWpxf/openapi.json
