Search jobs

Authorization

bearerAuth

AuthorizationBearer <token>

Your JobsPipe API key (starts with jp_live_).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Job search filters. All fields optional; combine with AND.

limit?integer

Max results to return. Capped by your plan's page size.

offset?integer

Results to skip (offset pagination).

page?integer

Page index (alternative to offset).

include_total_results?boolean

Populate metadata.total_results (otherwise null).

job_title_or?array<string>

Match jobs whose title contains any of these.

job_title_not?array<string>

Exclude jobs whose title contains any of these.

job_country_code_or?array<string>

Match any of these ISO country codes, e.g. ["US","GB"].

job_country_code_not?array<string>

Exclude these ISO country codes.

posted_at_max_age_days?integer

Only postings newer than this many days.

posted_at_gte?string

Only postings on or after this date (YYYY-MM-DD).

posted_at_lte?string

Only postings on or before this date (YYYY-MM-DD).

company_name_or?array<string>

Match any of these company names (exact).

company_name_partial_match_or?array<string>

Match any of these company names (partial).

job_seniority_or?array<string>

Match any of these seniority levels.

remote?boolean

true for remote-only, false to exclude remote.

job_id_or?array<string>

Return jobs matching any of these IDs.

job_ids?array<string>

Look up a specific set of job IDs.

Response Body

`application/json`

curl -X POST "https://example.com/v1/jobs/search" \  -H "Content-Type: application/json" \  -d '{}'

{  "metadata": {    "total_results": 0,    "truncated_results": 0,    "total_companies": 0,    "truncated_companies": 0,    "next_cursor": "string"  },  "data": [    {      "id": "string",      "job_title": "string",      "normalized_title": "string",      "url": "string",      "final_url": "string",      "source_url": "string",      "company": "string",      "company_domain": "string",      "company_object": {        "property1": null,        "property2": null      },      "date_posted": "string",      "discovered_at": "string",      "closed_at": "string",      "reposted": true,      "date_reposted": "string",      "has_blurred_data": true,      "location": "string",      "short_location": "string",      "long_location": "string",      "country": "string",      "country_code": "string",      "countries": [        "string"      ],      "country_codes": [        "string"      ],      "cities": [        "string"      ],      "continents": [        "string"      ],      "state_code": "string",      "postal_code": "string",      "latitude": 0,      "longitude": 0,      "remote": true,      "hybrid": true,      "salary_string": "string",      "salary_currency": "string",      "min_annual_salary": 0,      "max_annual_salary": 0,      "min_annual_salary_usd": 0,      "max_annual_salary_usd": 0,      "avg_annual_salary_usd": 0,      "seniority": "string",      "employment_statuses": [        "string"      ],      "easy_apply": true,      "technology_slugs": [        "string"      ],      "keyword_slugs": [        "string"      ],      "hiring_team": [        null      ],      "description": "string",      "matching_phrases": [        "string"      ],      "matching_words": [        "string"      ]    }  ]}

{  "error": "string"}

{  "error": "string"}

{  "error": "string"}

{  "error": "string"}

Authorization

Request Body

Response Body

200application/json

401application/json

402application/json

429application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`