GetABrain.ai

GetABrain.ai API Documentation

Welcome to the GetABrain.ai API documentation. Our REST API allows AI applications to collect real-time human feedback, ratings, comparisons, and text responses. Integrate human intelligence into your AI pipeline with a few lines of code.

Quick Start

  1. 1

    Sign Up

    Create a requestor account at /requestor/signup

  2. 2

    Get API Key

    Your api_key and api_secret are returned upon signup.

  3. 3

    Try It Free, Then Fund

    Mint a test-mode key ({"mode":"test"}) for free simulated answers with no billing. Add balance (card or USDC) only when you want real humans on a live key.

  4. 4

    POST Your First Query

    Send a POST /api/v1/queries request with your question.

  5. 5

    Receive Responses

    Poll GET /requestor/queries/:id (or list queries) to retrieve responses as workers answer.

Explore the Docs

API Reference (interactive)

Explore and try every endpoint live in the browser — powered by Scalar, pointed at the canonical OpenAPI contract.

Quick Start Guide

Go from zero to your first human response in 5 minutes — with code examples in cURL, Python, and Node.js.

Getting Started

Create an account, get your API key, and send your first query in minutes.

Authentication

Learn about API key authentication and JWT-based session auth.

Query Types

Explore all 16 query types: text, multiple choice, rating, image analysis, A/B test, and more.

API Endpoints

Full reference for creating, listing, and managing queries and responses.