Skip to content

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.

Schedule a demo
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
HireLayer Job Criteria Extractor, POST /api/v4/jobs/extract-criteria. Requirements of a job description become criteria with ids, a requirement level of required, preferred or bonus and weights from 1 to 3; perks are left out. Values come from the documented API example.

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

FieldTypeMeaning
criterion_idstringcrit_1, crit_2… in order. Never reused.
labelstringShort name of the requirement, in the job’s language.
typeenumskill · experience · education · language · certification · location · soft_skill · other
requirementenumrequired · preferred · bonus
weightinteger 0–33 essential, 2 important, 1 nice to have, 0 off.
thresholdstring | nullThe minimum the ad sets, such as “3 ans minimum” or “B2”.
sourceenumextracted, 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.

RequestPOST /api/v4/jobs/extract-criteria
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…"
  }'
Pythonrequests
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"])
Response201 Created · application/json
{
  "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.

  1. 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
  2. 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
  3. 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.

  1. 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.

  2. STEP 02

    Let a recruiter review

    Display the criteria, let the team adjust weights or requirements, and save the changes on the stored job.

  3. 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.

  1. CV filePDF, DOCX, image…
    Resume ParserResume Parsing API→ application_id · resume
    Job RecommendationsJob Recommendation APIresume → closest open jobs
    Resume ScorerCandidate & Job Matching APIjob + resumes → score · verdict
  2. Job descriptionText or file
    Job Criteria ExtractorJob Parsing API→ job_id · criteria[]
    Talent Pool SearchTalent Pool Search APIjob → closest stored resumes
    Resume ScorerCandidate & Job Matching API+ precise_ranking → ranking_reason
  3. Free-text skillsFrom CVs, jobs or users
    Skills 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?

For screening, HireLayer Job Criteria Extractor: it turns a job description into typed, weighted hiring criteria, each marked required, preferred or bonus, which HireLayer Resume Scorer checks against every resume. Field parsers such as Textkernel or RChilli return the fields of the posting instead, which suits job boards and search. Job Criteria Extractor is free, and the free plan includes 50 credits a month for the other products.

How is Job Criteria Extractor different from a job description parser?

A classic job description parser returns the posting as fields: title, location, salary, skills. Job Criteria Extractor keeps only the requirements a CV can confirm or contradict, and says how much each one matters, so the output is ready for candidate matching rather than for republishing the ad.

What does the Job Parsing API return?

A criteria array with the requirements the ad states, usually 4 to 10 and at most 15; a short ad gives fewer, never invented ones, and a long one has its close requirements grouped, the 15 that weigh most kept. Each criterion has a criterion_id, a label, a type, a requirement (required, preferred or bonus), a weight from 1 to 3 and a threshold when the ad sets a minimum. It focuses on requirements a CV can evidence; it does not return salary, benefits or other job-ad metadata.

Can criteria be edited before scoring?

Yes. Change the weight or the requirement of a stored criterion, add or delete criteria, or send your own criteria with the job to Resume Scorer. A weight of 0 turns a criterion off without deleting it.

Which language are the criteria written in?

In the job’s language: English, French, German, Spanish or Portuguese, detected from the description, and English for a description in any other language. Send language set to en, fr, de, es or pt to choose it.

Does the Job Parsing API score candidates?

No. It only structures the job. Use HireLayer Resume Scorer to score one or many resumes against its criteria, with precise ranking to compare the best ones side by side.

Is job description parsing billed?

No. Extracting criteria uses no credit, and sending the same text again returns the stored job and its criteria without a new extraction.

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.