Jobs & Hiring

How do you get Indeed job listings via API?

To get Indeed job listings via API, call ReefAPI's jobs/search action with a query, location and country; it returns live job records with titles, companies, URLs and metadata.

Indeed engineLive JSON4 steps1,000 free credits

Get a free key Open in playground

This guide demonstrates the real Indeed API engine with a captured response from Jun 23, 2026. The example is only published because the engine passed the SEO snapshot gate.

Use case

Labor-market analytics, job boards, hiring intelligence and lead discovery.

Indeed docs Jobs & Hiring hub Open in playground

Step by step

Call the live endpoint

1
Set role, location and country
Pick a query like python developer, a city or remote location, and the country code your workflow covers.
2
Call indeed/v1/jobs/search
POST the request through ReefAPI and read data.jobs.
3
Store normalized job fields
Persist job key, title, company, location, URL, source query and capture time.
4
Dedupe and refresh
Use job ids or URLs to avoid duplicate jobs and schedule refreshes for changing markets.

Code

Copy the request

These snippets use the captured request params for indeed/v1/jobs/search.

curl -X POST https://api.reefapi.com/indeed/v1/jobs/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"python developer","location":"New York","country":"US","max_results":60}'

import requests

r = requests.post(
    "https://api.reefapi.com/indeed/v1/jobs/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "python developer",
  "location": "New York",
  "country": "US",
  "max_results": 60
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/indeed/v1/jobs/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "python developer",
  "location": "New York",
  "country": "US",
  "max_results": 60
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.indeed.jobs/search with {"query":"python developer","location":"New York","country":"US","max_results":60}.

Real response

Captured output from ReefAPI

Captured on Jun 23, 2026 UTC. The response below is the committed snapshot, including the API envelope and metadata.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/indeed/v1/jobs/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "python developer",
    "location": "New York",
    "country": "US",
    "max_results": 60
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "indeed",
    "endpoint": "jobs/search",
    "mode": "live",
    "latency_ms": 1098.9,
    "record_count": 60,
    "bytes": 0,
    "cache_hit": false,
    "attempts": 1
  },
  "data": {
    "jobs": [
      {
        "jobkey": "5c70b[redacted-phone]e0",
        "indeed_url": "https://www.indeed.com/viewjob?jk=5c70b[redacted-phone]e0",
        "search_query": "python developer",
        "search_country": "US",
        "title": "Senior Software Engineer",
        "normalized_title": null,
        "company": "Solar Landscape",
        "company_rating": null,
        "company_review_count": null,
        "company_logo_url": "https://d2q79iu7y748jz.cloudfront.net/s/_squarelogo/256x256/934068aea028344be3af[redacted-phone]d75",
        "company_url": "https://www.indeed.com/cmp/Solar-Landscape",
        "company_industry": null,
        "company_employees": "201 to 500",
        "company_revenue": null,
        "company_description": "Solar Landscape is the nation’s leading commercial rooftop solar developer, partnering with top real estate owners to turn rooftops into reliable, revenue-generating clean energy assets nationwide.",
        "company_website": "http://www.solarlandscape.com",
        "formatted_location": "New York, NY",
        "city": "New York",
        "state": "NY",
        "postal_code": null,
        "country": "US",
        "remote": true,
        "location": null,
        "salary_text": null,
        "salary_min": 160000,
        "salary_max": 180001,
        "salary_period": "YEARLY",
        "salary_currency": "USD",
        "salary_source": "EMPLOYER",
        "salary_yearly_min": 160000,
        "salary_yearly_max": 180001,
        "salary_usd_yearly_normalized": null,
        "salary_range": null,
        "posted_relative": null,
        "posted_iso": "[redacted-phone]",
        "posted_epoch_ms": 1782190800000,
        "valid_through": null,
        "sponsored": false,
        "urgently_hiring": false,
        "new_job": false,
        "expired": false,
        "indeed_apply": false,
        "apply_url": "https://jobs.lever.co/solarlandscape/09ae0270-2c56-4d1b-a044-cdb1f32639c9?lever-source=Indeed",
        "external_apply_url": "https://jobs.lever.co/solarlandscape/09ae0270-2c56-4d1b-a044-cdb1f32639c9?lever-source=Indeed",
        "snippet_html": null,
        "snippet_text": null,
        "description_html": "<div><div><b>About Us</b></div><div>\n</div><div>\nSolar Landscape is the leading commercial rooftop solar developer in the U.S. Only 4% of commercial rooftops host solar today &mdash; we&rsquo;re changing that, fast. Commercial rooftop solar is the fastest, smartest way to build new clean power &mdash; delivering megawatts of generation in months, not years, and powering America&rsquo;s energy and future right where it&rsquo;s needed most. By turning rooftops into local power plants, we&rsquo;re reshaping how &mdash; and how fast &mdash; energy gets built in the U.S.</div><div></div><div><br>\nR",
        "description_text": "About Us Solar Landscape is the leading commercial rooftop solar developer in the U.S. Only 4% of commercial rooftops host solar today — we’re changing that, fast. Commercial rooftop solar is the fastest, smartest way to build new clean power — delivering megawatts of generation in months, not years, and powering America’s energy and future right where it’s needed most. By turning rooftops into local power plants, we’re reshaping how — and how fast — energy gets built in the U.S. Recognized as the #1 Distributed Generation Developer by New Project Media, the #1 National Commercial Rooftop Sola",
        "indeed_skills": [
          "Jira",
          "Performance tuning",
          "AI use case identification"
        ],
        "benefits": [
          "Paid parental leave",
          "Disability insurance",
          "Health insurance"
        ],
        "employment_types": [
          "Full-time"
        ],
        "job_level": "Senior level",
        "work_schedule": null,
        "onet_skills": null,
        "ai_summary": null
      },
      {
        "jobkey": "31c5a3b04ce9cc65",
        "indeed_url": "https://www.indeed.com/viewjob?jk=31c5a3b04ce9cc65",
        "search_query": "python developer",
        "search_country": "US",
        "title": "Business & Web Applications Developer",
        "normalized_title": null,
        "company": "Nazareth University",
        "company_rating": null,
        "company_review_count": null,
        "company_logo_url": null,
        "company_url": "https://www.indeed.com/cmp/Nazareth-University",
        "company_industry": null,
        "company_employees": null,
        "company_revenue": null,
        "company_description": "",
        "company_website": "https://www.naz.edu",
        "formatted_location": "Rochester, NY 14618",
        "city": "Rochester",
        "state": "NY",
        "postal_code": "14618",
        "country": "US",
        "remote": false,
        "location": null,
        "salary_text": null,
        "salary_min": 71500,
        "salary_max": 81500,
        "salary_period": "YEARLY",
        "salary_currency": "USD",
        "salary_source": "EMPLOYER",
        "salary_yearly_min": 71500,
        "salary_yearly_max": 81500,
        "salary_usd_yearly_normalized": null,
        "salary_range": null,
        "posted_relative": null,
        "posted_iso": "[redacted-phone]",
        "posted_epoch_ms": 1782104400000,
        "valid_through": null,
        "sponsored": false,
        "urgently_hiring": false,
        "new_job": false,
        "expired": false,
        "indeed_apply": false,
        "apply_url": "https://jobs.naz.edu/postings/4449",
        "external_apply_url": "https://jobs.naz.edu/postings/4449",
        "snippet_html": null,
        "snippet_text": null,
        "description_html": "<div><div><div>Position Information\n</div><p></p><div><div><div><div><b>Position Title</b></div> <div>Business &amp; Web Applications Developer</div>\n</div><br>\n<div><div><b>Position Type</b></div> <div>Staff</div>\n</div><br>\n<div><div><b>Requisition Number</b></div> <div>ST186</div>\n</div><br>\n<div><div><b>Department</b></div> <div>Information Tech Services</div>\n</div><br>\n<div><div><b>Title of Supervisor</b></div> <div>Director Enterprise Applications &amp; Data</div>\n</div><br>\n<div><div><b>Full-time/ Part-time</b></div> <div>Full-time</div>\n</div><br>\n<div><div><b>Work Hours per Week</b><",
        "description_text": "Position Information Position Title Business & Web Applications Developer Position Type Staff Requisition Number ST186 Department Information Tech Services Title of Supervisor Director Enterprise Applications & Data Full-time/ Part-time Full-time Work Hours per Week 35 Weeks Per Year 52 Months Per Year: 12 Work Days Monday - Friday Work Hours 8:30 am - 4:30 pm End Date (required for Temporary, Per Diem, Independent Contractor/Agency): Salary Range $71,500 to $81,500 Hours and Months 35 hours per week 12 months per year Exemption Status Exempt Staff Job Description Job Description Summary Repor",
        "indeed_skills": [
          "AI models",
          "AI chatbots",
          "SFTP"
        ],
        "benefits": [
          "Disability friendly"
        ],
        "employment_types": [
          "Full-time"
        ],
        "job_level": "Senior level",
        "work_schedule": "Monday - Friday",
        "onet_skills": null,
        "ai_summary": null
      },
      {
        "jobkey": "4b7f90dc6bb39138",
        "indeed_url": "https://www.indeed.com/viewjob?jk=4b7f90dc6bb39138",
        "search_query": "python developer",
        "search_country": "US",
        "title": "Senior SAP Engineer",
        "normalized_title": null,
        "company": "",
        "company_rating": null,
        "company_review_count": null,
        "company_logo_url": null,
        "company_url": null,
        "company_industry": null,
        "company_employees": null,
        "company_revenue": null,
        "company_description": null,
        "company_website": null,
        "formatted_location": "New York, NY",
        "city": "New York",
        "state": "NY",
        "postal_code": null,
        "country": "US",
        "remote": true,
        "location": null,
        "salary_text": null,
        "salary_min": 100000,
        "salary_max": 225000,
        "salary_period": "YEARLY",
        "salary_currency": "USD",
        "salary_source": "EMPLOYER",
        "salary_yearly_min": 100000,
        "salary_yearly_max": 225000,
        "salary_usd_yearly_normalized": null,
        "salary_range": null,
        "posted_relative": null,
        "posted_iso": "[redacted-phone]",
        "posted_epoch_ms": 1782190800000,
        "valid_through": null,
        "sponsored": false,
        "urgently_hiring": false,
        "new_job": false,
        "expired": false,
        "indeed_apply": false,
        "apply_url": "https://jobs.ashbyhq.com/novaintelligence/cef5ff6e-fc29-40c6-8794-5db3461d2eb6?utm_source=aKDLwYGXXG",
        "external_apply_url": "https://jobs.ashbyhq.com/novaintelligence/cef5ff6e-fc29-40c6-8794-5db3461d2eb6?utm_source=aKDLwYGXXG",
        "snippet_html": null,
        "snippet_text": null,
        "description_html": "<div><p>Nova Intelligence is building the most powerful AI platform for SAP teams. SAP is the heart of the enterprise: almost every critical business process at the world's largest companies &mdash; finance, supply chain, manufacturing, sales &mdash; runs on SAP. Our customers use Nova to 3x the productivity of their SAP teams: modernizing legacy code, redesigning business processes, resolving production issues, and more.</p><p>\nNova Intelligence was founded by AI researchers, repeat entrepreneurs, and the co-inventor of SAP HANA, and has raised $40M from SAP.io, Accel, Conviction, and Chemist",
        "description_text": "Nova Intelligence is building the most powerful AI platform for SAP teams. SAP is the heart of the enterprise: almost every critical business process at the world's largest companies — finance, supply chain, manufacturing, sales — runs on SAP. Our customers use Nova to 3x the productivity of their SAP teams: modernizing legacy code, redesigning business processes, resolving production issues, and more. Nova Intelligence was founded by AI researchers, repeat entrepreneurs, and the co-inventor of SAP HANA, and has raised $40M from SAP.io, Accel, Conviction, and Chemistry. Check out the Launch Vi",
        "indeed_skills": [
          "Software issue identification",
          "Regression testing implementation",
          "Systems integration"
        ],
        "benefits": [
          "Health insurance",
          "Dental insurance",
          "Vision insurance"
        ],
        "employment_types": [
          "Full-time"
        ],
        "job_level": "Senior level",
        "work_schedule": null,
        "onet_skills": null,
        "ai_summary": null
      }
    ]
  }
}

Manual way

Why this is hard manually

Job search pages are difficult because query aliases, sponsored jobs, company pages, location normalization and pagination change often. Manual scraping also risks collecting fields your product should not store.

A clean hiring pipeline needs role, company, location, URL, source and capture time in a predictable shape, plus a clear way to avoid charging or processing failed fetches.

ReefAPI way

Why ReefAPI solves it

This guide uses an Indeed snapshot for python developer roles in New York, returning 60 live job records with titles, companies, Indeed URLs and related fields. ReefAPI's envelope makes it clear when the response is healthy.

Use it for market maps, alerting, job-board enrichment or recruiter tools that need public job data without building a search scraper.

FAQ

Questions developers ask

Does the sample include recruiter contact data?

No. The guide demonstrates public job listing fields, not recruiter PII.

Can I search other countries?

Yes. Pass a supported country parameter according to the current Indeed docs.

How many jobs are in the snapshot?

The current captured response reports 60 records in meta.record_count.

Can I combine this with company research?

Yes. Pair job listings with company profile or hiring-signal APIs when building labor-market intelligence.