# BRAINIAC Job Description Structurer

> BRAINIAC Job Description Structurer is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-16).

Parses a raw job description text into structured, labeled requirements (skills, qualifications, experience, responsibilities) with strength and years metadata.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/recruitment-operations/job-description-structure?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-job-description-structurer-f29c20ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-0IDPqEyhmPLemlPPSBPn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-job-description-structurer-f29c20ef -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-job-description-structurer-f29c20ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
