Indeed search API

Search Indeed jobs

curl --request POST \
  --url https://api.stophy.dev/v1/indeed/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "data analyst",
  "location": "Chicago, IL",
  "datePosted": "last7Days"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'data analyst', location: 'Chicago, IL', datePosted: 'last7Days'})
};

fetch('https://api.stophy.dev/v1/indeed/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/indeed/search"

payload = {
    "query": "data analyst",
    "location": "Chicago, IL",
    "datePosted": "last7Days"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "jobUrl": "<string>",
        "salaryIsEstimate": true,
        "isRemote": true,
        "isHybrid": true,
        "isEasyApply": true,
        "isUrgent": true,
        "jobId": "<string>",
        "title": "<string>",
        "companyName": "<string>",
        "companyUrl": "<string>",
        "companyAvatarUrl": "<string>",
        "companyWebsite": "<string>",
        "companyIndustry": "<string>",
        "companyEmployeesText": "<string>",
        "companyRevenueText": "<string>",
        "companyDescription": "<string>",
        "addressFull": "<string>",
        "addressCity": "<string>",
        "addressRegion": "<string>",
        "addressPostalCode": "<string>",
        "addressCountry": "<string>",
        "latitude": 0,
        "longitude": 0,
        "salaryMin": 123,
        "salaryMax": 123,
        "salaryPeriod": "hour",
        "salaryCurrency": "<string>",
        "jobTypes": [
          "fullTime"
        ],
        "experienceLevels": [
          "noExperience"
        ],
        "educationLevels": [
          "highSchool"
        ],
        "attributes": [
          "<string>"
        ],
        "publishedAt": "2023-11-07T05:31:56Z",
        "indexedAt": "2023-11-07T05:31:56Z",
        "applyUrl": "<string>",
        "source": "<string>",
        "description": "<string>"
      }
    ],
    "cursor": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

POST

indeed

Search Indeed jobs

curl --request POST \
  --url https://api.stophy.dev/v1/indeed/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "data analyst",
  "location": "Chicago, IL",
  "datePosted": "last7Days"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'data analyst', location: 'Chicago, IL', datePosted: 'last7Days'})
};

fetch('https://api.stophy.dev/v1/indeed/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/indeed/search"

payload = {
    "query": "data analyst",
    "location": "Chicago, IL",
    "datePosted": "last7Days"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "jobUrl": "<string>",
        "salaryIsEstimate": true,
        "isRemote": true,
        "isHybrid": true,
        "isEasyApply": true,
        "isUrgent": true,
        "jobId": "<string>",
        "title": "<string>",
        "companyName": "<string>",
        "companyUrl": "<string>",
        "companyAvatarUrl": "<string>",
        "companyWebsite": "<string>",
        "companyIndustry": "<string>",
        "companyEmployeesText": "<string>",
        "companyRevenueText": "<string>",
        "companyDescription": "<string>",
        "addressFull": "<string>",
        "addressCity": "<string>",
        "addressRegion": "<string>",
        "addressPostalCode": "<string>",
        "addressCountry": "<string>",
        "latitude": 0,
        "longitude": 0,
        "salaryMin": 123,
        "salaryMax": 123,
        "salaryPeriod": "hour",
        "salaryCurrency": "<string>",
        "jobTypes": [
          "fullTime"
        ],
        "experienceLevels": [
          "noExperience"
        ],
        "educationLevels": [
          "highSchool"
        ],
        "attributes": [
          "<string>"
        ],
        "publishedAt": "2023-11-07T05:31:56Z",
        "indexedAt": "2023-11-07T05:31:56Z",
        "applyUrl": "<string>",
        "source": "<string>",
        "description": "<string>"
      }
    ],
    "cursor": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

Searches Indeed jobs.

Request

This method has no required parameters.

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.indeed.search({ query: "data analyst", location: "Chicago, IL", datePosted: "last7Days" });
console.log(result.data.results);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.indeed.search(query="data analyst", location="Chicago, IL", date_posted="last7Days")
print(result["data"]["results"])

curl -X POST https://api.stophy.dev/v1/indeed/search \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"data analyst","location":"Chicago, IL","datePosted":"last7Days"}'

stophy indeed search "data analyst" --location "Chicago, IL" --datePosted last7Days

Response

If successful, the response body contains the standard envelope. data.results[] contains the jobs, each with its company, pay, location and posting date. The following example is a real response, truncated: each list shows one item and long strings are cut.

{
  "success": true,
  "data": {
    "results": [
      {
        "jobId": "57f5b67299fda823",
        "jobUrl": "https://www.indeed.com/viewjob?jk=57f5b67299fda823",
        "title": "Sr. Data Analyst, Customer Analytics (Insurance)",
        "companyName": "CCC Intelligent Solutions",
        "companyUrl": "https://www.indeed.com/cmp/Ccc-Intelligent-Solutions-1",
        "companyAvatarUrl": "https://d2q79iu7y748jz.cloudfront.net/s/_squarelogo/256x256/9b657fd43e3a37b384dcc01be5a555d7",
        "companyWebsite": "http://www.cccis.com",
        "companyEmployeesText": "1,001 to 5,000",
        "companyRevenueText": "Decline to state",
        "companyDescription": "At CCC, we’re all about connectedness - from our people to our products. Our team is truly reshaping the auto and…",
        "addressFull": "Chicago, IL 60607",
        "addressCity": "Chicago",
        "addressRegion": "IL",
        "addressPostalCode": "60607",
        "addressCountry": "US",
        "latitude": 41.885124,
        "longitude": -87.64813,
        "salaryMin": 84724,
        "salaryMax": 120000,
        "salaryPeriod": "year",
        "salaryCurrency": "USD",
        "salaryIsEstimate": false,
        "jobTypes": ["fullTime"],
        "isRemote": false,
        "isHybrid": false,
        "experienceLevels": ["senior"],
        "educationLevels": ["bachelor"],
        "attributes": ["AI models", "Optimizing workflow processes"],
        "publishedAt": "2026-10-05T05:00:00.000Z",
        "indexedAt": "2026-10-05T16:08:42.293Z",
        "applyUrl": "https://cccis.wd1.myworkdayjobs.com/broadbean_external/job/Chicago-Green-St-IL/Sr-Data-Analyst--Customer-Analytics--Ins…",
        "isEasyApply": true,
        "isUrgent": false,
        "source": "CCC Information Services Inc.",
        "description": "CCC Intelligent Solutions Inc. (CCC) is a leading cloud platform for the multi-trillion-dollar insurance economy,…"
      }
    ],
    "cursor": "ABkAAQAZAAAAAAAAAAAAAAACZRQ9vgEBAQh6SP1ejTvdtRgDInsCYE/ygA=="
  },
  "creditsUsed": 1,
  "requestId": "2fe9dbad-fc48-4890-9751-0b24b596035b"
}

Field	Type	Description
`cursor`	string	The pagination token. Pass it as `cursor` to retrieve the next page. Omitted on the last page.
`publishedAt`	string (ISO 8601)	The publication time, in UTC.

For every field, see the response schema on this page.

Optional parameters

Parameter	Type	Description
`query`	string	Words to search for.
`location`	string	City, region or postal code, such as Kansas City, MO.
`country`	string	The country to query, as a two-letter ISO 3166-1 code such as `us`. Accepts one of 62 values, such as `us`, `gb` and `ca`. If unset, defaults to `us`.
`distanceMiles`	integer	The search radius around `location`, in miles. `0` is the exact location only. Acceptable values are `0`, `5`, `10`, `15`, `25`, `35`, `50` and `100`. If unset, defaults to `25`.
`datePosted`	string	Restricts results to jobs posted in this period. A relisted job keeps its first `publishedAt` and shows the new date in `indexedAt`. Acceptable values are `last24Hours`, `last3Days`, `last7Days` and `last14Days`.
`remote`	string	Restricts results to remote or hybrid jobs. Acceptable values are `remote` and `hybrid`.
`jobType`	string	Restricts results to this type of job. Acceptable values are `fullTime`, `partTime`, `contract`, `temporary` and `internship`.
`experienceLevel`	string	Restricts results to jobs for this level. Acceptable values are `noExperience`, `entry`, `mid` and `senior`.
`education`	string	Restricts results to jobs that ask for this education. Acceptable values are `highSchool`, `associate`, `bachelor` and `master`.
`sort`	string	Specifies the order of the jobs. Acceptable values are `relevance` and `newest`. If unset, defaults to `relevance`.
`cursor`	string	The pagination token from the previous response.

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

Results are paginated. To retrieve the next page, pass the value of data.cursor as cursor in a subsequent request. A response that omits cursor is the last page.

Indeed job: Accepts jobUrl. Returns an Indeed job’s details.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query

string

Maximum string length: 200

location

string

City, region or postal code, e.g. Kansas City, MO.

Required string length: 2 - 200

country

enum<string>

default:us

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Available options:

us,

gb,

ca,

au,

nz,

ie,

in,

sg,

my,

ph,

za,

ng,

ae,

sa,

qa,

kw,

bh,

om,

pk,

hk,

jp,

kr,

tw,

cn,

id,

th,

vn,

de,

at,

ch,

fr,

be,

nl,

lu,

es,

pt,

it,

gr,

pl,

cz,

hu,

ro,

fi,

se,

no,

dk,

ua,

tr,

il,

eg,

ma,

mx,

br,

ar,

cl,

co,

pe,

ec,

uy,

ve,

cr,

pa

distanceMiles

default:25

Indeed's own Distance from the location. 0 is the exact location only.

datePosted

enum<string>

Indeed's own Date posted. A relisted job keeps its first publishedAt and shows the new date in indexedAt.

Available options:

last24Hours,

last3Days,

last7Days,

last14Days

remote

enum<string>

Indeed's own Remote filter: Remote, or Hybrid work.

Available options:

remote,

hybrid

jobType

enum<string>

Indeed's own Job type.

Available options:

fullTime,

partTime,

contract,

temporary,

internship

experienceLevel

enum<string>

Indeed's own Experience level.

Available options:

noExperience,

entry,

mid,

senior

education

enum<string>

Indeed's own Education.

Available options:

highSchool,

associate,

bachelor,

master

sort

enum<string>

default:relevance

Indeed's own Sort by.

Available options:

relevance,

newest

cursor

string

The cursor from the previous response. Send it as is.

Minimum string length: 1

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Search and AI answers

Video

Social

Places and travel

Jobs

Shopping

Apps

Real estate

Ads

Indeed search API

Request

Response

Optional parameters

Billing

Authorizations

Body

Response

​Request

​Response

​Optional parameters

​Billing

​Pagination

​Related methods

Authorizations

Body

Response

Request

Response

Optional parameters

Billing

Pagination

Related methods