Skip to content
Scrappa Get API key
SEEK API 1 credit/request

SEEK Job Search API Documentation

GET https://scrappa.co/api/seek/jobs

SEEK Job Search API Documentation Search public SEEK job listings by keyword, location, classification and work type, for Australia (au) or New Zealand (nz). Each job has id, title, public url, teaser, bullet points, company name, advertiser, classifications, locations, work types, work arrangements, salary text when SEEK shows one, listing time (ISO 8601, UTC) and logo url. Page with page and limit; has_more is true while more jobs exist. SEEK returns at most 500 jobs per search, so narrow large searches by location or classification. A valid search with no matches is a successful response.

SEEK Job Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/seek/jobs
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "jobs": [
            {
                "id": "95234521",
                "url": "https://www.seek.com.au/job/95234521",
                "title": "Virtual Registered Nurse (Triage)",
                "teaser": "Join the Amplar Health/ Medibank Nurse Triage team, delivering vital virtual care around Australia",
                "logo_url": "https://bx-branding-gateway.cloud.seek.com.au/89bcfb6d-31e9-4591-b9eb-061bf54b1dc9.1/jdpLogo",
                "listed_at": "2026-10-13T06:05:23Z",
                "locations": [
                    "Melbourne VIC"
                ],
                "advertiser": {
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

10 optional filters available.

country string Optional

Market to search: au (Australia) or nz (New Zealand). Defaults to au.

Example value US
keywords string Optional

Search words such as a job title. Example: nurse.

Example value running shoes
location string Optional

SEEK location name. Example: All Melbourne VIC.

Example value Austin, Texas
distance integer Optional

Search radius in km around the location, 1 to 200. Only used together with location.

Example value 10
classification string Optional

Comma separated numeric SEEK classification ids. Example: 1211 (Healthcare & Medical).

Example value example
work_type string Optional

Comma separated work type ids: 242 full time, 243 part time, 244 contract/temp, 245 casual.

Example value example
sort string Optional

relevance (default) or date.

Example value relevance
days integer Optional

Only jobs listed in the last 1 to 31 days.

Example value 10
page integer Optional

Page number starting at 1. SEEK returns at most 500 jobs per search, so page times limit must be 500 or less.

Example value 1
limit integer Optional

Jobs per page, 1 to 100. Defaults to 22.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "jobs": [
            {
                "id": "95234521",
                "url": "https://www.seek.com.au/job/95234521",
                "title": "Virtual Registered Nurse (Triage)",
                "teaser": "Join the Amplar Health/ Medibank Nurse Triage team, delivering vital virtual care around Australia",
                "logo_url": "https://bx-branding-gateway.cloud.seek.com.au/89bcfb6d-31e9-4591-b9eb-061bf54b1dc9.1/jdpLogo",
                "listed_at": "2026-10-13T06:05:23Z",
                "locations": [
                    "Melbourne VIC"
                ],
                "advertiser": {
                    "id": "61761600",
                    "name": "Amplar Health"
                },
                "work_types": [
                    "Contract/Temp"
                ],
                "company_name": "Amplar Health",
                "bullet_points": [
                    "No Rotating Roster! With Flexibility On Selecting Shift Pattern",
                    "Hourly Base Rate + 12% super + up to 75% penalty rates",
                    "Work From Home Around Australia, Providing Clinical Advice Virtually"
                ],
                "classifications": [
                    {
                        "classification": "Healthcare & Medical",
                        "subclassification": "Nursing - A&E, Critical Care & ICU"
                    }
                ],
                "work_arrangements": [
                    "Remote"
                ]
            },
            {
                "id": "95010181",
                "url": "https://www.seek.com.au/job/95010181",
                "title": "Registered Nurse",
                "salary": "$80,524 - $109,175 per annum pro rata + 12% super",
                "teaser": "Discover Flinders Island, Tasmania. Stunning landscapes, a welcoming community and a rewarding nursing opportunity.",
                "logo_url": "https://bx-branding-gateway.cloud.seek.com.au/8e2bf44a-3a45-4d0d-85a4-d4b43bdead5c.1/jdpLogo",
                "listed_at": "2026-10-01T23:02:20Z",
                "locations": [
                    "Melbourne VIC"
                ],
                "advertiser": {
                    "id": "15272126",
                    "name": "Department of Health"
                },
                "work_types": [
                    "Full time"
                ],
                "company_name": "Department of Health Tasmania",
                "bullet_points": [
                    "Swap traffic for beaches on Flinders Island, Tasmania.",
                    "Relocation and regional allowances available for eligible appointees.",
                    "Deliver care where you're truly needed."
                ],
                "classifications": [
                    {
                        "classification": "Healthcare & Medical",
                        "subclassification": "Nursing - General Medical & Surgical"
                    },
                    {
                        "classification": "Government & Defence",
                        "subclassification": "Government - State"
                    }
                ],
                "work_arrangements": [
                    "On-site"
                ]
            }
        ],
        "page": 1,
        "limit": 5,
        "has_more": true,
        "total_count": 1529
    },
    "meta": {
        "billable": true,
        "endpoint_family": "job_search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required query parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "limit": [
            "The limit must be 100 or fewer jobs per page."
        ]
    },
    "message": "The request validation failed"
}
502

Invalid Source Response

The upstream answered with a shape that no longer matches the documented contract. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "job_search"
    },
    "error": {
        "code": "PARSER_DRIFT",
        "message": "The SEEK API is temporarily unavailable. Please retry."
    },
    "success": false
}
503

Service Unavailable

The upstream service is temporarily unavailable. Please retry shortly.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "job_search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The SEEK API is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.