HireLayer Job Recommendations · Job Recommendation API
Job Recommendation API that finds the open jobs closest to a resume
Send a resume as a stored application_id, a text or a file. HireLayer Job Recommendations looks through the open jobs stored in your workspace and returns their job_ids and titles, closest first, each with a similarity. Send the jobs you choose to Resume Scorer for the evidence.
Schedule a demo- Endpoint
- POST /api/v4/jobs/search
- Input
- application_id, resume text or file
- Response
- job_id · title · similarity
- Billing
- 1 credit per search, +1 for a file
HireLayer Job Recommendations
POST /api/v4/jobs/search
Capabilities
What the Job Recommendation API returns
Problems it solves
Candidates browse every job
A candidate who uploads a CV still scrolls through listings that have nothing to do with their profile.
Titles do not tell the fit
Matching on job titles alone misses the jobs that need the same experience under another name.
A rejected candidate is a lost one
A candidate not kept for one job could fit another open role, but nobody checks the other openings.
01
The resume as the query
Send a stored application_id, a resume text or a resume file: a new resume is parsed and stored on the way.
02
Open jobs, closest first
Up to 100 job_ids with their titles, ranked by similarity to the resume, 10 by default.
03
Only jobs that still hire
Jobs marked closed are left out, so a recommendation is always an open job.
04
Already scored, flagged
already_scored tells which jobs this resume is scored, or being scored, for; scoring it again costs nothing, unless a score is stale or its verdict was reset.
05
One catalog per client company
Recommendations come from the jobs of one HireLayer-Workspace, so each customer’s jobs stay apart.
06
Then the evidence
Send the resume and a chosen job to Resume Scorer for a score, a verdict and the evidence for each criterion.
Under the hood
Recommend first, then score
| Property | Job Recommendations | Resume Scorer |
|---|---|---|
| Question answered | Which open jobs are closest to this resume? | How well does the resume meet this job? |
| Looks at | Every open job of the workspace | The job you send |
| Per job | job_id · title · similarity | score · verdict · criteria |
| Explanation | None | A quote and a sentence per criterion |
| Credits | 1 per search, +1 for a file | 1 per resume evaluated |
Request and response
Recommend jobs for one resume
Values below come from the API reference example. Field names and shapes match the live contract.
curl -X POST https://hirelayer.co/api/v4/jobs/search \
-H "X-API-Key: $HIRELAYER_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "application_id": "file_2c982f413a5e9e79563f8a1fcb5c7caa", "limit": 10 }'{
"application_id": "file_2c982f413a5e9e79563f8a1fcb5c7caa",
"results": [
{
"rank": 1,
"job_id": "job_30cfa454c97663f3e1801e5a61b87d74",
"title": "Ingénieur IA / Développeur backend Node.js (H/F)",
"similarity": 0.78,
"already_scored": true
},
{
"rank": 2,
"job_id": "senior-ds-nlp",
"title": "Senior Data Scientist – NLP (m/f)",
"similarity": 0.74,
"already_scored": false
}
],
"credits_used": 1
}- results[].job_id · title
- The open jobs of the workspace, closest to the resume first.
- results[].similarity
- Closeness to the resume, from 0 to 1, to compare within one search only. It is not a score.
- results[].already_scored
- true when this resume is already scored, or being scored, for the job: scoring it again costs 0, unless its score is stale or its verdict was reset.
- credits_used
- 1 per search, +1 when the resume is sent as a file.
Use cases
Where teams recommend jobs
HireLayer Job Recommendations is used by recruiting software and recruiting services. Each use case links to the full workflow.
- 01
Jobs for you on a job board
After a candidate uploads a CV, show the open jobs closest to it and let them apply in one click.
Job Recommendations for Job boards & career sites - 02
Redeploy candidates across openings
When a candidate is not kept for one job, list the other open jobs closest to their resume for the recruiter.
Job Recommendations for ATS platforms - 03
Place a candidate faster
Compare each new candidate with the agency’s open job orders, then score the best ones before the first call.
Job Recommendations for Staffing & temp agencies
Integration
Integrate job recommendations in your product
Call the API from your backend and keep the key server-side. Your product keeps its records, interface and review process.
STEP 01
Store your open jobs
Send each job to HireLayer Job Criteria Extractor when it is published, and mark it closed when it is filled.
STEP 02
Search with the resume
Send the candidate’s application_id, or the file they just uploaded.
STEP 03
Score the jobs you show
Send the resume with each chosen job_id to HireLayer Resume Scorer, one call per job, for the score and the evidence.
Technical specifications
- Authentication
- X-API-Key header
- Content-Type
- application/json, or multipart/form-data with a file
- Resume
- application_id, resume.text or a file
- limit
- 1 to 100, 10 by default
- Jobs searched
- The open jobs of the HireLayer-Workspace sent
- Output
- rank · job_id · title · similarity · already_scored
- Billing
- 1 credit per search, +1 for a resume file
No backend to write? Use Job Recommendations from Make, Power Automate, Google Sheets, ChatGPT, Claude or your ATS.
Where Job Recommendations fits in the HireLayer pipeline
Each product works on its own. Chain them when a workflow needs CV data, job criteria, a search and a decision aid together.
- CV filePDF, DOCX, image…Resume ParserResume Parsing API→ application_id · resumeJob RecommendationsJob Recommendation APIresume → closest open jobsResume ScorerCandidate & Job Matching APIjob + resumes → score · verdict
- Job descriptionText or fileJob Criteria ExtractorJob Parsing API→ job_id · criteria[]Talent Pool SearchTalent Pool Search APIjob → closest stored resumesResume ScorerCandidate & Job Matching API+ precise_ranking → ranking_reason
- Free-text skillsFrom CVs, jobs or usersSkills NormalizerSkills Matching API→ taxonomy skill ids
Store skill ids on profiles and jobs for search and facets.
Resume Parser and Job Criteria Extractor store what they read. The searches find the closest resumes or jobs; Resume Scorer explains the fit. One API key and one credit balance cover every call.
Questions
Job Recommendation API questions
Answers based on the current API contract.
What does the Job Recommendation API return?
The open jobs of your workspace, closest to the resume first: each with its job_id, its title, a rank, a similarity from 0 to 1 and already_scored. There is no explanation. Score the jobs you choose with Resume Scorer to get a verdict and evidence for each criterion.
Which jobs can be recommended?
The open jobs stored in the workspace named by the HireLayer-Workspace header: every job sent to Job Criteria Extractor or Resume Scorer. A job marked closed is left out.
Can I send a resume file?
Yes. Send it as multipart form data in file: it is parsed and stored as Resume Parser would store it, for 1 more credit. A resume already stored only needs its application_id.
Is similarity a matching score?
No. similarity says how close a job is to the resume compared with the other results of the same search. It does not check criteria and cannot be compared from one search to another. The score that says how well the resume meets a job comes from Resume Scorer.
How do I explain a recommendation to the candidate?
Score the resume against the recommended job with Resume Scorer: its summary and the explanation of each criterion say why the job fits, in the job’s language.
How is Job Recommendations billed?
1 credit per search, plus 1 when the resume comes as a file. Scoring the jobs you pick is billed by Resume Scorer: 1 credit per resume evaluated, 0 for a pair already scored.
HireLayer Job Recommendations
Make your first call to HireLayer Job Recommendations today.
Create an account to get an API key. Credits are shared across all six HireLayer products.
Works well with
Related HireLayer products
- HireLayer Resume ScorerCandidate & Job Matching APIScore resumes against a job, criterion by criterion.
- HireLayer Talent Pool SearchTalent Pool Search APIFind the stored resumes closest to a job.
- HireLayer Job Criteria ExtractorJob Parsing APITurn job descriptions into typed, weighted criteria.