POST /v1/web/index/jobs/searchfinds open jobs by the words in the job title, across every company.POST /v1/web/index/jobs/changesreports what changed in specific companies’ hiring since a date: what is open now, what opened, what closed, by department, seniority and location.
When to use it
- You want everyone hiring for a role, like “data engineer” in Berlin, without visiting each company’s careers page.
- You track a list of companies and want to know who is growing a team, who froze hiring, and which senior roles just filled.
- You feed an agent or a lead list that needs fresh, dated hiring facts rather than a one-off page read.
Search open jobs
Words that must appear in the job title, like
data engineer. Each word matches whole words, so engineer also finds engineers and engineering but not reengineer.Only jobs posted in the last N days, from 1 to 365. Jobs without a posted date count from when we first saw them.
Include each job’s description text when we hold it. Descriptions are filled in over time, so some jobs come back without one.
board names the hiring platform the employer posts the job on, firstSeenAt is when we first saw it open, and pay is set only when the employer publishes it.
What changed in a company’s hiring
Company websites, like
acme.com, up to 25 per call. A website or a full URL both work.seniority is read from the job title, and opened and closed list up to 200 jobs each, newest first; truncated is true when a company had more.
How fresh it is
Each company is re-read every two to seven days, more often when it has more open jobs. A job counts as closed once a full read of its board no longer lists it, andclosedAt is the time of that read, so a change shows up within that company’s refresh interval. lastReadAt says when we last read the company.
Billing
A search that returns 15 jobs costs 2 credits. A search that finds nothing is free.
Related
Search
Search the web for pages rather than jobs.
Credits
How every call is priced.
Brand
Enrich the companies you find with their name, logo and description.
API Reference
Every field of both endpoints.