Liya Engine

AI-powered recruiting intelligence — resume analysis, candidate scoring, mock interviews, career coaching, and more.

The Hiring domain pack provides 17 intents covering the full talent lifecycle — from job description analysis and candidate screening to career coaching and interview preparation.

API base path: POST /v1/hiring/{intent}

Intents

Recruiter intents

Intent	Endpoint	Required inputs
resume-analysis	`/v1/hiring/resume-analysis`	`resume`
job-fit-analysis	`/v1/hiring/job-fit-analysis`	`resume`, `job_description`
candidate-prescreen	`/v1/hiring/candidate-prescreen`	`profile`, `job_description`
candidate-scoring	`/v1/hiring/candidate-scoring`	`profile`, `job_description`
`jd-analysis`	`/v1/hiring/jd-analysis`	`job_description`
`knockout-question-generation`	`/v1/hiring/knockout-question-generation`	`job_description`
`interview-question-generation`	`/v1/hiring/interview-question-generation`	`profile`, `job_description`

Candidate intents

Intent	Endpoint	Required inputs
resume-improvement	`/v1/hiring/resume-improvement`	`profile`
`cover-letter-generation`	`/v1/hiring/cover-letter-generation`	`profile`, `job_description`
`intro-script-generation`	`/v1/hiring/intro-script-generation`	`profile`, `job_description`
career-assessment	`/v1/hiring/career-assessment`	`profile`
skill-gap-analysis	`/v1/hiring/skill-gap-analysis`	`profile`
career-path-planning	`/v1/hiring/career-path-planning`	`profile`
career-transition-planning	`/v1/hiring/career-transition-planning`	`profile`, `career_goals`
mock-interview	`/v1/hiring/mock-interview`	`profile`
coaching-session	`/v1/hiring/coaching-session`	—
general-chat	`/v1/hiring/general-chat`	—

Request structure

All hiring intents share the same top-level request envelope:

{
  "input": {
    "user_id": "usr_123",           // required — your platform's user ID
    "message": "...",               // optional free-text message / question
    "resume": { ... },              // ResumeInput — see below
    "profile": { ... },             // ProfileInput
    "job_description": { ... },     // JobDescriptionInput
    "career_goals": { ... },        // CareerGoalsInput
    "interview_context": { ... }    // InterviewContextInput
  },
  "session_id": "ses_abc",          // optional — continue an existing session
  "preferences": {                  // optional request options
    "language": "en",
    "include_confidence": true,
    "include_reasoning": false,
    "max_tokens": 4000
  }
}

Common input schemas

ResumeInput

{
  "text": "John Smith\nSoftware Engineer...",   // required, min 100 chars
  "contact_section": "...",                      // optional parsed sections
  "experience_section": "...",
  "education_section": "...",
  "skills_section": "...",
  "file_type": "pdf",                            // "pdf" | "docx" | "txt" | "html"
  "original_filename": "john_smith_resume.pdf"
}

ProfileInput

{
  "name": "Jane Doe",
  "title": "Senior Software Engineer",
  "years_of_experience": 8,
  "experience_level": "senior",                  // "entry" | "mid" | "senior" | "lead" | "executive"
  "skills": ["TypeScript", "React", "Node.js"],
  "work_experiences": [
    {
      "title": "Senior Engineer",
      "company": "Acme Corp",
      "start_date": "2020-01-01",
      "end_date": null,                          // null = current role
      "achievements": ["Led migration to microservices, reducing latency by 40%"]
    }
  ],
  "educations": [
    {
      "degree": "BSc",
      "field": "Computer Science",
      "institution": "MIT",
      "graduation_year": 2016
    }
  ]
}

JobDescriptionInput

{
  "title": "Staff Engineer",
  "description": "We are looking for...",        // required, min 50 chars
  "company_name": "Stripe",
  "required_skills": ["Go", "Kubernetes"],
  "required_experience_years": 7,
  "work_arrangement": "hybrid",                  // "remote" | "hybrid" | "onsite"
  "employment_type": "full_time"
}

CareerGoalsInput

{
  "target_role": "Engineering Manager",
  "timeline": "1_year",    // "immediate" | "3_months" | "6_months" | "1_year" | "2_years" | "exploratory"
  "remote_preference": "hybrid_ok",
  "priorities": ["growth", "leadership"]         // "compensation" | "growth" | "work_life_balance" | "learning" | "impact" | "leadership" | "stability" | "flexibility"
}

Response structure

{
  "success": true,
  "data": {
    "output": { ... },              // intent-specific structured output
    "session_id": "ses_abc",
    "message_id": "msg_xyz"
  },
  "metadata": {
    "intent": "resume_analysis",
    "domain": "hiring",
    "model_used": "gpt-4o-mini",
    "tokens_used": 1240,
    "cost_usd": 0.00062,
    "latency_ms": 820,
    "cached": false
  },
  "usage": {
    "requests_remaining": 847,      // null if unlimited
    "tokens_remaining": 998760
  }
}

Knowledge sources

Upload documents to enrich hiring intelligence with your own data:

Source type	Namespace	Use case
Resume	`hiring:resume`	Candidate profiles for retrieval
Job Description	`hiring:job_description`	JD library for fit scoring
Policy	`hiring:policy`	Hiring policies and compliance rules
Profile	`hiring:profile`	Structured candidate profiles
Session Summary	`hiring:session_summary`	AI-generated session memory

Hiring Domain