Recipe prompt
What you’ll build
A daily check for hiring activity. You keep a list of target companies. Each run asks Forager for their active job posts since the last run, compares them with the posts you have already seen, and sends an alert for the new ones.Steps
1
Resolve companies to IDs
Call Organizations lookup with
q set to a company name or domain. The text field reads “name - domain”, so you can confirm the right company. Do this once per company and store the id.2
Search their active job posts
Send a Each post has
POST to Job post event search. date_featured_start takes a date such as 2026-01-01. title supports a boolean text query, so you can watch for a team, such as "data engineer" OR "analytics engineer".id, title, url, date_featured, is_remote, is_active, location and organization (with name and domain). The source field says where the post came from. To filter on it, set job_source to indeed, linkedin or angellist.3
Keep only new posts and alert
Compare each post’s
id with the ids you stored. Alert on the ones you have not seen, then save them. Set date_featured_start to the date of your last run so each run asks for less. Group alerts by organization.name so a sales rep sees “Example Corp opened 4 roles”.Handle the edge cases
- Not found. An empty
search_resultsmeans no posts for that company and filter. Treat it as no signal, not an error. If autocomplete returns nothing for a company, check the domain spelling. - 403. The key is missing or invalid. Fix the credentials; do not retry.
- 429. Autocomplete allows 10 requests per second per account, so resolve companies once and cache the IDs. Back off on any 429. See errors and rate limits.
- Paging. Use
page, and stop when you have the number intotal_search_results. - Credits. A job search costs 2 credits per request. Autocomplete is free. Job search totals cost: Not yet documented. See credit pricing.
Related
Search job posts
Every job search filter.
Find filter values
Which autocomplete feeds which filter.
Job post event search
Request and response reference.