Endpoint Reference

Create Job

Save a job description to your workspace and receive a unique job_id. This endpoint accepts a flexible JSON object containing your job data and does not enforce a strict required format.

Optimized for reuse in other endpoints.

Tired of re-sending the same job description text? Save it once, get a job_id, and use it across our platform.

Cost Effective

Saves processing time and API costs by avoiding re-parsing.

Seamless Integration

Use the returned job_id directly with /v1/score-match and /v1/questions endpoints.

POST/v1/create-job

Request Parameters

Name	Type	Description
titleRequired	string	Title of the job.
descriptionRequired	string	The full text or summary of the job description.
languageRequired	string	Language of the job (e.g., 'en', 'fr').
location	string	Job location (optional).
salary_range	object	Salary range for the position (optional).

Pro Tip

This job_id can be used directly with other endpoints like /v1/score-match and /v1/questions to save processing time and API costs by avoiding re-parsing the job every time!

curl -X POST https://api.evalcv.com/v1/create-job \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Senior Python Engineer", "description": "We are looking for...", "language": "en"}'