🪪 AI Resume / CV and Information Extraction and Evaluation API

1 ICper page

v2.0 Active Dec 2025 POST /v3/store/ocr/curriculum-vitae

This API processes Curriculum Vitae (CV) documents (PDF, JPG, PNG) aka. Resume and extracts structured information including personal details, education history, work experience, and skills.

NEW in v2.0 - AI-Powered CV Evaluation

We've added a comprehensive CV Evaluation feature that helps job seekers improve their resumes:

• Overall Score (0-100) with breakdown by section
• ATS Compatibility Check - Ensure your CV passes Applicant Tracking Systems
• Strengths & Weaknesses Analysis
• Prioritized Improvement Suggestions with examples
• Suggested Keywords for better job matching
• Industry Fit Recommendations

Try Demo

Try Our AI Demo

Login or create a free account to use this AI service demo and explore our powerful APIs.

Get 100 Free Credits (IC) when you sign up!

Offer ends December 31, 2025

Create Free AccountLogin

Example Images (Click to try)

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

Upload your CV/Resume (PDF, JPG, PNG)

API Endpoints

Endpoint	Method	Description	Cost
/v3/store/ocr/curriculum-vitae /ocr/cv, /ocr/cv-port	POST	Extract structured data from CVs	1 IC per page

Code Examples

CV Sample

Request:

    curl -X POST https://api.iapp.co.th/ocr/cv
        -H "apikey: YOUR_API_KEY"
        -F "file=@/path/to/sample_cv_2.jpg"

Response:

{
    "personalInformation": {
        "name": "นางสาวอุไรวรรณ เจียมบุญศรี",
        "address": "317 ถ.นครวรรค์ แขวงวัดโสมนัส เขตป้อมปราศัตรูพ่าย กทม. 10100",
        "phoneNumbers": ["082-996-5168"],
        "email": "uraiwan91790@gmail.com",
        "religion": "พุทธ",
        "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"]
        },
        {
            "title": "Recruitment officer",
            "company": "GMI Market",
            "startDate": "April 2022",
            "endDate": "June 2022",
            "roles": ["สรรหาบุคลากร ตำแหน่ง sale เกี่ยวกับการเทรดเดอร์"]
        },
        {
            "title": "Senior recruitment",
            "company": "บริษัท รักษาความปลอดภัย RGH",
            "startDate": "January 2022",
            "endDate": "March 2022",
            "roles": ["สรรหาพนักงานตำแหน่ง รปภ.,แม่บ้าน"]
        }
    ],
    "skillsAndQualifications": {
        "languages": {
            "english": "พูด เขียน สื่อสาร ภาษาอังกฤษได้เป็นอย่างดี"
        },
        "computerSkills": ["สามารถใช้โปรแกนมคอมพิวเตอร์"],
        "communicationSkills": []
    },
    "possibleSkillAndQualificationsByAI": [
        "Recruiting",
        "Applicant Tracking Systems (ATS)",
        "Interviewing",
        "Talent Acquisition",
        "Onboarding",
        "HRIS",
        "Performance Management",
        "Employee Relations",
        "Sales",
        "Trading",
        "Security",
        "Customer Service",
        "Teamwork",
        "Communication"
    ],
    "additionalInformation": {
        "customerServiceSkills": null,
        "assessment": null
    }
}

Features

• CV Processing: Extracts structured information from CVs, including personal details, education, work experience, skills, and AI-suggested potential skills.

• AI-Powered Evaluation (NEW): Provides comprehensive CV analysis with:

  • Overall score and section-by-section breakdown
  • ATS (Applicant Tracking System) compatibility check
  • Strengths and weaknesses identification
  • Prioritized improvement suggestions with examples
  • Suggested keywords for better job matching
  • Industry fit recommendations

• Supported Formats: Accepts PDF, JPG, PNG, and JPEG files.

CV Evaluation Response

The API now returns an evaluation object with detailed analysis:

Score Categories

Category	Description
overall	Overall CV quality score (0-100)
personalInfo	Contact information completeness
education	Educational background presentation
workExperience	Job history with achievements
skills	Skills organization and relevance

Evaluation Fields

{
  "evaluation": {
    "scores": {
      "overall": 72,
      "personalInfo": { "score": 85, "feedback": "..." },
      "education": { "score": 70, "feedback": "..." },
      "workExperience": { "score": 65, "feedback": "..." },
      "skills": { "score": 75, "feedback": "..." }
    },
    "experienceLevel": "mid",
    "totalYearsOfExperience": 6,
    "atsCompatibility": {
      "score": 70,
      "issues": ["Missing job-specific keywords", "..."],
      "suggestions": ["Add industry-specific keywords", "..."]
    },
    "strengths": ["Clear career progression", "..."],
    "weaknesses": ["Lack of quantifiable achievements", "..."],
    "missingSections": ["Professional summary", "Certifications", "..."],
    "improvements": [
      {
        "section": "workExperience",
        "priority": "high",
        "issue": "Job descriptions lack measurable achievements",
        "suggestion": "Add specific numbers and percentages",
        "example": "Led a team of 8, achieving 125% of quarterly targets"
      }
    ],
    "suggestedKeywords": ["revenue growth", "pipeline management", "..."],
    "industryFitSuggestions": ["Sales Management", "Business Development", "..."],
    "executiveSummary": "This CV presents a mid-level professional..."
  }
}

Code Examples

Curl

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

Python

import requests

url = "https://api.iapp.co.th/ocr/cv"

payload = {}
files=[
  ('file',('sample_cv_2.jpg',open('sample_cv_2.jpg','rb'),'application/pdf'))
]
headers = {"apikey": "YOUR_API_KEY"}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

JavaScript

const axios = require("axios")
const FormData = require("form-data")
const fs = require("fs")

let data = new FormData()
data.append("file", fs.createReadStream("sample_cv_2.jpg"))

let config = {
    method: "post",
    maxBodyLength: Infinity,
    url: "https://api.iapp.co.th/ocr/cv",
    headers: {
        apikey: "YOUR_API_KEY",
        ...data.getHeaders(),
    },
    data: data,
}

axios
    .request(config)
    .then((response) => {
        console.log(JSON.stringify(response.data))
    })
    .catch((error) => {
        console.log(error)
    })

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.iapp.co.th/ocr/cv',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('file'=> new CURLFILE('sample_cv_2.jpg')),
  CURLOPT_HTTPHEADER => array(
    'apikey: YOUR_API_KEY'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Swift

let parameters = [
  [
    "key": "file",
    "src": "sample_cv_2.jpg",
    "type": "file"
  ]] as [[String: Any]]

let boundary = "Boundary-\(UUID().uuidString)"
var body = Data()
var error: Error? = nil
for param in parameters {
  if param["disabled"] != nil { continue }
  let paramName = param["key"]!
  body += Data("--\(boundary)\r\n".utf8)
  body += Data("Content-Disposition:form-data; name=\"\(paramName)\"".utf8)
  if param["contentType"] != nil {
    body += Data("\r\nContent-Type: \(param["contentType"] as! String)".utf8)
  }
  let paramType = param["type"] as! String
  if paramType == "text" {
    let paramValue = param["value"] as! String
    body += Data("\r\n\r\n\(paramValue)\r\n".utf8)
  } else {
    let paramSrc = param["src"] as! String
    let fileURL = URL(fileURLWithPath: paramSrc)
    if let fileContent = try? Data(contentsOf: fileURL) {
      body += Data("; filename=\"\(paramSrc)\"\r\n".utf8)
      body += Data("Content-Type: \"content-type header\"\r\n".utf8)
      body += Data("\r\n".utf8)
      body += fileContent
      body += Data("\r\n".utf8)
    }
  }
}
body += Data("--\(boundary)--\r\n".utf8);
let postData = body


var request = URLRequest(url: URL(string: "https://api.iapp.co.th/ocr/cv")!,timeoutInterval: Double.infinity)
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
request.addValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

Kotlin

val client = OkHttpClient()
val mediaType = "text/plain".toMediaType()
val body = MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("file","sample_cv_2.jpg",
    File("sample_cv_2.jpg").asRequestBody("application/octet-stream".toMediaType()))
  .build()
val request = Request.Builder()
  .url("https://api.iapp.co.th/ocr/cv")
  .post(body)
  .addHeader("apikey", "YOUR_API_KEY")
  .build()
val response = client.newCall(request).execute()

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("file","sample_cv_2.jpg",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("sample_cv_2.jpg")))
  .build();
Request request = new Request.Builder()
  .url("https://api.iapp.co.th/ocr/cv")
  .method("POST", body)
  .addHeader("apikey", "YOUR_API_KEY")
  .build();
Response response = client.newCall(request).execute();

Dart

var headers = {
  'apikey': 'YOUR_API_KEY'
};
var request = http.MultipartRequest('POST', Uri.parse('https://api.iapp.co.th/ocr/cv'));
request.files.add(await http.MultipartFile.fromPath('file', 'sample_cv_2.jpg'));
request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
}
else {
  print(response.reasonPhrase);
}

Pricing

AI API Service Name	Endpoint	IC Per Page	On-Premise
AI CV OCR and Information Extraction API	iapp_cv_ocr	1 IC/Page	Contact