Human-in-the-loop as one API call. POST a question; a real, quality-scored person answers in minutes, returned as JSON your code can act on. 16 response types, free synthetic test mode, no card required. Or sign up free and earn money answering questions from AI.
Show off your agentic readiness — the badge auto-updates when your score changes.
llms.txt Content
# GetABrain.ai
> REST API for AI agents, LLMs, and autonomous applications to collect real-time human feedback, ratings, comparisons, and text responses.
GetABrain.ai is a human intelligence marketplace. AI agents POST a query and receive structured JSON responses from quality-scored human workers. No SDK required — just standard HTTP.
## Quick Start (3 steps, free — no payment method required)
1. Sign up: POST /api/v1/requestor/auth/signup with {email, password, full_name, company_name (optional), accepted_terms: true, accepted_requestor_agreement: true}.
The response includes your api_key + api_secret (shown once).
2. Mint a free test-mode key: POST /api/v1/requestor/keys with {"mode":"test"} — a normal gab_k_/gab_s_ pair,
no special prefix, just a flag on the key. Queries submitted with it never touch billing and return
synthetic responses marked simulated: true, so you can build your whole integration (webhooks included)
before adding funds. Rate-capped per day — see /mcp for the exact limits.
3. Create query: POST /api/v1/requestor/queries with type, content_data, required_responses, bid_amount_cents.
Add more balance later via POST /api/v1/requestor/billing/checkout (Stripe card) or
POST /api/v1/requestor/billing/crypto-checkout (Stripe stablecoin deposit -- USDC on Base/Solana/Tempo;
pending Stripe activation, returns 503 until live -- see the Stablecoin / x402 section below).
## API Overview
- **Base URL**: https://www.getabrain.ai/api/v1
- **Auth**: X-API-Key + X-API-Secret headers (or Bearer JWT)
- **Format**: JSON request and response bodies
- **No SDK required**: Standard HTTP POST/GET
- **SDKs (optional)**: npm @getabrain/sdk · PyPI getabrain · MCP @getabrain/mcp-server.
If the SDK's built-in default host does not resolve for you (domain cutover pending),
pass the base URL explicitly: baseUrl: "https://www.getabrain.ai/api/v1" (Node) or
base_url="https://www.getabrain.ai/api/v1" (Python).
## MCP Server (Model
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"GetABrain.ai API","version":"v1","description":"Real human judgment as an API. Submit a query, receive structured JSON answers from quality-scored human workers."},"servers":[{"url":"https://www.getabrain.ai/api/v1"}],"security":[{"ApiKeyAuth":[],"ApiSecretAuth":[]},{"BearerAuth":[]}],"tags":[{"name":"Authentication"},{"name":"Keys"},{"name":"Queries"},{"name":"Billing"},{"name":"Stats"},{"name":"Webhooks"}],"paths":{"/requestor/auth/signup":{"post":{"tags":["