{"uid":"cap_MS0r5vaRx9f94-Hw6wjLl","slug":"brainiac-candidate-shortlist-ranker-cb23ff0e","name":"BRAINIAC Candidate Shortlist Ranker","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/recruitment-operations/candidate-shortlist-rank?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"title":{"type":"string","maxLength":200,"minLength":1},"aliases":{"type":"array","items":{"type":"object","required":["requirement","candidate"],"properties":{"candidate":{"type":"string","maxLength":200,"minLength":1},"requirement":{"type":"string","maxLength":200,"minLength":1}},"additionalProperties":false},"maxItems":40},"jobText":{"type":"string","maxLength":20000,"minLength":1},"candidates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80,"minLength":1},"name":{"type":"string","maxLength":200,"minLength":1},"text":{"type":"string","maxLength":20000,"minLength":1},"roles":{"type":"array","items":{"type":"object","required":["title","employer"],"properties":{"end":{"type":"string","maxLength":20,"minLength":1},"text":{"type":"string","maxLength":2000,"minLength":1},"start":{"type":"string","maxLength":20,"minLength":1},"title":{"type":"string","maxLength":200,"minLength":1},"employer":{"type":"string","maxLength":200,"minLength":1}},"additionalProperties":false},"maxItems":20},"skills":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":200,"minLength":1},"years":{"type":"number","maximum":80,"minimum":0}},"additionalProperties":false},"maxItems":40},"qualifications":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":200,"minLength":1},"year":{"type":"integer","maximum":2100,"minimum":1900}},"additionalProperties":false},"maxItems":20}},"additionalProperties":false},"maxItems":20,"minItems":1},"requirements":{"type":"array","items":{"type":"object","required":["kind","name"],"properties":{"id":{"type":"string","maxLength":80,"minLength":1},"kind":{"enum":["skill","qualification","experience","responsibility"],"type":"string"},"name":{"type":"string","maxLength":200,"minLength":1},"strength":{"enum":["required","preferred"],"type":"string"},"minimumYears":{"type":"number","maximum":80,"minimum":0}},"additionalProperties":false},"maxItems":40}}},"responseSchema":{"type":"json","example":{"title":"Backend Engineer","issues":[{"code":"end_before_start","kind":"conflict","field":"Analyst","detail":"The end date is before the start date. The dates were not rewritten.","candidateRef":"grace"},{"code":"tie_order","kind":"ignored","field":"rank","detail":"Tied scores keep the caller's order. Name and personal attributes are not used to break a tie.","candidateRef":""}],"status":"ranked","factors":[{"name":"TypeScript","detail":"The skill matches and the supplied 4 years meet 3.","points":2,"inferred":false,"candidateRef":"ada","requirementId":"R1"},{"name":"JavaScript","detail":"The caller alias maps JS to JavaScript. The resume does not contain JavaScript.","points":1,"inferred":true,"candidateRef":"ada","requirementId":"R2"},"…"],"checkedAt":"2026-11-03T10:00:00.000Z","candidates":[{"tie":false,"rank":1,"score":5,"candidateRef":"ada"},{"tie":false,"rank":2,"score":0,"candidateRef":"grace"}],"limitations":["No hiring decision is made. A person decides.","Skills, employment history, qualifications, and references are not invented.","…"],"hiringDecision":false,"qualificationsInvented":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uRW0l5g7OKJvmvQR-qAhG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores and ranks a list of job candidates against structured job requirements, returning a transparent per-factor breakdown with points and explanations.","exampleAgentPrompt":"I have 5 candidates for a Backend Engineer role — can you rank them against these requirements: TypeScript (required, 3+ years), JavaScript (preferred), and a Bachelor's degree (required)? Here are their resumes and skill lists. Flag any inferred matches so I know where assumptions were made.","exampleUseCases":[{"title":"Engineering hiring shortlist ranking","prompt":"We're hiring a Senior Python Engineer. I have 8 applicants — can you score and rank them against these requirements: Python required (5+ years), Kubernetes preferred (2+ years), and a CS degree required? Here are their profiles with work history and skills."},{"title":"Recruiter pre-screen for sales role","prompt":"I need to shortlist candidates for an Account Executive position. The job needs 3+ years of B2B sales experience (required) and Salesforce proficiency (preferred). Can you rank these 12 candidates by how well they match and explain the points for each one?"},{"title":"Alias-aware skill matching for data roles","prompt":"Can you rank these 6 data analyst candidates against our job spec? The role requires SQL (required, 2+ years) and 'ML' or 'machine learning' should be treated as the same skill. Return a ranked list with scores and tell me which matches were inferred from aliases."}],"resultDescription":"A JSON object containing: a ranked list of candidates with scores and rank positions, per-factor point breakdowns with explanations for every candidate-requirement pair, inferred match flags (where aliases resolved a skill name), detected data issues (e.g. date conflicts), and a fixed limitations disclaimer stating no hiring decision is made and protected attributes are ignored.","failureModes":["Invalid or missing required fields (title, jobText, candidates, requirements) return a validation error","Candidate array with zero items is rejected by minItems:1 constraint","Exceeding maxItems limits (20 candidates, 40 skills, etc.) returns a schema error","Ties in score preserve caller-supplied order and are flagged with a tie_order issue","Dates with end before start are flagged as conflicts and not rewritten","Skills or qualifications not present in the resume are scored 0 and never invented","Payment failure via x402 returns a 402 response before any processing occurs"],"whenToPreferThis":"Choose this endpoint when you need a structured, transparent, factor-by-factor candidate ranking against explicit job requirements — especially when you need auditability (every point explained), alias-aware skill matching, and a strict no-invention guarantee. Prefer this over LLM free-form resume review when you need deterministic scoring, structured JSON output, and compliance-safe ranking that explicitly ignores protected attributes. Best suited for agentic recruitment pipelines that handle up to 20 candidates per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:37:20.982Z","isFirstParty":false,"canonicalSlug":"brainiac-candidate-shortlist-ranker-cb23ff0e"}