Endpoint Reference

Scrape & Parse Job Description

Parse a raw job description (text or URL) into structured, cached data. Returns a job_id for reuse with /score-match-parsed.

Structured job intelligence, instantly.

Stop re-processing the same job description. Parse once, match many candidates using the returned job_id. Supports both raw text and URL input.

Structured Output

Extracts skills, experience, salary, job level, and more into clean JSON.

URL Scraping

Pass a job posting URL and we'll fetch and parse it automatically.

Smart Caching

Identical job descriptions are deduplicated — same text returns the same cached result.

Normalized Skills

Skills are deduplicated and normalized (e.g., 'JS' → 'JavaScript').

POST/v1/parse-job

Request Parameters

Name	Type	Description
job_text	string	The full text of the job description. Provide either job_text or job_url.
job_url	string	URL of the job posting to scrape and parse. Provide either job_text or job_url.

Pro Tip

Use /parse-job once per job description, then call /score-match-parsed for each candidate. This is significantly faster than sending the full JD every time.

curl -X POST https://api.evalcv.com/v1/parse-job \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_text": "We are looking for a Senior Python..."}'