BrowsableIndeed APIs
Indeed job search
Search Indeed for job postings matching a query (and optional location), returning normalized listings with title, company, location, salary, snippet, posted-date, and the canonical Indeed job URL.
POST
/v1/indeed/searchSend Authorization: Bearer YOUR_API_KEY. Get an API key →
Parameters
Send these fields in a flat JSON body. Add _run to choose execution options.
querystringRequiredJob search query — title, skill, or keywords (e.g. 'software engineer', 'nurse'). Minimum length: 1. Maximum length: 200.
locationstringOptionalLocation filter — city, state, postcode, or 'Remote'. Leave empty to search everywhere on the chosen domain. Minimum length: 1. Maximum length: 2000.
domainstringOptionalIndeed regional domain (default www.indeed.com). Examples: 'uk.indeed.com', 'ca.indeed.com', 'de.indeed.com'. Pattern: ^[a-z0-9.-]+\.indeed\.com$.
pagesintegerOptionalHow many result pages to fetch (each ~15 jobs). Defaults to 1. Default: 1. Minimum: 1. Maximum: 20.
Response
Every response describes a run. Read result once run_status is succeeded.
run_id- The run to track. Keep it when contacting support.
run_status- Queued, running, waiting for sign-in, succeeded, or failed. Check this even after an HTTP 200.
status_url- Poll this URL while the run is pending. Keep the same run instead of starting another request.
result- The endpoint’s returned data. The example is illustrative; actual fields may be empty or unavailable.
error- On failure, inspect its code, message, retryable and action fields.
View the complete output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"results",
"count"
],
"properties": {
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"jobKey",
"title",
"company",
"companyRating",
"companyReviewCount",
"location",
"city",
"region",
"postalCode",
"remote",
"salary",
"salaryMin",
"salaryMax",
"salaryType",
"jobTypes",
"snippet",
"postedRelative",
"postedAt",
"link",
"sponsored",
"urgentlyHiring",
"indeedApplyable",
"thirdPartyApplyUrl"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"jobKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"remote": {
"type": "boolean"
},
"salary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"snippet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"jobTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"salaryMax": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"salaryMin": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"sponsored": {
"type": "boolean"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"salaryType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"companyRating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"postedRelative": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"urgentlyHiring": {
"type": "boolean"
},
"indeedApplyable": {
"type": "boolean"
},
"companyReviewCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"thirdPartyApplyUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}View a polled run response
{
"run_id": "00000000-0000-4000-8000-000000000001",
"task_key": "indeed-search",
"task_name": "Indeed job search",
"run_status": "succeeded",
"status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
"result": {
"count": 1,
"results": [
{
"city": "London",
"link": "https://example.com/item-1",
"title": "Stylish Shoreditch Loft with Balcony",
"jobKey": "sample",
"region": "London",
"remote": true,
"salary": "180",
"company": "sample",
"snippet": "sample",
"jobTypes": [
"sample"
],
"location": "London",
"postedAt": "sample",
"salaryMax": 180,
"salaryMin": 180,
"sponsored": true,
"postalCode": "sample",
"salaryType": "180",
"companyRating": 4.91,
"postedRelative": "sample",
"urgentlyHiring": true,
"indeedApplyable": true,
"companyReviewCount": 1,
"thirdPartyApplyUrl": "https://example.com/item-1"
}
]
},
"error": null
}Errors & retries
400Fix the fields listed inerrorsbefore retrying.428Connect the requested website account using the returned sign-in link.429Wait for the duration inRetry-After.5xxRetry transient failures with backoff. Keep the request ID.
A failed run has its own error inside the response. Retry it only when error.retryable is true.
More examples
Async request with polling
RUN=$(curl -s -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/indeed/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"London"}')
RUN_ID=$(echo "$RUN" | jq -er '.run_id // empty') || { echo "$RUN" >&2; exit 1; }
POLL_DELAY=3
while true; do
RESULT=$(curl -s -H "Authorization: Bearer YOUR_API_KEY" "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/runs/$RUN_ID")
STATUS=$(echo "$RESULT" | jq -r '.run_status')
if [[ "$STATUS" =~ ^(succeeded|failed|errored|cancelled|canceled|expired)$ ]]; then
echo "$RESULT"
break
fi
sleep "$(awk "BEGIN { print $POLL_DELAY * (0.9 + ($RANDOM % 21) / 100) }")"
POLL_DELAY=$((POLL_DELAY < 30 ? POLL_DELAY * 2 : 30))
[ "$POLL_DELAY" -gt 30 ] && POLL_DELAY=30
doneWait-for-results request
curl -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/indeed/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"London","_run":{"async":false}}'Canonical & compatibility routes
You can also send the same JSON body to /v1/tasks/indeed-search/runs.