Skill Gap Analysis
Identify missing skills between a candidate's current profile and a target role or career goal.
POST /v1/hiring/skill-gap-analysis
Compares a candidate's current skills and experience against a target role or career aspiration. Returns a prioritised gap list, learning recommendations, and estimated time-to-readiness.
Required inputs
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID |
input.profile | ProfileInput | Current skills and experience |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.resume | ResumeInput | Resume text for additional context |
input.job_description | JobDescriptionInput | Target role to analyse gaps against |
input.career_goals | CareerGoalsInput | Target role if no JD is provided |
Example request
curl -X POST https://api.liyaengine.ai/v1/hiring/skill-gap-analysis \
-H "x-api-key: $LIYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"user_id": "usr_123",
"profile": {
"skills": ["JavaScript", "React", "Node.js"],
"experience_level": "mid",
"years_of_experience": 3
},
"job_description": {
"title": "Senior Full-Stack Engineer",
"description": "...",
"required_skills": ["TypeScript", "AWS", "system design", "PostgreSQL"]
}
}
}'Response
{
"success": true,
"data": {
"output": {
"overall_readiness": 58,
"gaps": [
{
"skill": "TypeScript",
"priority": "high",
"current_level": "none",
"required_level": "proficient",
"estimated_weeks_to_learn": 4,
"resources": ["Official TypeScript docs", "Execute Program TypeScript course"]
},
{
"skill": "AWS",
"priority": "high",
"current_level": "none",
"required_level": "working knowledge",
"estimated_weeks_to_learn": 8
},
{
"skill": "system design",
"priority": "medium",
"current_level": "basic",
"required_level": "proficient",
"estimated_weeks_to_learn": 12
}
],
"existing_strengths": ["JavaScript", "React", "Node.js"],
"estimated_total_weeks_to_ready": 16,
"actions": [
{ "id": "create_learning_plan", "label": "Build learning plan", "primary": true }
]
}
}
}