Headband Documentation
Documentation
Everything you need to integrate Headband
Headband is a retrieval control plane: one REST API across Meilisearch, Typesense, and Elasticsearch, with per-index engine routing. Start with Getting Started, or jump to a specific topic below.
Getting Started
What Headband is, core concepts, and how to get your first index searching in minutes.
Authentication
API key types, the bearer header, and what admin vs. search keys can do.
Indexes
Create, list, fetch, and delete indexes across Meilisearch, Typesense, and Elasticsearch.
Index Settings
Read and update per-index search settings and see what each engine supports.
Documents
Add, list, fetch, delete, and bulk-import documents into an index.
Search
Search endpoint parameters, filters, facets, sorting, and highlighting.
Multi-Search
Run multiple search queries against one or more indexes in a single request.
Tasks
Poll asynchronous write tasks by UID until they succeed or fail.
AI Search (RAG)
Retrieval-augmented search: the AI search endpoint and its response format.
Hybrid Search
Combine keyword and vector search in a single hybrid query.
Chat
Conversational search over your indexes, providers, and conversation state.
MCP Server
Set up the Headband MCP server and see the tools and resources it exposes.
llms.txt
Serve an llms.txt file describing your indexes for LLM crawlers.
Framework Recipes
Copyable integration recipes, sync connectors, A/B testing, and managed experiment rules.
React SDK
Install the React SDK, use the provider, hooks, and components, and see a full example.
Engine Compatibility
Feature-by-feature compatibility matrix and sizing guidance across engines.
Errors
Error response shape and status codes returned by the API.