Jobs V2 API: Search jobs

Returns job postings matching required keyword, which may name a role, a role and a place, or a company. Filter with posted_within, remote_only, employment_type, requirement and radius_km; walk results one page at a time with page.

4 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

keyword*string

What to search for. Free text — a role, a role plus a place, or a company name.

Length1 <= length

country?string

Two-letter ISO country code to search within.

Length2 <= length <= 2

Default"us"

language?string

Language code for the returned listings.

Length2 <= length <= 5

page?integer

Result page to return, 1-50.

Range1 <= value <= 50

Default1

posted_within?string

Only return listings first posted within this window.

Default"any"

Value in

"any"
"today"
"3_days"
"week"
"month"

remote_only?|

Restrict results to work-from-home listings.

Defaultfalse

employment_type?string

Restrict results to one kind of engagement.

Value in

"full_time"
"part_time"
"contract"
"internship"

requirement?string

Restrict results by what the posting asks of a candidate.

Value in

"no_experience"
"under_3_years"
"over_3_years"
"no_degree_required"

radius_km?integer

Search radius in kilometres around the place named in keyword.

Range1 <= value <= 500

exclude_boards?string

Comma-separated job boards to drop from the results, by publisher name.

curl -X GET "https://example.com/v2/jobs/search?keyword=python+developer+in+new+york" \  -H "x-api-key: YOUR_API_KEY"

{  "data": [    {      "id": "string",      "short_id": "string",      "title": "string",      "description": "string",      "employment_type": "string",      "employment_types": [        "string"      ],      "is_remote": true,      "company": {        "name": "string",        "logo": "string",        "website": "string",        "reviews": [          {            "board": "string",            "score": 0,            "max_score": 0,            "review_count": 0,            "url": "string"          }        ]      },      "location": {        "text": "string",        "city": "string",        "state": "string",        "country": "string",        "latitude": 0,        "longitude": 0      },      "salary": {        "text": "string",        "min": 0,        "max": 0,        "period": "string"      },      "posted": {        "text": "string",        "at": "string",        "timestamp": 0      },      "apply": {        "url": "string",        "is_direct": true,        "options": [          {            "board": "string",            "url": "string",            "is_direct": true          }        ]      },      "source_board": "string",      "benefits": [        "string"      ],      "highlights": {        "property1": [          "string"        ],        "property2": [          "string"        ]      },      "insights": {        "work_arrangement": "string",        "seniority": "string",        "experience_years_required": 0,        "education": {          "level": "string",          "field": "string"        },        "visa_sponsorship": true,        "relocation_required": true,        "relocation_assistance": true,        "contract_duration": "string",        "start_date": "string",        "technologies": {          "required": [            "string"          ],          "preferred": [            "string"          ]        },        "methodologies": [          "string"        ],        "soft_skills": [          "string"        ],        "extended_benefits": [          "string"        ],        "industry": "string",        "job_function": "string",        "is_management": true,        "involves_ai_ml": true      }    }  ]}