What file formats are supported by the Resume Parser API?

The API supports PDF and DOCX file formats. These are the most common formats used for resumes, allowing the API to extract structured information from virtually any professional resume.

How does the text parsing option work?

The API supports parsing plain text resumes through the /v1/parse/text endpoint. You can submit resume text in either JSON format or as plain text. This is useful when you already have text content extracted from a resume or when working with text-based resumes from job boards or emails.

What information can the API extract from resumes?

The API extracts comprehensive structured data including: personal details (name, email, phone, LinkedIn profile, address, state, country), professional summary, skills list, work experience, education history, certifications, languages, and projects. All data is organized into a consistent JSON format.

How accurate is the resume parsing?

The API uses advanced AI technology to achieve high accuracy. Parsing accuracy depends on the quality and format of the input document. Well-structured, clearly formatted resumes yield the best results. The API returns null values for fields that couldn't be extracted.

What are the usage limits for the Resume Parser API?

API Codex uses one credit-based subscription across every API in the catalog: Free (1,000 credits/month), Starter ($29.99/month, 50,000 credits) and Pro ($99.99/month, 250,000 credits). Each parsed resume costs 25 credits, which means roughly 40 resumes per month on Free, 2,000 on Starter and 10,000 on Pro. Only successful (2xx) responses consume credits.

Can the API handle international resumes and different formats?

Yes, the Resume Parser API is designed to handle diverse resume formats from around the world. It can parse resumes with varying structures, including chronological, functional, and combination formats. The API recognizes international phone number formats, addresses from different countries, and education systems worldwide. It handles creative resume layouts, multi-column designs, and resumes with graphics or logos, though simpler formats typically yield the best extraction accuracy.

AI-powered resume processing for HR systems

Resume Parser API

Name: Resume Parser API
Brand: API Codex
SKU: resume-parser-api

A powerful AI-powered API for parsing resumes and CVs. This API extracts structured information from resume documents in PDF and DOCX formats, as well as plain text content.

Built with advanced AI technology, our API provides reliable and efficient resume parsing capabilities with support for multiple input methods and comprehensive data extraction.

Get a free API key Read the docs

Free tier included, no credit card required. One key works across every API.

Free calls / month: 40
Parsing Accuracy: 95.2%
Supported Formats: 3
Data Fields: 25+

Get your free API key

40 free calls on the free plan

Key features

Multiple input methods: File upload (PDF/DOCX), URL-based fetching, and direct text parsing
AI-powered extraction using advanced AI technology
Comprehensive data extraction with structured JSON output
Date normalization for consistent formatting
Transparent parsing with null values for unextracted fields
Enterprise-ready for ATS and HR systems

Built for

Applicant tracking systems (ATS)
HR management platforms
Recruitment agencies
Talent acquisition tools
Career services platforms
Job board integrations
Candidate screening automation
Resume database management

MCP · for your agent

Hand the Resume Parser API to your agent

Connect Claude, Cursor or any MCP client once, then ask in plain words. Your agent finds this API, reads its docs and makes the call: 25 credits per call, the same as REST, from your team's balance.

Connect your agent

Shortlist applicants for a role

“Parse these 40 resume links for our Staff Engineer opening and shortlist people with 5+ years of Go.”

list_apis · get_api_docsfree

api_request POST /resume-parser/v1/parse/url 25 cr

Structured profiles with skills, roles and dates, ranked into a shortlist with reasons.

Import a resume into the ATS

“Turn this pasted resume into our ATS fields, with the phone in international format and the email address verified.”

list_apis · get_api_docsfree

api_request POST /resume-parser/v1/parse/text 25 cr

+ Phone Number Validation & Formatting API5 cr

+ Email Intelligence API5 cr

Name, contact details, experience, skills and education mapped to ATS fields, contacts verified.

Match a candidate to open roles

“We have 3 open roles. Parse Jane Doe's resume and tell me which job description she fits best, and her gaps.”

list_apis · get_api_docsfree

api_request POST /resume-parser/v1/parse/text 25 cr

+ Skill Parser API25 cr

Her parsed profile scored against each role, with matched and missing skills per job.

$ claude mcp add --transport http apicodex https://mcp.apicodex.io

Illustrative asks; the calls and prices are real. Claude, Cursor, VS Code and Windsurf setup: mcp.apicodex.io

Try it

Build the request for your data

Edit the parameters below and see the exact request and curl command you'd send. No key required to preview.

POST /resume-parser/v1/parse/text

Open in Playground

Request · HTTP

POST /resume-parser/v1/parse/text HTTP/1.1
Host: api.apicodex.io
Content-Type: application/json
X-Api-Key: YOUR_API_KEY

{
  "text": "John Doe. Senior Software Engineer at Tech Corp (2020 - Present). Skills: JavaScript, React, Node.js, Python, AWS. B.Sc. Computer Science, University of Technology, 2018."
}

Response · JSON 200 OK

{
"success": true,
"parsed_at": "2025-05-04T07:37:21.000Z",
"data": {
  "person": {
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "+1 (555) 123-4567",
    "linkedin": "https://linkedin.com/in/johndoe",
    "address": "123 Main St, Apt 4B",
    "state": "New York",
    "country": "USA"
  },
  "summary": "Experienced software engineer with 5+ years developing web applications...",
  "skills": [
    "JavaScript",
    "React",
    "Node.js",
    "Python",
    "AWS",
    "MongoDB"
  ],
  "experience": [
    {
      "title": "Senior Software Engineer",
      "company": "Tech Corp",
      "duration": "2020 - Present",
      "description": "Led development of customer-facing web applications..."
    }
  ],
  "education": [
    {
      "degree": "Bachelor of Science in Computer Science",
      "institution": "University of Technology",
      "year": "2018",
      "gpa": "3.8"
    }
  ],
  "certifications": [
    "AWS Certified Developer",
    "Google Cloud Professional"
  ],
  "languages": [
    "English (Native)",
    "Spanish (Conversational)"
  ],
  "projects": [
    {
      "name": "E-commerce Platform",
      "description": "Built a full-stack e-commerce solution...",
      "technologies": ["React", "Node.js", "MongoDB"]
    }
  ]
}
}

Run it with your key

Documentation

Resume Parser API Documentation

The Resume Parser API provides comprehensive parsing and extraction of resume data from various document formats. This documentation outlines how to effectively integrate and utilize the API for processing resume documents, extracting candidate data, and automating HR workflows.

Base URL

url

https://api.apicodex.io/resume-parser

Authentication

Authenticate every request with your API key: send it in an X-Api-Key header, or pass it as an ?apikey= query parameter.

headers

{
"X-Api-Key": "YOUR_API_KEY"
}

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http

POST /resume-parser/v1/parse/text HTTP/1.1
Host: api.apicodex.io
Content-Type: application/json
X-Api-Key: YOUR_API_KEY

{
  "text": "John Doe. Senior Software Engineer at Tech Corp (2020 - Present). Skills: JavaScript, React, Node.js, Python, AWS. B.Sc. Computer Science, University of Technology, 2018."
}

response · json

{
"success": true,
"parsed_at": "2025-05-04T07:37:21.000Z",
"data": {
  "person": {
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "+1 (555) 123-4567",
    "linkedin": "https://linkedin.com/in/johndoe",
    "address": "123 Main St, Apt 4B",
    "state": "New York",
    "country": "USA"
  },
  "summary": "Experienced software engineer with 5+ years developing web applications...",
  "skills": [
    "JavaScript",
    "React",
    "Node.js",
    "Python",
    "AWS",
    "MongoDB"
  ],
  "experience": [
    {
      "title": "Senior Software Engineer",
      "company": "Tech Corp",
      "duration": "2020 - Present",
      "description": "Led development of customer-facing web applications..."
    }
  ],
  "education": [
    {
      "degree": "Bachelor of Science in Computer Science",
      "institution": "University of Technology",
      "year": "2018",
      "gpa": "3.8"
    }
  ],
  "certifications": [
    "AWS Certified Developer",
    "Google Cloud Professional"
  ],
  "languages": [
    "English (Native)",
    "Spanish (Conversational)"
  ],
  "projects": [
    {
      "name": "E-commerce Platform",
      "description": "Built a full-stack e-commerce solution...",
      "technologies": ["React", "Node.js", "MongoDB"]
    }
  ]
}
}

Code examples

cURL (upload)

curl -X POST "https://api.apicodex.io/resume-parser/v1/parse/upload" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -F "[email protected]"

cURL (text)

curl -X POST "https://api.apicodex.io/resume-parser/v1/parse/text" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"text": "John Doe\nSoftware Engineer\n..."}'

javascript

const axios = require('axios');

// File upload method
const formData = new FormData();
formData.append('file', fileInput.files[0]);

const options = {
  method: 'POST',
  url: 'https://api.apicodex.io/resume-parser/v1/parse/upload',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  },
  data: formData
};

try {
  const response = await axios.request(options);
  console.log(response.data);
} catch (error) {
  console.error(error);
}

python

import requests

# File upload method
url = "https://api.apicodex.io/resume-parser/v1/parse/upload"

files = {"file": open("resume.pdf", "rb")}
headers = {
    "X-Api-Key": "YOUR_API_KEY"
}

response = requests.post(url, files=files, headers=headers)
print(response.json())

# Text parsing method
url_text = "https://api.apicodex.io/resume-parser/v1/parse/text"
payload = {"text": "John Doe\nSoftware Engineer\n..."}
response_text = requests.post(url_text, json=payload, headers=headers)
print(response_text.json())

Endpoints

POST /v1/parse/upload

Upload a PDF, HTML or plain-text file (multipart/form-data, field name: file).

curl -X POST "https://api.apicodex.io/resume-parser/v1/parse/upload" -H "X-Api-Key: YOUR_API_KEY" -F "[email protected]"

POST /v1/parse/url

Parse a document fetched from a public URL. JSON body: {"url": "https://..."}.

POST /v1/parse/text

Parse plain text. JSON body {"text": "..."}, or a text/plain body.

Pricing

Resume Parser API Pricing

This API costs 25 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We'll recommend the cheapest plan that covers it.

Requests per month 10,000

Recommended plan

Starter

$29.99 /month

Credits used

Credits included

Cost per 1K requests

Choose Starter

Free

1,000 credits · ~40 requests/mo · 2 rps

All APIs included
No credit card required
Full documentation and examples
MCP server for your AI agents
Up to 5 active API keys

Start for free

Starter

Popular

$29.99 /month

50,000 credits · ~2,000 requests/mo · 10 rps

All APIs included
Email support
Usage dashboard and analytics
MCP server for your AI agents
Up to 5 active API keys

Start with Starter

Pro

$99.99 /month

250,000 credits · ~10,000 requests/mo · 25 rps

All APIs included
Priority support
MCP server for your AI agents
Up to 5 active API keys

Start with Pro

FAQ

Resume Parser API

Key features

Built for

Hand the Resume Parser API to your agent

Shortlist applicants for a role

Import a resume into the ATS

Match a candidate to open roles

Build the request for your data

Resume Parser API Documentation

Base URL

Authentication

Request and response

Code examples

Endpoints

POST /v1/parse/upload

POST /v1/parse/url

POST /v1/parse/text

Resume Parser API Pricing

Free

Starter

Pro

Need a different plan?

Frequently asked questions

Related APIs