HireLayer Job Criteria Extractor · Job Parsing API
Job Parsing API that turns job descriptions into weighted criteria
Send the text or the file of a job ad. HireLayer Job Criteria Extractor keeps the requirements a CV can actually confirm, then returns each one typed, weighted and marked required, preferred or bonus, with the threshold the ad sets. The job is stored, ready to score resumes against.
- Endpoint
- POST /api/v4/jobs/extract-criteria
- Input
- text or file · up to 50,000 chars
- Response
- criteria[] · usually 4 to 10, at most 15
- Billing
- Free
What the Job Parsing API keeps from a job ad
Problems it solves
Job ads mix requirements with marketing
Company story, perks and process details sit next to the handful of requirements that actually matter for screening.
Priorities are implicit
“Required”, “ideally” and “a plus” are read differently by each recruiter, so screening is inconsistent across a team.
Criteria get rewritten for every tool
The same brief is reinterpreted in the ATS, in the matching step and in the client report.
01
Only CV-evaluable requirements
The service returns requirements a candidate’s CV can confirm or contradict. It does not score candidates.
02
Typed criteria
Each criterion is a skill, an experience, an education, a language, a certification, a location, a soft skill or other.
03
Required, preferred or bonus
Must-haves are separated from preferences and nice-to-haves, so your product can display and enforce them its own way.
04
A weight and a threshold
A weight from 1 to 3 says how much each criterion counts; threshold keeps the minimum the ad sets, such as “B2 minimum”.
05
A stored job, ready to score
The job is kept under a job_id, yours or derived from the text, with criteria numbered crit_1, crit_2… Send it to Resume Scorer.
06
Free, from text or a file
Extraction uses no credit. Send the text as JSON, or the job description as a PDF, DOCX, TXT or HTML file.
Anatomy of an extracted criterion
| Field | Type | Meaning |
|---|---|---|
criterion_id | string | crit_1, crit_2… in order. Never reused. |
label | string | Short name of the requirement, in the job’s language. |
type | enum | skill · experience · education · language · certification · location · soft_skill · other |
requirement | enum | required · preferred · bonus |
weight | integer 0–3 | 3 essential, 2 important, 1 nice to have, 0 off. |
threshold | string | null | The minimum the ad sets, such as “3 ans minimum” or “B2”. |
source | enum | extracted, or custom once sent or edited by you. |
Kept as criteria
Requirements a CV can confirm or contradict: skills, tools, languages, experience, qualifications, location.
Not scored
The endpoint does not evaluate candidates. Send the job_id to HireLayer Resume Scorer to check resumes against them.
Parse a job description into criteria with cURL or Python
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/extract-criteria \
-H "X-API-Key: $HIRELAYER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "AI Engineer / Backend Node.js Developer",
"text": "Lumio · Paris 9e · Permanent… At least 3 years of backend development with Node.js / TypeScript. Hands-on experience integrating LLMs in production is required. Fluent English (B2 minimum) is required. Ideally, a first experience leading developers…"
}'import os
import requests
response = requests.post(
"https://hirelayer.co/api/v4/jobs/extract-criteria",
headers={"X-API-Key": os.environ["HIRELAYER_API_KEY"]},
json={
"title": "AI Engineer / Backend Node.js Developer",
"text": "Lumio · Paris 9e · Permanent… At least 3 years of backend development with Node.js / TypeScript. Hands-on experience integrating LLMs in production is required. Fluent English (B2 minimum) is required. Ideally, a first experience leading developers…",
},
timeout=150,
)
response.raise_for_status()
data = response.json()
print(data["criteria"]){
"job_id": "job_020cb8c5f1f8eb650cec00dc3d90f8ea",
"stored": true,
"title": "AI Engineer / Backend Node.js Developer",
"location": null,
"language": "en",
"criteria": [
{
"criterion_id": "crit_2",
"label": "Backend development with Node.js / TypeScript",
"type": "skill",
"requirement": "preferred",
"weight": 3,
"threshold": "3 years minimum",
"source": "extracted"
},
{
"criterion_id": "crit_3",
"label": "Integrating LLMs in production",
"type": "skill",
"requirement": "required",
"weight": 3,
"threshold": null,
"source": "extracted"
},
{
"criterion_id": "crit_6",
"label": "English",
"type": "language",
"requirement": "required",
"weight": 2,
"threshold": "B2 minimum",
"source": "extracted"
},
{
"criterion_id": "crit_7",
"label": "Leading developers",
"type": "experience",
"requirement": "bonus",
"weight": 2,
"threshold": null,
"source": "extracted"
}
],
"credits_used": 0
}- criteria[].requirement
- required · preferred · bonus. 4 of the 9 criteria are shown here.
- criteria[].weight · threshold
- Weight from 1 to 3; threshold is the minimum the ad sets, or null.
- job_id
- The stored job, derived from the text or yours. Send it to Resume Scorer.
- language · label
- The job’s language, en, fr, de, es or pt: labels are written in it.
Where teams parse job descriptions
HireLayer Job Criteria Extractor is used by recruiting software and recruiting services. Each use case links to the full workflow.
- 01
Client brief intake
Turn a client’s role description into criteria the consultant confirms before searching the candidate pool.
Job Criteria Extractor for Recruitment agencies - 02
Job setup assistant
Show extracted criteria to the hiring manager in your HR product so they can adjust weights before publishing.
Job Criteria Extractor for HR software & SaaS - 03
Requisition kickoff
Structure each approved requisition once and reuse the same criteria for every candidate in the program.
Job Criteria Extractor for RPO providers
Integrate job parsing into job intake
Call the API from your backend and keep the key server-side. Your product keeps its records, interface and review process.
STEP 01
Extract when a job is saved
Call the endpoint when a job is created or its description changes. One call per job, not per candidate: the same text sent again returns the stored criteria.
STEP 02
Let a recruiter review
Display the criteria, let the team adjust weights or requirements, and save the changes on the stored job.
STEP 03
Reuse for every candidate
Send the job_id to HireLayer Resume Scorer with the resumes you evaluate against this job.
Technical specifications
- Authentication
- X-API-Key header
- Content-Type
- application/json, or multipart/form-data with a file
- Body
- text (required) · title · location · language · job_id · do_not_store_data
- Input
- Up to 50,000 characters, or a PDF, DOCX, TXT or HTML file
- Output
- criterion_id · label · type · requirement · weight · threshold · source
- Output language
- The job’s language (English, French, German, Spanish or Portuguese), or language
- Billing
- Free
No backend to write? Use Job Criteria Extractor from Make, Power Automate, ChatGPT, Claude, Google Sheets or your ATS.
Where Job Criteria Extractor 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.
Job Parsing API questions
Answers based on the current API contract.
What is the best job description parsing API for screening candidates?
How is Job Criteria Extractor different from a job description parser?
What does the Job Parsing API return?
Can criteria be edited before scoring?
Which language are the criteria written in?
Does the Job Parsing API score candidates?
Is job description parsing billed?
Make your first call to HireLayer Job Criteria Extractor today.
Create an account to get an API key. Credits are shared across all six HireLayer products.
Related HireLayer products
- Candidate & Job Matching APIHireLayer Resume ScorerScore resumes against a job, criterion by criterion.
- Talent Pool Search APIHireLayer Talent Pool SearchFind the stored resumes closest to a job.