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

Monster Job Search API Documentation

GET https://scrappa.co/api/monster/search

Monster Job Search API Search US jobs on Monster or CareerBuilder by keyword, place, radius, date posted, job type and remote. Each job has its id, title, links, dates, company (name, id, logo, slug), location with coordinates, salary range, job types, career level, education, skills, SOC code, the employer apply link and the description as text. A page has up to 18 jobs and the source stops after page 30. Paid jobs repeat across pages, so deep paging adds few new jobs; repeats inside a page are removed. The total is an estimate. The date filter of the source is loose, so every job is checked on its posting date and jobs outside the period are removed (filtered_out counts them). A search with no match answers 200 with an empty list. Cost: 1 credit per successful search.

Monster Job Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/monster/search
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "jobs": [
            {
                "url": "https://www.monster.com/job-openings/registered-nurse-boston-ma--5aa4f010-1124-4aba-aec8-73123886710e",
                "site": "monster",
                "apply": {
                    "url": "https://careers.example.com/job/12345",
                    "type": "OFFSITE"
                },
                "title": "Registered Nurse - Medical Surgical",
                "job_id": "5aa4f010-1124-4aba-aec8-73123886710e",
                "remote": false,
                "salary": {
...

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.

8 optional filters available.

q string Optional

Job title or keyword, up to 200 characters. Example: nurse. Send q, location or remote=true.

Example value coffee shops
location string Optional

City, state or ZIP, up to 200 characters. Example: Boston, MA. Use the location autocomplete for exact names. Do not combine it with remote.

Example value Austin, Texas
radius integer Optional

Search radius around the location in miles. Default 30.

Example value 10
date_posted string Optional

Only jobs posted in this period. The result is checked on the posting date of every job.

Example value 2026-06-15
job_type string Optional

Only jobs of this type.

Example value example
remote boolean Optional

Set true to get remote jobs only. Remote jobs have no location, so do not send location with it.

Example value true
site string Optional

Which job site to search. The jobs are the same dataset; the links and ranking differ. Default monster.

Example value example
page integer Optional

Page number, 1 to 30. A page has up to 18 jobs. The source returns nothing beyond page 30.

Example value 1

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": [
            {
                "url": "https://www.monster.com/job-openings/registered-nurse-boston-ma--5aa4f010-1124-4aba-aec8-73123886710e",
                "site": "monster",
                "apply": {
                    "url": "https://careers.example.com/job/12345",
                    "type": "OFFSITE"
                },
                "title": "Registered Nurse - Medical Surgical",
                "job_id": "5aa4f010-1124-4aba-aec8-73123886710e",
                "remote": false,
                "salary": {
                    "max": 96000,
                    "min": 78000,
                    "unit": "YEAR",
                    "period": "Annually",
                    "currency": "USD"
                },
                "skills": [
                    "Nursing",
                    "Patient Care",
                    "Registered Nurse (RN)"
                ],
                "company": {
                    "guid": "r4xsdtochnhljenumzslum5s5f",
                    "logo": "https://media.newjobs.com/example/logo.png",
                    "name": "Example Health",
                    "slug": "example-health",
                    "normalized_name": "Example Health"
                },
                "location": {
                    "city": "Boston",
                    "text": "Boston, MA",
                    "region": "MA",
                    "country": "US",
                    "latitude": 42.3601,
                    "longitude": -71.0589,
                    "postal_code": "02115"
                },
                "soc_code": "29-1141.00",
                "education": [
                    "Bachelor's Degree",
                    "Nursing (RN, LPN)"
                ],
                "job_types": [
                    "Employee"
                ],
                "locations": [
                    {
                        "city": "Boston",
                        "text": "Boston, MA",
                        "region": "MA",
                        "country": "US",
                        "latitude": 42.3601,
                        "longitude": -71.0589,
                        "postal_code": "02115"
                    }
                ],
                "schedules": [
                    "Day Shift"
                ],
                "soc_title": "Registered Nurses",
                "clean_title": "Registered Nurse",
                "date_posted": "2026-10-28T11:49:53.894Z",
                "career_level": "Experienced",
                "canonical_url": "https://www.monster.com/job-openings/registered-nurse-boston-ma--5aa4f010-1124-4aba-aec8-73123886710e",
                "date_modified": "2026-10-30T03:07:13.055Z",
                "valid_through": "2027-10-28T11:49:53.894Z",
                "description_text": "Provide direct patient care on a medical surgical unit...",
                "employment_types": [
                    "FULL_TIME"
                ],
                "remote_work_level": "No Remote Work",
                "short_description": "Provide direct patient care on a medical surgical unit."
            }
        ],
        "pagination": {
            "page": 1,
            "has_more": true,
            "returned": 1,
            "page_size": 18,
            "total_estimate": 11100
        },
        "filtered_out": 0
    },
    "meta": {
        "credits": 14,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

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

422

Validation Error

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

{
    "errors": {
        "q": [
            "Send q, location or remote=true."
        ]
    },
    "message": "The request validation failed"
}
503

Service Unavailable

Monster could not be reached or refused the request. This response is not billable. Retry shortly.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Monster could not be reached. Please retry shortly. You are not charged."
    },
    "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.