Recommend live job openings to candidates on a talent marketplace
Show each candidate on a talent marketplace or career platform the live openings that match their title and location, with context on the hiring company, and link through to the original posting.
- Free API key
- No credit card
- Run your sample
Uses POST /job_search/, POST /organization_search/ · Job postings API reference
What it costs: Charged per request: credit pricing.
- Job postings API
- Company enrichment
- API
- Embedded in a platform
- HR tech
How the data flows
POST /job_search/ - matching job postings
- true
- posting url
- samplelabs.example
- date featured
- 2026-10-01
- name
- Jane Example
- title
- Senior Software Engineer
- mobile
- +1 (415) 555-0142
Steps
- Search active postings with
POST /job_search/(title, locations,is_remote,is_active) - Drop postings older than the digest window using
date_featured - Add company context (industry, employees range, location) with
POST /organization_search/(organization_ids) - Rank the matches for the candidate and link each one to the posting url
import json, os, requests BASE = "https://api-v2.forager.ai/api/{account_id}/datastorage" HEADERS = {"X-API-KEY": os.environ["FORAGER_KEY"]} body = json.load(open("request.json")) # request fields: see the API reference # 1. Search active postings with POST /job_search/ (title, locations, # is_remote, is_active) r1 = requests.post(f"{BASE}/job_search/", headers=HEADERS, json=body) # 2. Drop postings older than the digest window using date_featured # 3. Add company context (industry, employees range, location) with POST # /organization_search/ (organization_ids) r2 = requests.post(f"{BASE}/organization_search/", headers=HEADERS, json=body) # 4. Rank the matches for the candidate and link each one to the posting url
# 1. POST /job_search/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/job_search/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json # 2. POST /organization_search/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json
Run it yourself: Job postings API reference
- Free API key
- No credit card
- Run your sample
Inputs and outputs
| Inputs | Outputs |
|---|---|
| candidate target title | matching job postings |
| candidate location or remote preference | posting url |
date_featured | |
company industry and size |
Questions about this recipe
Which API can a career platform use to recommend live job openings?
This recipe uses Forager Job postings API and Company enrichment. Job postings API: Search live and historical job postings by company, title and location to spot hiring signals. Show each candidate on a talent marketplace or career platform the live openings that match their title and location, with context on the hiring company, and link through to the original posting.
What does it cost to recommend live job openings to candidates on a talent marketplace?
Job postings API: 2 credits per request, charged whether or not data comes back. Company enrichment: 1 credit per request, charged whether or not data comes back. Growth's 8,250 monthly credits cover 8,250 company lookups, or a mix. Self-serve plans are Starter, Growth, Pro and Scale. See plans and prices
What do I need to run this recipe, and what comes back?
You send candidate location or remote preference and candidate target title. You get back company industry and size, date_featured, matching job postings and posting URL, as JSON. You also need a Forager API key, which comes with a free account.
How do I show candidates matching job postings with company details?
Search active postings with POST /job_search/ (title, locations, is_remote, is_active). Drop postings older than the digest window using date_featured.
Is there a free way to try Forager on this workflow?
Yes. Create a free account at app.forager.ai: it comes with $5 in free credits and an API key, and there is no credit card to sign up. Run it on records you already know, or book a demo and send us a list: we run it and show you what we find.
When should I run this workflow?
When a candidate completes a profile, updates their target role, or opens their weekly job digest. Candidates see current, relevant openings with company context, so the marketplace has a reason to bring them back each week.
Which Forager products does this recipe use?
Job postings API and company enrichment. Job postings API: search live and historical job postings by company, title and location to spot hiring signals. Company enrichment: firmographics for a company from its domain or name: industry, headcount, locations, growth and open roles.
How do I know the data is right?
The test that counts is your own: send a list of profiles you care about. We run it and show you what we find, number by number, so you can measure hit rate and connect rate yourself.
Which tools can run this workflow?
Native in Clay, partner-built in Deepline and Cargo and called through the API from your own code, Make and n8n. Or call the endpoints in the steps above from your own code with one API key.
How many steps is this workflow?
4 steps: search active postings with POST /job_search/ (title, locations, is_remote, is_active), drop postings older than the digest window using date_featured, add company context (industry, employees range, location) with POST /organization_search/ (organization_ids) and rank the matches for the candidate and link each one to the posting url.
Is there a contract or minimum commitment?
No contract to start: a free account comes with $5 in credits. To keep using Forager, choose a monthly or yearly plan. Monthly plans cancel anytime and unused credits roll over; yearly plans grant all credits upfront and cost 10% less. Larger volumes are agreed with our team.
Can we show Forager data inside our product?
Yes, under platform terms. Self-serve plans cover internal use by your own team. Showing Forager data to your users, or passing records on, is licensed separately: talk to sales about volume and which fields your users need to see.
Written answers are not available right now. The matching pages above still help, or book a demo and ask the team.
- $5 free credits
- No credit card
- Run your sample
More recipes for talent marketplaces
-
Help job seekers reach the hiring manager behind a job posting
-
Prospect plant and warehouse managers for an on-demand staffing marketplace
-
Check a freelancer's claimed work history at sign-up
-
Offer mobile and email enrichment as native actions in a GTM workflow builder
-
Convert personal-email sign-ups into work identities
-
Score accounts on hiring momentum from job postings