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
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
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
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
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
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.