API / Parse · Stage 1
Parse
Turn a document into clean markdown and instant contact fields. The fast, interactive stage — ideal for form autofill.
POST/v1/parse
Request
Send multipart/form-data. Provide the CV as either a file
or a URL — nothing is stored either way.
| Field | Type | Notes | |
|---|---|---|---|
file | file | one of | PDF, Word (docx/doc), RTF, ODT, image (png/jpg/webp), text or LaTeX. Max 20 MB, 10 pages. |
source_url | string | one of | A short-lived download URL. The service fetches it into memory and stores nothing. |
full | query | optional | ?full=true also runs Stage 2 inline and includes candidate_data (~50 s). |
Response 200
A stable envelope. candidate_data is null
unless you passed ?full=true.
{
"markdown": "# Jane Doe\n...",
"chunks": [ ... ],
"splits": [ ... ],
"metadata": { "filename": "resume.pdf", "page_count": 2, "duration_ms": 4820 },
"instant_fields": {
"emails": ["[email protected]"], "phones": ["+90..."],
"linkedin": "https://www.linkedin.com/in/...", "github": null
},
"candidate_data": null
}
Field shapes are documented in Response schema.
Timing
About 5 seconds for a 1–2 page CV. The first request after a period of inactivity adds a one-time warm-up; see Errors & limits.
Example
# upload a file curl -X POST "https://prs.recruspace.com/v1/parse" \ -H "X-API-Key: $KEY" -F "[email protected]" # or fetch from a URL — nothing stored server-side curl -X POST "https://prs.recruspace.com/v1/parse" \ -H "X-API-Key: $KEY" -F "source_url=$URL"