Skip to main content
POST
This endpoint is AI-powered and rate limited to 5 requests/minute. It uses a large language model to intelligently extract structured job requirements from free-text job descriptions.
What it extracts:
  • Experience & seniority level
  • Work type & employment type
  • Location
  • Must-have and good-to-have skills

Authorizations

string | header
required
API key of the form <token>, passed as the x-tidyhire-api-key header.

Body

string
required
Free-text job description to parse.Example: "We are looking for a Senior Software Engineer..."

Response

Job requirements parsed successfully
boolean
Indicates if the request was successful. Example: true
string
Status details. Example: "Job requirements parsed successfully"
object

Common Errors

Reason: The text is not a recognisable job description — the request succeeded but the AI could not parse it.