What file formats are supported?

The Skill Parser API supports PDF and DOCX file formats for document-based skill extraction, covering the vast majority of resume and job description formats used in professional settings. You can upload these files directly via multipart form data to the /v1/skills/upload endpoint. Additionally, the API accepts plain text input through the /v1/skills/text endpoint, enabling you to extract skills from any text source including job postings, LinkedIn profiles, or project descriptions that you have already converted to string format. This flexibility means you can integrate the API into diverse workflows regardless of how your source documents are stored or transmitted.

How does Skills Gap Analysis work?

Skills Gap Analysis compares the skills found in a source document (typically a resume) against the requirements in a target document (typically a job description) to produce a comprehensive compatibility assessment. The API returns a match percentage score, a list of matched skills with confidence levels, missing skills ranked by importance to the role, additional skills the candidate possesses beyond the requirements, and actionable recommendations for closing identified gaps. This feature is invaluable for recruiters who need to quickly assess candidate-role fit across high volumes of applicants, and equally useful for job seekers who want to understand exactly which skills they need to develop for their target positions.

How does skill categorization work?

Our AI-driven categorization system organizes extracted skills into four primary categories: technical skills (programming languages, frameworks, tools), soft skills (communication, leadership, problem-solving), domain-specific skills (industry knowledge, regulatory expertise, specialized methodologies), and certifications (professional credentials, licenses, formal qualifications). The classification model draws on a knowledge base of over 10,000 skills mapped across industries and roles, and it continually improves through machine learning as it processes new documents. Each skill is assigned a confidence score indicating the model's certainty in both the extraction and categorization, allowing you to set thresholds appropriate for your use case.

Does the API support multiple languages?

Yes, the API currently supports five languages: English, Spanish, French, German, and Portuguese, with automatic language detection that requires no configuration on your part. The system identifies the document language during processing and applies language-specific NLP models optimized for skill terminology and professional vocabulary in each supported language. This is particularly valuable for multinational organizations processing resumes and job descriptions across different markets and offices. Cross-language skill matching is also supported, meaning a Spanish-language resume can be compared against an English-language job description with skills mapped and normalized across both languages.

What are the usage limits?

API Codex uses one credit-based subscription that covers every API in the catalog. The Free plan includes 1,000 credits per month, ideal for testing and small-scale projects. Starter ($29.99/month) includes 50,000 credits and Pro ($99.99/month) includes 250,000. Each parsing request costs 25 credits, which translates to roughly 40 requests per month on Free, 2,000 on Starter and 10,000 on Pro, and each request processes one document. Only successful (2xx) responses consume credits. Enterprise volumes are available on request.

How does the API determine skill proficiency and experience levels?

The Skill Parser API uses contextual analysis and natural language processing to infer skill proficiency levels from surrounding text. It analyzes factors such as years of experience mentioned, project complexity described, leadership or teaching roles involving the skill, and certification or formal training references. The API assigns confidence scores to each extracted skill and experience level, helping you understand the reliability of the assessment. For example, if a resume states 'Led a team of 5 developers building React applications for 3 years,' the API would extract React as a skill with high proficiency and 3 years of experience with high confidence.

AI-powered skill extraction and analysis

Skill Parser API

Name: Skill Parser API
Brand: API Codex
SKU: skill-parser-api

An advanced AI-powered API for extracting and categorizing professional skills from resumes, job descriptions, and any text content. This API helps recruiters, HR platforms, and career services identify talent capabilities and match candidates to opportunities.

Built with cutting-edge natural language processing, our API provides comprehensive skill analysis with multi-language support and specialized features for talent acquisition and career development.

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
Skills Detected: 10K+
Languages: 5
Categories: 4

Get your free API key

40 free calls on the free plan

Key features

AI-powered skill extraction with automatic categorization
Skills gap analysis comparing resumes to job descriptions
Multi-format support: PDF, DOCX files and plain text
Multi-language processing with automatic detection
Structured output with skill categories and experience levels
Industry-specific skill recognition and certification detection
Experience analysis with years of experience calculation

Built for

Talent acquisition and recruitment
Skills gap analysis for teams
Professional development planning
Job matching platforms
Career counseling services
Training needs assessment
Workforce skills mapping
Competency framework development

MCP · for your agent

Hand the Skill 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

Find a candidate's skill gaps

“Compare this candidate's resume with our Senior Data Analyst job description. How strong is the match, and what's missing?”

list_apis · get_api_docsfree

api_request POST /skill-parser/v1/skills/gap-analysis 25 cr

Match percentage, matched and missing skills by importance, and areas to probe in interviews.

Map a team's skills

“Extract skills from our 12 engineers' profile summaries and show me where we're thin on cloud and security.”

list_apis · get_api_docsfree

api_request POST /skill-parser/v1/skills/text 25 cr

Technical, soft and domain skills per person, rolled up into a team skills matrix.

Turn a job post into screening questions

“Pull this Indeed posting and list the technical, soft and domain skills it asks for, then draft screening questions.”

list_apis · get_api_docsfree

api_request POST /skill-parser/v1/skills/text 25 cr

+ Indeed Jobs API25 cr

The posting's skills grouped as technical, soft and domain, with a screening question for each.

$ 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 /skill-parser/v1/skills/gap-analysis

Open in Playground

Request · HTTP

POST /skill-parser/v1/skills/gap-analysis HTTP/1.1
Host: api.apicodex.io
Content-Type: application/json
X-Api-Key: YOUR_API_KEY

{
"sourceText": "Software engineer with React, Node.js, Python...",
"targetText": "Seeking full-stack developer with React, Vue.js, Python...",
"sourceType": "resume",
"targetType": "job_description"
}

Response · JSON 200 OK

{
"match_percentage": 75,
"matched_skills": [
  {
    "skill": "React",
    "category": "technical",
    "confidence": 0.95
  },
  {
    "skill": "Python",
    "category": "technical",
    "confidence": 0.92
  }
],
"missing_skills": [
  {
    "skill": "Vue.js",
    "category": "technical",
    "importance": "high"
  }
],
"additional_skills": [
  {
    "skill": "Node.js",
    "category": "technical",
    "transferability": "high"
  }
],
"recommendations": [
  "Consider learning Vue.js to improve match score",
  "Node.js experience is valuable for full-stack role"
],
"overall_assessment": "Strong technical match with opportunity to learn Vue.js"
}

Run it with your key

Documentation

Skill Parser API Documentation

The Skill Parser API provides comprehensive skill extraction and analysis capabilities. This documentation outlines how to effectively integrate and utilize the API for talent acquisition, job matching, and professional development applications.

Base URL

url

https://api.apicodex.io/skill-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 /skill-parser/v1/skills/gap-analysis HTTP/1.1
Host: api.apicodex.io
Content-Type: application/json
X-Api-Key: YOUR_API_KEY

{
"sourceText": "Software engineer with React, Node.js, Python...",
"targetText": "Seeking full-stack developer with React, Vue.js, Python...",
"sourceType": "resume",
"targetType": "job_description"
}

response · json

{
"match_percentage": 75,
"matched_skills": [
  {
    "skill": "React",
    "category": "technical",
    "confidence": 0.95
  },
  {
    "skill": "Python",
    "category": "technical",
    "confidence": 0.92
  }
],
"missing_skills": [
  {
    "skill": "Vue.js",
    "category": "technical",
    "importance": "high"
  }
],
"additional_skills": [
  {
    "skill": "Node.js",
    "category": "technical",
    "transferability": "high"
  }
],
"recommendations": [
  "Consider learning Vue.js to improve match score",
  "Node.js experience is valuable for full-stack role"
],
"overall_assessment": "Strong technical match with opportunity to learn Vue.js"
}

Code examples

cURL (upload)

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

cURL (text)

curl -X POST "https://api.apicodex.io/skill-parser/v1/skills/text" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"text": "Software engineer with React, Node.js...", "type": "resume"}'

cURL (gap analysis)

curl -X POST "https://api.apicodex.io/skill-parser/v1/skills/gap-analysis" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"sourceText": "resume content", "targetText": "job description", "sourceType": "resume", "targetType": "job_description"}'

javascript

const axios = require('axios');

// Skills Gap Analysis
const options = {
  method: 'POST',
  url: 'https://api.apicodex.io/skill-parser/v1/skills/gap-analysis',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': 'YOUR_API_KEY'
  },
  data: {
    sourceText: 'Software engineer with React, Node.js, Python...',
    targetText: 'Seeking full-stack developer with React, Vue.js, Python...',
    sourceType: 'resume',
    targetType: 'job_description'
  }
};

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

python

import requests

# Text parsing example
url = "https://api.apicodex.io/skill-parser/v1/skills/text"

payload = {
    "text": "Software engineer with React, Node.js, Python, AWS experience",
    "type": "resume"
}
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
}

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

Endpoints

POST /v1/skills/upload

Extract skills from uploaded PDF or DOCX files.

Parameters: file (PDF/DOCX), type (general/job_description/resume)

POST /v1/skills/url

Extract skills from a document at a public URL.

Body: {"url": "https://...", "type": "resume"}

POST /v1/skills/text

Extract skills from plain text input.

Body: {"text": "content", "type": "resume"}

POST /v1/skills/gap-analysis

Compare skills between resume and job description.

Body: {"sourceText": "...", "targetText": "...", "sourceType": "resume", "targetType": "job_description"}

Pricing

Skill 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

Skill Parser API

Key features

Built for

Hand the Skill Parser API to your agent

Find a candidate's skill gaps

Map a team's skills

Turn a job post into screening questions

Build the request for your data

Skill Parser API Documentation

Base URL

Authentication

Request and response

Code examples

Endpoints

POST /v1/skills/upload

POST /v1/skills/url

POST /v1/skills/text

POST /v1/skills/gap-analysis

Skill Parser API Pricing

Free

Starter

Pro

Need a different plan?

Frequently asked questions

Related APIs