Skip to main content
Five endpoints, one key. Jobs reads one Indeed results page (US indeed.com) and Job reads one posting. Companies finds a company, Company reads its profile, and Reviews pages through its reviews. This does not submit applications. See the Indeed API: overview, pricing, and free tier.

Jobs

GET /v1/indeed/jobs · 1 request
Response time: 3–7 s typical, 60 s limit. Page fetch. How to read this. Search is one page, so there is no page or cursor, and next_cursor is always null: the one page holds every card Indeed serves for the search. To reach more jobs, narrow the search with location, job_type, remote, or posted. total_results is how many postings Indeed matched for the search across the site, not just the cards returned, and unique_results is the same after Indeed merges duplicate postings. Both are null when Indeed does not report them. Use unique_results to compare demand across roles, regions, and days. Each hit includes position, job_id, title, company, location, workplace_type, remote, salary_text, salary, job_type, posted_age, posted_at, snippet, benefits, company_rating, company_reviews_count, company_url, easy_apply, urgently_hiring, sponsored, and url. A page holds every card Indeed served, usually about 45. sponsored: true marks a listing the employer paid to promote; it is still a real opening. salary is { min, max, median, currency, period, source } or null. period is year, month, week, day, or hour. source is employer when the posting states the pay, estimated when it is the board’s estimate, or null when the board does not say. salary_text stays as the board prints it.

Job

GET /v1/indeed/job · 1 request
Response time: 2–6 s typical, 50 s limit. Page fetch. How to read this. The body is job: title, company, location, workplace_type, remote, salary_text, salary, job_type, posted_at, valid_through, company_logo, company_url, benefits, direct_apply, url, highlights, and paragraphs. highlights groups the description’s bullet points into qualifications, responsibilities, and benefits by the heading above them. Bullets without a recognised heading are left out, so a posting with no headed lists returns empty arrays. paragraphs still has the full text.

Companies

GET /v1/indeed/companies · 1 request
Response time: 2–6 s typical, 50 s limit. Page fetch. How to read this. Returns the companies Indeed lists for the name, best match first, in one page: there is no page or cursor, next_cursor is always null, and total_results is always null. A name Indeed does not know returns an empty results. Each hit includes position, company, name, rating, reviews_count, description, logo, and url. company is the company’s id: pass it to Company and Reviews. rating is null for a company nobody has reviewed.

Company

GET /v1/indeed/company · 1 request
Response time: 2–16 s typical, 50 s limit. Page fetch. How to read this. company takes an id from Companies or an indeed.com/cmp/ link, so a job result’s company_url works as it is. Indeed gives some companies an id with a suffix, such as Blue-Bottle-Coffee-db772533; the response’s company.company is always the full id. The body is company: company, name, url, logo, rating, reviews_count, ratings, rating_history, wellbeing_score, wellbeing, description, industry, headquarters, founded, employees, revenue, website, ceo, jobs_count, salaries, locations, faqs, and similar_companies. ratings is the company’s average, out of 5, for work_life_balance, compensation_benefits, job_security_advancement, management, and culture. rating_history is the overall rating by year. wellbeing_score is Indeed’s Work Wellbeing Score, 0 to 100, and wellbeing lists the survey answers behind it by category. salaries holds the average pay Indeed shows for the company’s most common roles: category, title, salary_text, salary, period (year, month, week, day, or hour), and reports, the number of salaries behind the average. employees and revenue are ranges, such as 10,000+ or $25M to $100M. A field Indeed leaves off the page is null, or an empty list. A company Indeed does not have returns 404 not_found.

Reviews

GET /v1/indeed/reviews · 1 request
Response time: 3–8 s typical, 50 s limit. Page fetch. How to read this. A page holds 20 reviews, from every country, newest first. sort_by orders them by rating instead. Send next_cursor back as cursor for the next page, or open a page directly with page. next_cursor is null on the last page, and a page past the last returns an empty results. Pages go up to 500, the first 10,000 reviews in the chosen order. total_results is the company’s review count. company in the body is the company reviewed: company, name, rating, reviews_count, and url. Each review includes position, review_id, title, text, pros, cons, rating, ratings, job_title, location, country, current_employee, date, helpful_count, unhelpful_count, and url. ratings has the same five categories as the company’s; a category the reviewer skipped is null. date is the day the review was posted, YYYY-MM-DD. pros and cons are null when the reviewer left them out, which most do. A company Indeed does not have returns 404 not_found. Auth, plans, rate limits, and error codes: Authentication.