# Resume & CV Parser

Resume parser: CVs as PDF, scan or photo into structured JSON (contact, experience, education, skills, languages) in seconds.

Send a CV as a PDF, PNG, JPEG or WebP, by link or as base64. You get the name, headline, email, phone, location, links, summary, every job with company, title, dates and description, every degree, and lists of skills and languages. Two pages are read unless you ask for one or three; each page is one unit and takes a few seconds. Made for applicant tracking and recruiting tools. A CV is personal data: it is read in memory on our own hardware in the EU, never stored, never used for training and never sent to anyone else.

- Resume parsing in a few seconds per page, from a PDF, a scan or a phone photo.
- A CV is personal data: it is read in memory on our own hardware in the EU, never stored, never used for training and never sent to anyone else.
- One JSON object with every job and every degree as its own entry, plus skills and languages as lists.

## Calls

### `POST https://readymadeapi.com/v1/resumes/parse`

Send a résumé and get the name, contact details, summary, each job and each degree, skills and languages as JSON. Each page read is one unit.

- Price: $0.016 per page, up to 3 per call
- MCP tool: `resume_parser_parse`
- Answers in the same call.

Request:

```json
{
  "file_url": "https://readymadeapi.com/samples/resume.png"
}
```

Answer:

```json
{
  "fields": {
    "name": "Ana Ionescu",
    "headline": "Senior Backend Engineer",
    "email": "ana.ionescu@example.com",
    "phone": "+40 722 111 222",
    "location": "Cluj-Napoca, Romania",
    "links": ["linkedin.com/in/anaionescu-example"],
    "summary": "Ten years building payment and logistics systems in Rust and Go.",
    "experience": [
      {
        "company": "Northwind Logistics",
        "title": "Lead Engineer",
        "start": "March 2021",
        "end": "present",
        "description": "Led the migration of the routing engine to Rust; cut delivery planning time by 40%."
      },
      {
        "company": "Fabrikam Pay",
        "title": "Backend Engineer",
        "start": "June 2016",
        "end": "February 2021",
        "description": "Built the card settlement service handling two million payments a day."
      }
    ],
    "education": [
      {
        "school": "Babes-Bolyai University",
        "degree": "MSc Computer Science",
        "start": "2014",
        "end": "2016"
      }
    ],
    "skills": ["Rust", "Go", "PostgreSQL", "Kafka", "Kubernetes"],
    "languages": []
  },
  "as_printed": {},
  "pages_read": 1,
  "pages": 1
}
```

## Limits

- Up to 3 pages per call: PDF, PNG, JPEG or WebP.
- By link, up to 15 MB.

## Questions

**What comes back?**

Name, headline, email, phone, location, links, summary, every job with company, title, dates and description, every degree, and lists of skills and languages.

**Can I send a Word file?**

No. Send a PDF or an image; save .docx as PDF first.

**Are dates normalised?**

No. Start and end come back as written on the CV ("March 2021", "present").

**How is it billed?**

Per page read. Two pages are read unless you ask for one or three.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
