API / Extract

Extract

Turn parsed markdown into a 24-field structured candidate object. Run it when a candidate submits — it reuses Stage 1's markdown, so the CV is never reprocessed.

POST/v1/extract

Request

Send application/json.

Field	Type		Notes
`markdown`	string	required	The `markdown` from a prior /v1/parse response.
`text_layer`	string	optional	The document's embedded text, if you have it — improves email/phone/date fidelity.

Response 200

JSON200 OK

{
  "candidate_data": {
    "first_name": "Jane", "last_name": "Doe",
    "email": "jane@example.com", "phone_number": "+90...",
    "work_experience_details": [ ... ], "education_details": [ ... ]
  },
  "metadata": { "duration_ms": 8214 }
}

All 24 fields are documented in Response schema.

Timing

Typically 5–10 seconds for a full CV, scaling with how much content is extracted (a sparse CV is faster). Values are copied character-exact from the document; dates that are not explicitly printed are returned as null.

Example

cURLbash

curl -X POST "https://prs.recruspace.com/v1/extract" \
  -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Jane Doe\n..."}'

← Previous

Parse

Parse + Extract