Skip to content
Scrappa Get API key
Indeed Jobs API 1 credit/request

Indeed Job Details API Documentation

GET https://scrappa.co/api/indeed/jobs/details

Indeed Job Details API returns full job postings by job key. Send one key or up to 10 keys separated by commas. Jobs come back in the order of the request. Keys that were not found are listed in missing_keys.

Each job has description_html, description_text, salary (null when none is shown), job_types, benefits, apply_url, the location and the company with employer_key and slug. benefits are derived from the job attributes and the description text.

If none of the keys exists, the answer is 404 and is not billed.

Costs 1 credit per successful request. Failed and empty requests are free. Scrappa is not affiliated with or endorsed by Indeed.

Indeed Job Details API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/indeed/jobs/details
Auth header
x-api-key
Cost
1 credit/request
job_key = example
Response preview
200 OK
{
    "data": {
        "jobs": [
            {
                "id": "90875fd636922145",
                "title": "Warehouse Associate",
                "salary": {
                    "max": 22,
                    "min": 19.5,
                    "unit": "hour",
                    "currency": "USD",
                    "is_estimated": false
                },
                "company": {
...

Parameters

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

Runnable path

1 required parameter needed before sending a request.

1 optional filter available.

job_key string Required

One job key or up to 10 keys separated by commas. A key has 16 lowercase hexadecimal characters (0-9, a-f), for example 90875fd636922145.

Example value example
country string Optional

US (default), GB (UK works as an alias) or DE. Any other value returns 422.

Example value US

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": "90875fd636922145",
                "title": "Warehouse Associate",
                "salary": {
                    "max": 22,
                    "min": 19.5,
                    "unit": "hour",
                    "currency": "USD",
                    "is_estimated": false
                },
                "company": {
                    "logo": "https://d2q79iu7y748jz.cloudfront.net/s/_squarelogo/256x256/c1b9b1f9a1cbd5e3c5e4a1a0b7a2f3f4",
                    "name": "Amazon.com",
                    "slug": "Amazon.com",
                    "profile_url": "/cmp/Amazon.com",
                    "employer_key": "caff23281376b83d"
                },
                "benefits": [
                    "health insurance",
                    "401(k)",
                    "paid time off"
                ],
                "location": {
                    "city": "Austin",
                    "state": "TX",
                    "country": "US",
                    "latitude": 30.19,
                    "formatted": "Austin, TX 78744",
                    "is_remote": false,
                    "longitude": -97.74,
                    "postal_code": "78744",
                    "country_name": "United States"
                },
                "apply_url": "https://www.indeed.com/viewjob?jk=90875fd636922145",
                "job_types": [
                    "Full-time"
                ],
                "attributes": [
                    "Full-time",
                    "Health insurance",
                    "401(k)"
                ],
                "date_on_indeed": "2026-10-28T09:10:00Z",
                "date_published": "2026-10-28T09:00:00Z",
                "description_html": "<p>Pick, pack and ship customer orders.</p>",
                "description_text": "Pick, pack and ship customer orders."
            }
        ],
        "count": 1,
        "country": "US",
        "missing_keys": [
            "0000000000000000"
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "job_details"
    },
    "success": true
}

Errors

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

422

Validation Error

A required parameter or a value is invalid. This response is not billable.

{
    "errors": {
        "job_key": [
            "A job key is 16 lowercase hexadecimal characters (0-9, a-f), for example 90875fd636922145."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

Nothing was found for these parameters. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "job_details"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "Nothing was found for these parameters."
    },
    "success": false
}
503

Upstream Unavailable

Indeed could not be reached after several tries, or its answer could not be read (code PARSER_DRIFT). This response is not billable. Retry shortly.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "job_details"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Indeed 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.