API Documentation

Integrate CV Parser Pro's CV parsing capabilities into your applications.

Authentication

All API requests require an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from Settings → API Keys

Base URL

https://api.cvparserpro.com

Rate Limits

Plan	Requests/min	CV Parses/month
Free	10	10
Starter	60	100
Growth	120	500
Scale	300	2,000

Endpoints

POST/v1/parse

Parse a CV file and extract structured data

Request

curl -X POST https://api.cvparserpro.com/v1/parse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "[email protected]"

Response

{
  "id": "cand_abc123",
  "full_name": "John Smith",
  "email": "[email protected]",
  "phone": "+1 555-0123",
  "current_title": "Senior Software Engineer",
  "years_of_experience": 8,
  "skills": ["Python", "TypeScript", "React", "AWS"],
  "education": [...],
  "work_history": [...],
  "parsing_confidence": 0.95
}

POST/v1/parse/url

Parse a CV from a URL

Request

curl -X POST https://api.cvparserpro.com/v1/parse/url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/resume.pdf"}'

Response

{
  "id": "cand_def456",
  "full_name": "Jane Doe",
  ...
}

GET/v1/candidates

List all parsed candidates

Request

curl https://api.cvparserpro.com/v1/candidates \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "candidates": [...],
  "total": 150,
  "page": 1,
  "limit": 20
}

GET/v1/candidates/:id

Get a specific candidate by ID

Request

curl https://api.cvparserpro.com/v1/candidates/cand_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "cand_abc123",
  "full_name": "John Smith",
  ...
}

GET/v1/usage

Get API usage statistics

Request

curl https://api.cvparserpro.com/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "plan": "growth",
  "credits_used": 245,
  "credits_remaining": 255,
  "reset_date": "2024-02-01T00:00:00Z"
}

Error Codes

Code	Message	Description
400	Bad Request	Invalid request format or parameters
401	Unauthorized	Missing or invalid API key
402	Payment Required	Insufficient credits
404	Not Found	Resource not found
429	Too Many Requests	Rate limit exceeded
500	Internal Error	Server error

Legal & Compliance

By using the CVParserPro API, you agree to our Terms of Service and Privacy Policy. When processing resume data through our API, your organization acts as the data controller and CVParserPro acts as the data processor.

Data Processing: Resume data uploaded through the API is processed in accordance with our Data Processing Agreement. We do not retain parsed resume data beyond 30 days unless otherwise specified in your plan.

Your Responsibilities: You are responsible for obtaining appropriate consent from candidates before uploading their resumes, providing privacy notices, and responding to data subject rights requests.

Compliance: CVParserPro is SOC 2 Type II certified and GDPR compliant. For enterprise compliance requirements, please contact our security team.

Ready to get started?

Get Your API Key