Talent API
Create AI candidate match evaluation API
Score candidate-to-role fit with explainable AI — get a match score, reasons, gaps, and auto-generated interview questions in one response.
Evaluate fit, fast — with reasons you can trust
The AI match evaluation endpoint analyses candidate profiles and job descriptions to produce an overall match score, a breakdown by skills/experience, detected gaps, and suggested interview questions. Calibrate weights, enforce bias controls, and run in real time or batch.
What you can do with AI match evaluation
- Rank candidates by fit for a given role with a single API call.
- Return reasoned explanations: matched skills, missing skills, seniority, and tenure.
- Auto-generate structured interview questions tailored to the role and gaps.
- Apply bias controls and redactions (e.g., name, age proxies, school prestige).
- Customise weights for skills, years, domain experience, and certifications.
- Run synchronously for shortlists or asynchronously for large pools with webhooks.
AI match evaluation features
- Explainable scoring with per-criterion subscores and confidence.
- Schema-flexible inputs: raw CV text, parsed JSON, profile URLs (via your parser), and JD text.
- Normalization for titles, skills, seniority, and industries.
- Bias-aware mode with protected-attribute masking and fairness constraints.
- Multi-language support for global roles.
- Deterministic modes for repeatable shortlists; stochastic modes for exploration.
- SDKs, quickstart examples, and sample scoring policies you can copy.
Why choose Ruvia?
- Built for developers: fast integration, clear docs, real support.
- Explainable by default: human-readable reasons, not black boxes.
- Trust-first: bias controls, audit logs, and GDPR/CCPA alignment.
- Scales from startups to millions of evaluations per month.
- Transparent, usage-based pricing with flexible credits.
“At GoHire we process thousands of job postings every month, and fraudulent ads were becoming a real risk to both our clients and candidates. Since integrating Ruvia’s Trust API, we automatically block 98% of scam job postings before they go live. It’s seamless, highly accurate, and gives us a huge competitive edge in building trust with our customers.”
Chris Smith
Co-Founder at GoHire
Frequently asked questions
What inputs does the API need?
Provide a job description (text/JSON) and a candidate profile (parsed JSON or raw CV text). Optional fields include skills, years of experience, location, and required certifications.
What does the response include?
An overall match score, per-criterion subscores, matched/missing skills, rationale, confidence, and auto-generated interview questions. You can also receive recommended next steps (e.g., screen, interview, reject).
How do you handle bias and fairness?
Bias-aware mode masks protected attributes and proxies, supports custom fairness constraints, and logs explanations for audit. You control weights and can export decision reasons.
Is it real time?
Yes. Typical responses are returned in seconds. For large candidate pools, use async batch processing with webhooks to receive results as they’re ready.
Can I customise scoring weights and thresholds?
Yes. You can set global or per-job weights for skills, years, domain expertise, and certifications, and define pass/review thresholds to fit your workflow.
How is this priced?
Pricing uses our credit model (1 credit = £0.01). Each evaluation consumes credits based on input size and features used (e.g., bias controls, interview question generation). See the pricing page for per-call credits.
How do you handle privacy and compliance?
All data is encrypted in transit and at rest. We support data minimisation, EU data residency, PII redaction, and GDPR/CCPA compliance. See our security page for details.