Skip to content
HireLayer logoHireLayer

Recruiting API platform

Resume parsing and candidate matching APIs

Turn CVs and job descriptions into structured JSON, then match and rank candidates. One API key, one credit balance.

Try the demoGet started free

Demo without an account

A resume with photo, profile, skills, experience and education, sent through the parser engine and returned as JSON: candidate photo, candidate information, soft and hard skills, work experiences and education.

Products

Five APIs, from raw documents to ranked candidates

Three APIs structure your inputs. Two compare candidates with a job.

All products
  1. CV filePDF, DOCX, image…
    CV ExtractResume Parsing API→ info_resume.text · skills[]
    MatchCandidate & Job Matching APIjob_text + candidate_text + matching_criteria
  2. Job descriptionPlain job_text
    Job ExtractJob Parsing API→ matching_criteria[]
    RankCandidate Ranking APIjob_text + up to 10 candidate_text
  3. Free-text skillsFrom CVs, jobs or users
    SkillsSkills Matching API→ taxonomy skill ids

    Store skill ids on profiles and jobs for search and facets.

Match takes criteria from Job Extract and CV text from Extract. Rank only needs the job text and each candidate’s CV text. One API key and one credit balance cover every call.

Capabilities

What each API returns

Inputs and responses taken from the API reference, for all 5 APIs.

HireLayer CV Extract

POST/api/v3/parser

Test it on your own CV

Send a CV file and get candidate details, experience, education, languages and typed skills back as normalized JSON.

Candidate photo, cropped from the CV

An image URL, or null when the CV has no photo. With do_not_store_data, the link expires after 10 minutes.

A CV page with the candidate photo in its header. HireLayer CV Extract detects the photo, crops it and returns it as a separate image URL in info_resume.face_url, with an expiry time in face_url_expires_at.

Free wording, normalized values

Fixed vocabularies you can filter and report on.

  • In the CV: “Developer since 2019”

    Returned as info_candidate.experience_level

    "5 to 10 years"

  • In the CV: “English, fluent (C1)”

    Returned as languages[].level

    "Full Professional Proficiency (C1)"

  • In the CV: “Freelance mission, 6 months”

    Returned as work_experiences[].contract_type

    "Freelance"

  • In the CV: “Available from September”

    Returned as info_candidate.availability_date

    "2026-09-01"

HireLayer Job Extract

POST/api/v1/jobs/extract-criteria

Send a job description and get back the requirements a CV can prove, each with a weight, a mandatory flag and a rationale.

About Job Extract
A job ad sentence becomes three criteria with weights 3, 2 and 1; the first two are mandatory.

HireLayer Match

POST/api/v1/matching/job-candidate

Evaluate one candidate against a job. Each criterion gets a status and an explanation, then a transparent weighted score.

About Match
One candidate scored 0.87 against three criteria: React ideal, English potential, Paris ideal.

HireLayer Skills

POST/api/v1/skills/resolve

Send one skill or a whole CV skills section and get back every taxonomy skill it names, with a stable id, a type, families and domains.

About Skills
The text “React, Node, Cobol, gestion de projet”, resolved in English, returns four taxonomy skills in text order: React, Node.js, COBOL and Project management, each with its id.

HireLayer Rank

POST/api/v1/matching/job-candidates/rank

Send one job and up to 10 candidates. Every candidate comes back once, ranked, scored from 0 to 1 and explained.

About Rank
Three candidates ranked for one job: candidate_1 with 0.92, candidate_2 with 0.78, candidate_3 with 0.61.

Use cases

For recruiting software and recruiting firms

5 workflows for software platforms, 3 for recruiting firms.

All solutions

Build parsing and matching into the product you sell.

Speed up intake and shortlists for client roles.

Integration

Parse your first CV with one HTTPS request

  1. 01Create an account and generate an API key.
  2. 02Send the file from your backend with the key in X-API-Key.
  3. 03Store the JSON from the response in your own schema.
View API docsGet your API key
RequestPOST /api/v3/parser
curl -X POST https://hirelayer.co/api/v3/parser \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/resume.pdf" \
  -F "application_id=app_123"
API requests processed
2M+
In production since
2024
Parse success rate
~99.7%

Pricing

One credit per successful call, on every API

All plans include access to all APIs, all supported formats and API key management. Errors use no credit.

  • Free

    Try the full recruiting API platform.

    €0/ month

    50 credits / month

    No card required

    Get started

  • Starter

    For teams getting started with recruiting workflows.

    €24/ month

    500 credits / month

    €48 per 1,000 credits

    Choose plan
  • Lowest cost per credit

    Scale

    For teams processing candidates and jobs at scale.

    €89/ month

    2,000 credits / month

    €44.50 per 1,000 credits

    Choose plan

  • Enterprise

    For organizations with custom volume and integrations.

    Custom

    Custom monthly volume and integrations

    Dedicated support

    Contact sales

One-time credit packs

Credits that do not reset each month.

FAQ

Frequently asked questions

Where are resumes processed and stored?

Resumes are parsed in Paris, France, where uploaded files and extracted photos are also stored. AI processing stays in the EU through our in-house AI pipeline. If parsed data must not be retained, set do_not_store_data to true on the request: the file is not stored and the photo link expires after 10 minutes.

What are the file size limits?

The encoded request must stay under 6 MiB. Documents above 100,000 extracted characters return HTTP 422 with the code DOCUMENT_TOO_LARGE.

How long is the candidate photo URL valid?

With do_not_store_data set to true, face_url is temporary: it expires 10 minutes after parsing, at the time given in face_url_expires_at, so download and store the image if you need to keep it. Otherwise the photo is stored and face_url does not expire.

Can I receive parsing results by webhook?

Yes. Pass a webhook_url with the request: the V3 endpoint still returns the JSON synchronously and also sends it to your callback, with a 2-second timeout per attempt and up to 3 attempts.

In which language are criteria and explanations written?

In the current version, Job Extract criteria, Match explanations and Rank rationales are generated in French, whatever the language of the input. Match and Rank scores are numbers from 0 to 1.

Does a mandatory criterion exclude a candidate?

No. is_mandatory is informational and does not change the status or the 0 to 1 score returned by Match. Your application decides how to treat it.

Start with 50 free credits a month.

Valid on all five APIs. No card required.

Get started freeView API docs