Liya Engine

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 }
      ]
    }
  }
}

Skill Gap Analysis

Required inputs

Optional inputs

Example request

Response

On this page