# SEEK New Zealand Scraper — Jobs from seek.co.nz (`unfenced-group/seek-co-nz-scraper`) Actor
Scrape jobs from SEEK New Zealand (seek.co.nz). Filter by keyword, location, work type, and date. Salary extraction, deduplication, full descriptions.
- **URL**: https://apify.com/unfenced-group/seek-co-nz-scraper.md
- **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.69 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
## SEEK New Zealand Scraper
Extract job listings from [SEEK New Zealand](https://www.seek.co.nz) — New Zealand's largest job board. Filter by keyword, location, work type, category, and date. Optionally fetch full job descriptions with expiry dates and contact details. Supports incremental runs with built-in deduplication.
**Pricing: $0.69 per 1,000 results.**
---
### ⚡ Fast by design
This actor uses **GraphQL batching** — all jobs on a search page are fetched in a single API request instead of one request per job. Result: 1,000 listings with full descriptions in under 1 minute.
| | This actor | Typical per-job scraper |
|---|---|---|
| Requests per 1,000 jobs | **~20** | ~1,010 |
| Time per 1,000 jobs (`fetchDetails: true`) | **~1 min** | ~25 min |
---
### Features
- **Keyword and location search** — find jobs by title, skill, or role across any NZ region
- **Work type filtering** — Full time, Part time, Contract/Temp, Casual/Vacation
- **Job category filtering** — filter by industry category (ICT, Healthcare, Engineering, Sales, etc.)
- **Date filtering** — only return jobs posted within N days
- **Full description** — optional fetch of the complete job description per listing
- **Expiry date** — when each listing expires (`expiresAtUtc`)
- **Contact details** — email and phone numbers extracted from the listing body when published
- **Salary extraction** — min/max salary and period (hourly/annual) parsed from salary label
- **Work arrangement** — Remote, Hybrid, or On-site when provided
- **Advertiser info** — id, verification status, and registration date on SEEK
- **Cross-run deduplication** — tracks seen jobs across runs; marks reposts with `isRepost: true`
- **Start URLs** — scrape a specific list of SEEK NZ job URLs directly
---
### Input parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| `searchQuery` | string | — | Keywords to search for (job title, skill, etc.) |
| `location` | string | — | Location filter, e.g. `Auckland`, `Wellington`, `Christchurch` |
| `workType` | string | `Any` | `Full time`, `Part time`, `Contract/Temp`, `Casual/Vacation` |
| `classificationId` | integer | — | SEEK category ID (see list below) |
| `daysOld` | integer | — | Maximum listing age in days |
| `sortMode` | string | `KeywordRelevance` | `KeywordRelevance` or `ListedDate` |
| `maxResults` | integer | `100` | Maximum results to return (max 500 per search) |
| `fetchDetails` | boolean | `false` | Fetch full HTML job description, expiry date, and contacts per listing |
| `startUrls` | array | — | Specific SEEK NZ job URLs to scrape |
| `requestDelayMs` | integer | `500` | Delay between requests in ms |
| `respectRobotsTxt` | boolean | `true` | Respect SEEK's crawl-delay guidelines |
#### Common category IDs
| ID | Category |
|---|---|
| 6281 | Information & Communication Technology |
| 1211 | Healthcare & Medical |
| 1209 | Engineering |
| 1200 | Accounting |
| 6362 | Sales |
| 6251 | Administration & Office Support |
| 1204 | Call Centre & Customer Service |
| 1206 | Construction |
| 1212 | Hospitality & Tourism |
| 6123 | Education & Training |
---
### Output schema
#### Always present
| Field | Type | Description |
|---|---|---|
| `id` | string | SEEK job ID |
| `title` | string | Job title |
| `company` | string | Employer name |
| `location` | string | Location label, e.g. `Auckland CBD, Auckland` |
| `locationCountry` | string | Always `NZ` |
| `workType` | string | `Full time`, `Part time`, `Contract/Temp`, `Casual/Vacation` |
| `workArrangement` | string\|null | `Remote`, `Hybrid`, `On-site` when provided |
| `category` | string | Industry category |
| `subCategory` | string\|null | Sub-category when available |
| `classificationId` | integer | SEEK category ID |
| `salaryLabel` | string\|null | Raw salary string as displayed on SEEK |
| `salaryMin` | number\|null | Minimum salary (parsed) |
| `salaryMax` | number\|null | Maximum salary (parsed) |
| `salaryCurrency` | string | Always `NZD` |
| `salaryPeriod` | string\|null | `YEAR`, `HOUR`, or `WEEK` |
| `teaser` | string\|null | Short job summary (1–2 sentences) |
| `bulletPoints` | array | Highlights from sponsored listings |
| `publishDate` | string | Publication date in Auckland timezone (`YYYY-MM-DD`) |
| `publishDateISO` | string | Publication date/time in UTC ISO 8601 |
| `isFeatured` | boolean | Whether listing is sponsored/featured |
| `roleId` | string\|null | Standardised SEEK role slug, e.g. `software-developer`, `registered-nurse` |
| `logoUrl` | string\|null | Company logo image URL (from SEEK branding CDN) |
| `companyProfileUrl` | string\|null | SEEK company profile page URL (present for verified employers) |
| `url` | string | Full URL to the SEEK NZ job listing |
| `isRepost` | boolean | `true` if this job was seen in a previous run |
| `originalPublishDate` | string\|null | First-seen publish date for reposts |
#### With `fetchDetails: true`
| Field | Type | Description |
|---|---|---|
| `description` | string\|null | Full HTML job description |
| `status` | string\|null | Listing status from SEEK, e.g. `Active` |
| `isExpired` | boolean\|null | Whether the listing has expired |
| `expiresAtUtc` | string\|null | ISO 8601 UTC timestamp when the listing expires |
| `contactMatches` | array | Email and phone contacts when published by the employer |
| `advertiser` | object | `id`, `name`, `isVerified`, `registrationDate` of the SEEK advertiser |
---
### Output example
```json
{
"id": "91866432",
"title": "Community Registered Nurse",
"company": "Mary Potter Hospice",
"location": "Porirua, Wellington",
"locationCountry": "NZ",
"workType": "Full time",
"workArrangement": null,
"category": "Healthcare & Medical",
"subCategory": "Nursing",
"classificationId": 1211,
"salaryLabel": "$38 – $45 per hour",
"salaryMin": 38,
"salaryMax": 45,
"salaryCurrency": "NZD",
"salaryPeriod": "HOUR",
"teaser": "Specialist palliative care nursing role based in Porirua.",
"bulletPoints": [],
"publishDate": "2026-05-02",
"publishDateISO": "2026-05-01T22:34:05.120Z",
"isFeatured": false,
"roleId": "community-registered-nurse",
"logoUrl": "https://bx-branding-gateway.cloud.seek.com.au/abc123.1/jdpLogo",
"companyProfileUrl": null,
"url": "https://www.seek.co.nz/job/91866432",
"description": "Mary Potter Hospice is seeking...
",
"status": "Active",
"isExpired": false,
"expiresAtUtc": "2026-06-01T14:00:00.000Z",
"contactMatches": [{ "type": "Email", "value": "recruitment@marypotter.org.nz" }],
"advertiser": {
"id": "44123456",
"name": "Mary Potter Hospice",
"isVerified": true,
"registrationDate": "2015-03-10T01:22:00.000Z"
},
"isRepost": false,
"originalPublishDate": null,
"originalUrl": null
}
````
***
### Usage examples
#### 1. Search developer jobs in Auckland
```json
{
"searchQuery": "developer",
"location": "Auckland",
"maxResults": 100
}
```
#### 2. All healthcare jobs, last 7 days, with full descriptions
```json
{
"classificationId": 1211,
"daysOld": 7,
"fetchDetails": true,
"maxResults": 200
}
```
#### 3. Daily feed of new jobs (incremental mode)
```json
{
"daysOld": 1,
"sortMode": "ListedDate",
"maxResults": 500
}
```
New jobs are compared against previous runs. Reposts are flagged with `isRepost: true`.
#### 4. Scrape specific job URLs
```json
{
"startUrls": [
{ "url": "https://www.seek.co.nz/job/91693135" },
{ "url": "https://www.seek.co.nz/job/91866432" }
],
"fetchDetails": true
}
```
***
### Performance
| Run size | `fetchDetails` | Estimated time |
|---|---|---|
| 100 results | `false` | ~5 seconds |
| 100 results | `true` | ~10 seconds |
| 500 results | `false` | ~15 seconds |
| 500 results | `true` | **~30 seconds** |
GraphQL batching resolves a full page of 100 jobs in a single API request (~600ms). This is 20–30× faster than scrapers that make one detail request per job.
- **Memory:** 256 MB
- **Proxy:** None required
***
### Pricing
**$0.69 per 1,000 results.**
A run returning 500 jobs costs approximately $0.35 plus a small start fee.
***
### Notes
- **500 results per search**: SEEK limits pagination to 5 pages of 100 results. Use `classificationId` batching or `daysOld` filtering to retrieve more data across multiple runs.
- **Salary**: Not all listings include salary information. When absent, salary fields are `null`.
- **Work arrangement**: Only available from search results. When using `startUrls`, this field is always `null`.
- **`contactMatches`**: Requires `fetchDetails: true`. Not all employers publish contact details.
# Actor input Schema
## `searchQuery` (type: `string`):
Job title, skill, or keyword to search for. Leave empty to scrape all jobs.
## `location` (type: `string`):
Location to filter by, e.g. 'Auckland', 'Wellington', 'Christchurch', 'All New Zealand'.
## `workType` (type: `string`):
Filter by employment type.
## `classificationId` (type: `integer`):
SEEK classification ID to filter by category. Leave blank for all categories. Common IDs: 6281=ICT, 1209=Engineering, 1211=Healthcare, 1200=Accounting, 6362=Sales, 6251=Admin.
## `daysOld` (type: `integer`):
Only return listings posted within this many days. Leave blank for all listings.
## `sortMode` (type: `string`):
Sort results by relevance or listing date.
## `maxResults` (type: `integer`):
Maximum number of job listings to return. SEEK caps at 500 per search query. Use category-based batching (classificationId) to get more.
## `fetchDetails` (type: `boolean`):
If enabled, fetches the full HTML job description for each listing (slower, but richer output). If disabled, only the teaser is returned.
## `startUrls` (type: `array`):
Optional list of specific SEEK NZ job URLs to scrape. When provided, search parameters are ignored.
## `requestDelayMs` (type: `integer`):
Minimum delay between requests in milliseconds. Increase to reduce load on SEEK servers.
## `respectRobotsTxt` (type: `boolean`):
If enabled, the scraper respects SEEK's robots.txt crawl-delay directives.
## Actor input object example
```json
{
"searchQuery": "software developer",
"location": "Auckland",
"workType": "Any",
"daysOld": 7,
"sortMode": "KeywordRelevance",
"maxResults": 100,
"fetchDetails": true,
"startUrls": [
{
"url": "https://www.seek.co.nz/job/12345678"
}
],
"requestDelayMs": 500,
"respectRobotsTxt": true
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {};
// Run the Actor and wait for it to finish
const run = await client.actor("unfenced-group/seek-co-nz-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {}
# Run the Actor and wait for it to finish
run = client.actor("unfenced-group/seek-co-nz-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{}' |
apify call unfenced-group/seek-co-nz-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=unfenced-group/seek-co-nz-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "SEEK New Zealand Scraper — Jobs from seek.co.nz",
"description": "Scrape jobs from SEEK New Zealand (seek.co.nz). Filter by keyword, location, work type, and date. Salary extraction, deduplication, full descriptions.",
"version": "0.0",
"x-build-id": "tWp1WaIBFbgOVWckZ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/unfenced-group~seek-co-nz-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-unfenced-group-seek-co-nz-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/unfenced-group~seek-co-nz-scraper/runs": {
"post": {
"operationId": "runs-sync-unfenced-group-seek-co-nz-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/unfenced-group~seek-co-nz-scraper/run-sync": {
"post": {
"operationId": "run-sync-unfenced-group-seek-co-nz-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchQuery": {
"title": "Search query (keywords)",
"type": "string",
"description": "Job title, skill, or keyword to search for. Leave empty to scrape all jobs."
},
"location": {
"title": "Location",
"type": "string",
"description": "Location to filter by, e.g. 'Auckland', 'Wellington', 'Christchurch', 'All New Zealand'."
},
"workType": {
"title": "Work type",
"enum": [
"Any",
"Full time",
"Part time",
"Contract/Temp",
"Casual/Vacation"
],
"type": "string",
"description": "Filter by employment type.",
"default": "Any"
},
"classificationId": {
"title": "Job category ID",
"minimum": 1,
"type": "integer",
"description": "SEEK classification ID to filter by category. Leave blank for all categories. Common IDs: 6281=ICT, 1209=Engineering, 1211=Healthcare, 1200=Accounting, 6362=Sales, 6251=Admin."
},
"daysOld": {
"title": "Maximum listing age (days)",
"minimum": 1,
"type": "integer",
"description": "Only return listings posted within this many days. Leave blank for all listings."
},
"sortMode": {
"title": "Sort order",
"enum": [
"KeywordRelevance",
"ListedDate"
],
"type": "string",
"description": "Sort results by relevance or listing date.",
"default": "KeywordRelevance"
},
"maxResults": {
"title": "Maximum results",
"minimum": 1,
"type": "integer",
"description": "Maximum number of job listings to return. SEEK caps at 500 per search query. Use category-based batching (classificationId) to get more.",
"default": 100
},
"fetchDetails": {
"title": "Fetch full job description",
"type": "boolean",
"description": "If enabled, fetches the full HTML job description for each listing (slower, but richer output). If disabled, only the teaser is returned.",
"default": true
},
"startUrls": {
"title": "Start URLs (optional)",
"type": "array",
"description": "Optional list of specific SEEK NZ job URLs to scrape. When provided, search parameters are ignored.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"requestDelayMs": {
"title": "Delay between requests (ms)",
"minimum": 0,
"type": "integer",
"description": "Minimum delay between requests in milliseconds. Increase to reduce load on SEEK servers.",
"default": 500
},
"respectRobotsTxt": {
"title": "Respect robots.txt",
"type": "boolean",
"description": "If enabled, the scraper respects SEEK's robots.txt crawl-delay directives.",
"default": true
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```