nz.seek.com APInz.seek.com ↗
Search SEEK NZ job listings by keyword, location, and salary range. Get full job details including description, bullets, work type, and advertiser info.
curl -X GET 'https://api.parse.bot/scraper/6f3f8e62-caf1-482e-ab3f-9f93af22e4c6/search_jobs?keyword=nurse&location=Wellington' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for jobs on SEEK NZ by keyword, location, and salary range. Returns paginated job listings with title, company, location, salary, description, and classification.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (starts at 1) |
| keywordrequired | string | Job title or keyword to search for (e.g., 'software engineer', 'nurse', 'data analyst') |
| location | string | Location to search in (e.g., 'Auckland', 'Wellington', 'Christchurch'). Omitting returns jobs across all of New Zealand. |
| salary_max | string | Maximum salary filter as a numeric string (e.g., '120000') |
| salary_min | string | Minimum salary filter as a numeric string (e.g., '80000') |
| salary_type | string | Salary type filter. Accepted values: 'annual', 'hourly'. |
{
"type": "object",
"fields": {
"jobs": "array of job objects with id, title, company, location, salary, description, classification, sub_classification, listing_date, job_url, is_premium",
"page": "integer - current page number",
"total_count": "integer - total number of matching jobs",
"jobs_on_page": "integer - number of jobs returned on this page"
},
"sample": {
"data": {
"jobs": [
{
"id": "92122745",
"title": "Clinical Nurse Lead - Cervical Screening",
"salary": "$100,000 – $120,000 per year",
"company": "Whakarongorau Aotearoa",
"job_url": "https://nz.seek.com/job/92122745?type=promoted&ref=search-standalone&origin=cardTitle",
"location": "Wellington Central, Wellington",
"is_premium": true,
"description": "Lead change in 2025! Join our Cervical Screening Team as Clinical Nurse Lead.",
"listing_date": "Featured",
"classification": "Healthcare & Medical",
"sub_classification": "Other"
}
],
"page": 1,
"total_count": 335,
"jobs_on_page": 22
},
"status": "success"
}
}About the nz.seek.com API
The SEEK New Zealand API gives access to the nz.seek.com job board through 2 endpoints, returning up to dozens of fields per listing. Use search_jobs to query live postings by keyword, location, and salary range, or call get_job_details with a job ID to retrieve the full description, key selling-point bullets, ISO listing timestamp, and advertiser information for any individual role.
Search Jobs
The search_jobs endpoint accepts a required keyword parameter — job title, skill, or role type — alongside optional location, salary_min, salary_max, and salary_type filters (annual or hourly). Results are paginated; the response includes total_count (total matching jobs), jobs_on_page (results in the current page), and a page integer so you can walk through result sets. Each job object in the jobs array carries an id, title, company, location, salary, short description, classification, sub_classification, and listing_date.
Job Details
get_job_details takes a single job_id (the numeric string from search_jobs results) and returns the complete record for that posting: content (full plain-text description), abstract (short summary), bullets (key selling points the advertiser highlights), salary, currency, location, listed_at (ISO 8601 datetime), and status (e.g. Active). This is the right endpoint when you need the untruncated job description or want to extract requirements and responsibilities programmatically.
Coverage and Scope
The API covers the New Zealand SEEK domain (nz.seek.com). Location filtering maps to major NZ cities such as Auckland, Wellington, and Christchurch, and omitting a location returns results across all of New Zealand. Salary filters expect numeric strings and apply to the advertised salary range where disclosed — many listings on SEEK do not publish salary, so salary fields may be null in search results or detail responses.
- Aggregate NZ tech job listings by keyword ('software engineer', 'data analyst') for a local job board or newsletter
- Monitor salary ranges across classifications to build NZ compensation benchmarking datasets
- Feed job alert notifications using
listing_dateto identify postings added since a last check - Extract
bulletsandcontentfromget_job_detailsto analyse in-demand skills across industries - Build a regional employment dashboard filtering by Auckland, Wellington, or Christchurch using the
locationparam - Compare advertised salaries for hourly vs annual roles by toggling the
salary_typefilter - Populate a recruitment CRM with structured job data including
classificationandsub_classificationfor categorisation
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SEEK have an official developer API?+
What does `search_jobs` return versus `get_job_details`?+
search_jobs returns a paginated list with brief per-listing fields: id, title, company, location, salary, a short description, classification, sub_classification, and listing_date. get_job_details returns the full record for a single job, adding content (complete plain-text description), abstract, bullets (advertiser-supplied selling points), currency, listed_at as an ISO datetime, and status. Use search to discover IDs, then fetch details for the full text.Are there any limitations around salary data?+
salary and currency fields will be null for listings where no salary was published. The salary_min and salary_max search filters only narrow to jobs that have an advertised salary matching the range, so using them will exclude any undisclosed-salary postings that might otherwise be relevant.Does the API return application URLs or the ability to apply for jobs?+
title, content, bullets, salary, and classification — but does not return a direct application URL or submit applications. You can fork this API on Parse and revise it to add an endpoint that surfaces the application link from a job's detail page.Can I filter jobs by work type (full-time, part-time, contract)?+
get_job_details responses but is not currently an input filter on search_jobs. The search endpoint filters by keyword, location, and salary parameters only. You can fork this API on Parse and revise the search endpoint to add a work-type filter parameter.