{"uid":"cap_CDWGdMcBaPZgGaz7uiYiz","slug":"brainiac-candidate-skill-compare-51f44dd7","name":"BRAINIAC Candidate Skill Compare","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-skill-compare?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"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},"skillNames":{"type":"array","items":{"type":"string","maxLength":200,"minLength":1},"maxItems":40}}},"responseSchema":{"type":"json","example":{"issues":[],"status":"compared","overlap":[],"checkedAt":"2026-11-03T10:00:00.000Z","candidates":[{"skills":[{"name":"TypeScript","years":4,"source":"field","conflict":false,"yearsSpecified":true},{"name":"JS","years":2,"source":"field","conflict":false,"yearsSpecified":true}],"matched":[{"name":"TypeScript","years":4,"detail":"The skill name matches the supplied resume.","status":"met","inferred":false,"candidateRef":"ada","yearsSpecified":true},{"name":"JavaScript","years":0,"detail":"The skill was not in the supplied resume. One was not invented.","status":"missing","inferred":false,"candidateRef":"ada","yearsSpecified":false}],"candidateRef":"ada"},{"skills":[{"name":"Python","years":6,"source":"field","conflict":false,"yearsSpecified":true}],"matched":[{"name":"TypeScript","years":0,"detail":"The skill was not in the supplied resume. One was not invented.","status":"missing","inferred":false,"candidateRef":"grace","yearsSpecified":false},{"name":"JavaScript","years":0,"detail":"The skill was not in the supplied resume. One was not invented.","status":"missing","inferred":false,"candidateRef":"grace","yearsSpecified":false}],"candidateRef":"grace"}],"skillNames":["TypeScript","JavaScript"],"limitations":["No hiring decision is made. A person decides.","Skills, employment history, qualifications, and references are not invented.","Protected personal attributes are ignored and are not used for matching or ranking.","A match is marked inferred only when a caller-supplied alias links two names.","Date gaps are reported from supplied dates and are not ranking penalties."],"hiringDecision":false,"qualificationsInvented":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rBYs9VU_QSaYNRaBqpYR-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares a list of candidates' skills against specified skill requirements, returning per-candidate match status, years of experience, and skill gaps without inventing data.","exampleAgentPrompt":"Compare these three candidates — Ada (4 years TypeScript, 2 years JS), Grace (6 years Python), and Sam (3 years TypeScript, 5 years Java) — against the required skills TypeScript and JavaScript, and tell me who matches, who's missing what, and how many years each has.","exampleUseCases":[{"title":"Engineering role skill screening","prompt":"I have five candidates for a senior backend role. Can you compare their skills against our requirements for Python, PostgreSQL, and Docker, and tell me which candidates are missing any of those skills and by how many years they fall short?"},{"title":"Hiring shortlist skill gap analysis","prompt":"We're shortlisting for a frontend position and need TypeScript and React experience. Here are three candidates with their listed skills and years — can you check who meets both requirements, who only partially matches, and who is missing skills entirely?"},{"title":"Multi-candidate overlap discovery","prompt":"I have a pool of eight candidates and want to know which skills they all have in common — specifically which of them share proficiency in Java, Kubernetes, and CI/CD. Can you compare them and show me the skill overlap?"}],"resultDescription":"Returns a per-candidate breakdown with each required skill's match status (met, missing, or inferred), years of experience, the data source (explicit field vs inferred), whether a conflict exists, and a plain-language detail explanation. Also returns a list of skills compared, any overlap across candidates, and a set of limitations clarifying that no hiring decision is made and no data is invented.","failureModes":["Missing required candidate id or name fields returns a validation error","Candidate text or skills array exceeding max length or item limits returns a schema error","Submitting zero candidates or an empty skillNames array may return an empty or trivial result","Payment failure on the x402 protocol results in a 402 response and no result","Skill names with unconventional formatting may not match against supplied resume text"],"whenToPreferThis":"Use this endpoint when you need a structured, auditable comparison of multiple candidates' skills against a defined requirement list without any AI hallucination of credentials. It is especially suited for agent-driven recruiting workflows where explainability and no-invention guarantees matter. Prefer this over general-purpose LLM analysis when you need machine-readable match statuses, explicit years-of-experience figures, and built-in limitations disclosures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:34:39.020Z","isFirstParty":false,"canonicalSlug":"brainiac-candidate-skill-compare-51f44dd7"}