Liya Engine

Analyse a resume for overall quality, ATS compatibility, section-by-section feedback, keyword gaps, and actionable improvements.

POST /v1/hiring/resume-analysis

Scores and audits a resume across content quality, ATS compatibility, keyword optimisation, and formatting. Returns section-level feedback, identified issues with severity ratings, and recommended actions.

Required inputs

Field	Type	Notes
`input.user_id`	`string`	Your platform's user ID
`input.resume`	`ResumeInput`	At minimum `resume.text` (100+ chars)

Optional inputs

Field	Type	Notes
`input.profile`	`ProfileInput`	Enriches analysis with structured experience
`input.job_description`	`JobDescriptionInput`	Enables role-specific keyword gap analysis

Example request

curl -X POST https://api.liyaengine.ai/v1/hiring/resume-analysis \
  -H "x-api-key: $LIYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "user_id": "usr_123",
      "resume": {
        "text": "Jane Doe\nSenior Software Engineer\n\nExperience:\nAcme Corp — 2019–present\n...",
        "file_type": "pdf"
      },
      "job_description": {
        "title": "Staff Engineer",
        "description": "We are hiring a staff engineer to lead our platform team..."
      }
    }
  }'

Response

{
  "success": true,
  "data": {
    "output": {
      "overall_score": 74,
      "ats_compatibility_score": 68,
      "content_quality_score": 79,
      "confidence": { "score": 0.91, "level": "high" },
      "sections": [
        {
          "section_name": "Experience",
          "score": 82,
          "status": "good",
          "feedback": "Strong role progression with quantified achievements in 2 of 4 roles.",
          "suggestions": ["Add metrics to the Acme Corp role — e.g. team size, revenue impact"]
        },
        {
          "section_name": "Skills",
          "score": 55,
          "status": "needs_improvement",
          "feedback": "Skills section lists technologies without context.",
          "suggestions": ["Group skills by category", "Remove outdated technologies"]
        }
      ],
      "keywords": {
        "found": ["TypeScript", "React", "microservices"],
        "missing": ["Kubernetes", "system design", "on-call"],
        "overused": ["innovative"]
      },
      "issues": [
        {
          "severity": "major",
          "category": "Impact metrics",
          "description": "3 of 4 bullet points lack quantified outcomes.",
          "fix": "Add numbers: team size, cost savings, latency improvements, or revenue impact."
        }
      ],
      "strengths": [
        "Clear career progression over 8 years",
        "Strong education section with relevant degree"
      ],
      "actions": [
        { "id": "improve_resume", "label": "Improve resume", "primary": true }
      ]
    },
    "session_id": "ses_abc",
    "message_id": "msg_xyz"
  },
  "metadata": {
    "intent": "resume_analysis",
    "domain": "hiring",
    "model_used": "gpt-4o-mini",
    "tokens_used": 1420,
    "cost_usd": 0.00071,
    "latency_ms": 890,
    "cached": false
  }
}

Section statuses

Status	Meaning
`excellent`	No changes needed
`good`	Minor improvements possible
`needs_improvement`	Significant gaps identified
`missing`	Section absent from resume
`not_applicable`	Section not relevant for this role

Issue severities

Severity	Meaning
`critical`	Will likely cause ATS rejection or recruiter disqualification
`major`	Substantially weakens the resume
`minor`	Small improvements available
`suggestion`	Optional enhancement

Resume Analysis