{"uid":"cap_-0IDPqEyhmPLemlPPSBPn","slug":"brainiac-job-description-structurer-f29c20ef","name":"BRAINIAC Job Description Structurer","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/job-description-structure?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"title":{"type":"string","maxLength":200,"minLength":1},"jobText":{"type":"string","maxLength":20000,"minLength":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":"ignored_sensitive","kind":"ignored","field":"jobText","detail":"A personal-attribute line was ignored and was not used.","candidateRef":""},{"code":"unlabeled_ignored","kind":"ignored","field":"jobText","detail":"Unlabeled job prose was not turned into requirements.","candidateRef":""}],"status":"structured","checkedAt":"2026-11-03T10:00:00.000Z","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."],"requirements":[{"id":"R1","kind":"skill","name":"TypeScript","source":"labeled_line","strength":"required","minimumYears":3,"yearsSpecified":true},{"id":"R2","kind":"skill","name":"JavaScript","source":"labeled_line","strength":"required","minimumYears":0,"yearsSpecified":false},{"id":"R3","kind":"qualification","name":"Bachelor of Science","source":"labeled_line","strength":"required","minimumYears":0,"yearsSpecified":false},{"id":"requirement:4","kind":"responsibility","name":"Design HTTP APIs","source":"labeled_line","strength":"preferred","minimumYears":0,"yearsSpecified":false}],"hiringDecision":false,"requirementCount":4,"qualificationsInvented":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xEqZt5UANVZhFz5z1JdOo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a raw job description text into structured, labeled requirements (skills, qualifications, experience, responsibilities) with strength and years metadata.","exampleAgentPrompt":"Parse this job posting for a Backend Engineer role and extract all requirements — here's the full job description text — categorize each as a skill, qualification, experience, or responsibility, and flag which are required vs preferred.","exampleUseCases":[{"title":"ATS pipeline requirement extraction","prompt":"I have this raw job posting text for a Senior Data Scientist role — can you structure it into labeled requirements, separating required skills from preferred ones, and noting any minimum years specified?"},{"title":"Job matching prerequisite parsing","prompt":"Before we match candidates, extract all the structured requirements from this job description for a Product Manager position so I know exactly what skills, qualifications, and responsibilities to screen for."},{"title":"HR audit of job description quality","prompt":"Run this job posting for a Marketing Director through the job description structurer and tell me if any lines were ignored or if there were issues parsing the requirements — I want to clean it up before we post it."}],"resultDescription":"Returns a JSON object with an array of structured requirements (each with id, kind, name, source, strength, minimumYears, yearsSpecified), a count of requirements, any issues/warnings about ignored or unlabeled content, a checkedAt timestamp, a list of system limitations, and flags confirming no hiring decision was made and no qualifications were invented.","failureModes":["jobText exceeds 20,000 character limit — request rejected with validation error","requirements array exceeds 40 items — request rejected","Missing required fields (title or jobText) — 400 validation error","Payment not received or insufficient USDC — 402 Payment Required","Ambiguous job text with no labeled requirements — returns empty requirements array with issues listing unlabeled prose","Protected personal attributes in text — silently ignored, flagged in issues array"],"whenToPreferThis":"Use this endpoint when you need to convert unstructured job posting prose into machine-readable, labeled requirement objects for downstream matching, filtering, or auditing. It is purpose-built for recruitment automation pipelines and enforces ethical constraints (no personal attribute use, no hiring decisions). Prefer this over general-purpose LLM extraction when you need consistent schema output, transparency on what was ignored, and a pay-per-call model with no account setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:36:10.856Z","isFirstParty":false,"canonicalSlug":"brainiac-job-description-structurer-f29c20ef"}