AI Resume and CV Extraction and Evaluation

Reads a CV or résumé into structured fields and evaluates it: a score out of 100 per section, an ATS check, strengths, weaknesses and improvements.

POST/v3/store/ocr/curriculum-vitaeTry it

• Price1 ICper page
• Served37.3Kcalls

• v2.0
• Active

Input

OutputPOST /v3/store/ocr/curriculum-vitae

personalInformation

name: นางสาวXXXX XXXXXXX phoneNumbers: 08X-XXX-XXXX email: example@example.com nationality: ไทย age: 43

education

school: โรงเรียนราชวินิต มัธยม level: มัธยมศึกษาปีที่ 6 year: 2538-2540

workExperience

title: Recruitment officer company: Apex medical center startDate: May 2022 endDate: December 2022 roles: สรรหาพนักงานตำแหน่ง consultant, beauty therapist, nurse

skillsAndQualifications

languages: english: พูด เขียน สื่อสารได้ดี computerSkills: สามารถใช้โปรแกรมคอมพิวเตอร์

possibleSkillAndQualificationsByAI

Recruiting Interviewing Talent Acquisition Onboarding

evaluation

{ scores, experienceLevel, totalYearsOfExperience, atsCompatibility, improvements, suggestedKeywords, executiveSummary }

confidence

personalInformation: 0.95 education: 0.9 workExperience: 0.9

Every field, under Response

Request

curl -X POST https://api.iapp.co.th/v3/store/ocr/curriculum-vitae \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@cv.pdf"

Response

200OK. The fields are explained under Response.

{
  "personalInformation": { "name": "นางสาวXXXX XXXXXXX", "phoneNumbers": ["08X-XXX-XXXX"],
                           "email": "example@example.com", "nationality": "ไทย", "age": "43" },
  "education": [ { "school": "โรงเรียนราชวินิต มัธยม", "level": "มัธยมศึกษาปีที่ 6", "year": "2538-2540" } ],
  "workExperience": [
    { "title": "Recruitment officer", "company": "Apex medical center",
      "startDate": "May 2022", "endDate": "December 2022",
      "roles": ["สรรหาพนักงานตำแหน่ง consultant, beauty therapist, nurse"] }
  ],
  "skillsAndQualifications": { "languages": { "english": "พูด เขียน สื่อสารได้ดี" },
                               "computerSkills": ["สามารถใช้โปรแกรมคอมพิวเตอร์"] },
  "possibleSkillAndQualificationsByAI": ["Recruiting", "Interviewing", "Talent Acquisition", "Onboarding"],
  "evaluation": {
    "scores": { "overall": 72, "personalInfo": { "score": 85, "feedback": "..." },
                "workExperience": { "score": 65, "feedback": "..." } },
    "experienceLevel": "mid",
    "totalYearsOfExperience": 6,
    "atsCompatibility": { "score": 70, "issues": ["Missing job-specific keywords"] },
    "improvements": [ { "section": "workExperience", "priority": "high",
                        "issue": "Job descriptions lack measurable achievements",
                        "suggestion": "Add specific numbers and percentages" } ],
    "suggestedKeywords": ["revenue growth", "pipeline management"],
    "executiveSummary": "This CV presents a mid-level professional..."
  },
  "confidence": { "personalInformation": 0.95, "education": 0.9, "workExperience": 0.9 }
}

Request

multipart/form-data, one CV per request, at 1 IC per page.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

filefilerequired

The CV. PDF, JPEG or PNG.

The legacy paths /ocr/cv and /ocr/cv-port answer at the same price.

Response

personalInformationobject

The person, as the CV states them.

personalInformation.namestring

Full name, with the title

personalInformation.addressstring

personalInformation.phoneNumbersarray

Each number as written

personalInformation.emailstring

personalInformation.religionstring

personalInformation.nationalitystring

personalInformation.agestring

As stated, or worked out from the date of birth

educationarray

One entry per school, latest first.

education.schoolstring

education.levelstring

The qualification or year level

education.yearstring

The years attended, as written

workExperiencearray

One entry per job, latest first.

workExperience.titlestring

workExperience.companystring

workExperience.startDatestring

workExperience.endDatestring

Empty for a current job

workExperience.rolesarray

Responsibilities, one string each

skillsAndQualificationsobject

skillsAndQualifications.languagesobject

A language to its stated proficiency

skillsAndQualifications.computerSkillsarray

skillsAndQualifications.communicationSkillsarray

possibleSkillAndQualificationsByAIarray

Skills the CV implies but does not name

additionalInformationstring

Anything else the CV states

confidenceobject

Confidence per section, 0 to 1

evaluationobject

The assessment, added in v2.0.

evaluation.scoresobject

evaluation.scores.overallinteger

0 to 100

evaluation.scores.personalInfoevaluation.scores.educationevaluation.scores.workExperienceevaluation.scores.skillsobject

Each a score out of 100 with its feedback

evaluation.experienceLevelstring

entry, mid or senior

evaluation.totalYearsOfExperienceinteger

Years of work, summed over the jobs

evaluation.atsCompatibilityobject

evaluation.atsCompatibility.scoreinteger

0 to 100

evaluation.atsCompatibility.issuesarray

What an applicant tracking system would trip on

evaluation.atsCompatibility.suggestionsarray

How to fix each

evaluation.strengthsevaluation.weaknessesevaluation.missingSectionsarray

Plain lists

evaluation.improvementsarray

Ordered by priority.

evaluation.improvements.prioritystring

high, medium or low

evaluation.improvements.sectionstring

The section it concerns

evaluation.improvements.issuestring

evaluation.improvements.suggestionstring

evaluation.improvements.examplestring

A rewritten line, where one helps

evaluation.suggestedKeywordsarray

Keywords to add

evaluation.industryFitSuggestionsarray

The industries the CV fits

evaluation.executiveSummarystring

One paragraph on the candidate

Details

Limits

• Thai and English CVs.
• Without code: the free CV evaluation tool runs this API.

Changelog

Version	Date	Changes
v2.0	2025	Added the evaluation object: scores, an ATS check, strengths, weaknesses, improvements, keywords and industry fit.
v1.0	2024	Extraction.