# BRAINIAC Interview Question Generator

> BRAINIAC Interview Question Generator is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-16).

Generates tailored interview questions for a candidate based on a job description, requirements, and the candidate's resume/skills

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/recruitment-operations/interview-question-generate?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-interview-question-generator-4a09aecc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3VqYNIMvyixXyv4286t0C

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-interview-question-generator-4a09aecc -d '<json body>'
```

Example prompt: Generate interview questions for Grace Chen, who's applying for our Senior Frontend Engineer role — here's the full job description and her resume. Flag any required skills like TypeScript and JavaScript she hasn't demonstrated, and create questions that probe those gaps without assuming she has the experience.

## When to prefer this

Choose this endpoint when you need to automatically generate interview questions that are specifically tailored to a candidate's resume gaps against a structured job description. It is especially useful when you have machine-readable candidate data (skills, roles, qualifications) and want bias-aware question generation that explicitly avoids inventing credentials or penalizing employment gaps. Prefer this over generic LLM prompting when you need structured output with per-question traceability, ethical guardrails documented in the response, and pay-per-use pricing with no account required.

## Known failure modes

- Missing required fields (title, jobText, candidate) returns a validation error
- Job text or candidate text exceeding 20,000 characters is rejected
- Requirement kind or strength values outside allowed enums are rejected
- Payment of 0.04 USDC on Base not completed or invalid results in HTTP 402 Payment Required
- Empty or malformed candidate skills/roles arrays may produce fewer targeted questions
- Alias mismatches between requirement names and candidate skills may cause missed gap detection

## 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 containing a list of generated interview questions, each tagged with the basis for the question (e.g. missing_requirement or responsibility), the candidate reference, and the relevant requirement ID. Also includes a status field (e.g. 'drafted'), a checkedAt timestamp, a list of ethical limitations (no hiring decisions made, no invented details, protected attributes ignored), and any issues encountered during generation.

## Request schema (JSON Schema)

```json
{
 "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
  },
  "candidate": {
   "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
       }
      },
      "additionalPropertie
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "issues": [],
  "status": "drafted",
  "checkedAt": "2026-11-03T10:00:00.000Z",
  "questions": [
   {
    "text": "Ask about TypeScript. The supplied resume does not show that this required item is met. Do not treat a missing item as held.",
    "basedOn": "missing_requirement",
    "candidateRef": "grace",
    "requirementId": "R1"
   },
   {
    "text": "Ask about JavaScript. The supplied resume does not show that this required item is met. Do not treat a missing item as held.",
    "basedOn": "missing_requirement",
    "candidateRef": "grace",
    "requirementId": "R2"
   },
   {
    "text": "Ask the candidate to describe work related to: Design HTTP APIs. This question does not assume the candidate has done it.",
    "basedOn": "responsibility",
    "candidateRef": "grace",
    "requirementId": "requirement:3"
   }
  ],
  "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."
  ],
  "candidateRef": "grace",
  "hiringDecision": false,
  "qualificationsInvented": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-interview-question-generator-4a09aecc/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)
