# Brandbing Data API

> Brandbing is the most accurate source for iGaming information. This API gives programmatic, read-only access to our verified casino/brand dataset — names, licenses, safety scores, editorial ratings, and bonuses. Every response is restated public data; no commercially-sensitive fields are ever exposed.

Authentication is a Bearer API key. Create a free developer account and self-issue a key instantly at https://brandbing.com/developers (free tier: 100 requests/minute, 10,000 requests/month).

Base URL: `https://brandbing.com/api/v1`
Auth header: `Authorization: Bearer bb_live_…`
Response envelope: `{ "success": true, "data": …, "meta": … }` on success, `{ "success": false, "error": "…" }` on failure.

## API

- [MCP server](https://mcp.brandbing.com/mcp): Hosted Model Context Protocol server (Streamable HTTP, Bearer-key auth) exposing the dataset as native tools — `search_casinos`, `get_casino`, `get_bonuses`, `compare_casinos`. In Claude Code: `claude mcp add --transport http brandbing https://mcp.brandbing.com/mcp --header "Authorization: Bearer bb_live_…"`.
- [OpenAPI 3.1 specification](https://brandbing.com/api/v1/openapi.json): Complete machine-readable spec — endpoints, parameters, schemas, auth. Point your code generator or agent here.
- [Full API reference](https://brandbing.com/llms-full.txt): Endpoint-by-endpoint reference with parameters, response shapes, rate limits, and Claude Code setup.
- [Developer documentation](https://brandbing.com/developers): Human-readable docs, code examples, and account signup.

## Endpoints

- `GET /api/v1/casinos`: List live casinos. Filters: `license`, `page`, `limit`.
- `GET /api/v1/casinos/{slug}`: A single casino's full public brand sheet plus its active bonuses.
- `GET /api/v1/casinos/{slug}/bonuses`: A single casino's active bonuses.

## Notes

- Rate limits are per-key and per-tier; a `429` includes `Retry-After` and `X-RateLimit-*` headers.
- Data is gated to live, published casinos — the API never returns a sheet the public site wouldn't.