SoonOne MCP server, all 49 APIs as agent tools. See how it works

AI-powered skill extraction and analysis

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.

Free tier included, no credit card required. One key works across all 49 APIs.

At a glance
Skills Detected
10K+
Languages
5
Categories
4

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

Try it

Build the request for your data

Edit the parameters below and see the exact curl command and JSON response you will get. No key required to preview.

POST/v1/skills/gap-analysis
Open in Playground
Request · HTTP
POST /parser/v1/skills/gap-analysis HTTP/1.1
Host: api.apicodex.io
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"
}

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/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 /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
curl -X POST "/v1/skills/upload" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -F "file=@resume.pdf" \
  -F "type=resume"

Available 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/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

One key, one subscription, all 49 APIs. Start free and upgrade when you grow. No minimums, no lock-in.

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 will recommend the cheapest plan that covers it.

10,000

Recommended plan

Pro

$99.99 /month

Credits used250,000
Credits included250,000
Cost per 1K requests$9.999
Choose Pro

Free

Free
1,000 credits · ~40 requests/mo · 2 rps
  • All 49 APIs included
  • No credit card required
  • Full documentation and examples
Start for free

Starter

Popular
$29.99/month
50,000 credits · ~2,000 requests/mo · 10 rps
  • All 49 APIs included
  • Email support
  • Usage dashboard and analytics
Start with Starter

Pro

$99.99/month
250,000 credits · ~10,000 requests/mo · 25 rps
  • All 49 APIs included
  • Priority support
  • Up to 5 API keys
Start with Pro

Need a different plan?

Tell us about your API, volume, or support requirements.

Contact us

Coming soon · MCP

Use the Skill Parser API from your AI agent

The API Codex MCP server will expose this API, and the other 39, to Claude, Cursor and any MCP client as tools. Same key, same credits, one config entry.

About the MCP server

FAQ

Frequently asked questions

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.

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.

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.

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.

API Codex uses one credit-based subscription that covers all 40 APIs. 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.

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.