# Read API

> A free, read-only API for the Slotboard launch board: launches, weeks, platforms and categories, as JSON. No key needed for light use.

Canonical: https://slotboard.best/developers/api
Last updated: 2026-10-26

A free, read-only API for the Slotboard launch board. Use it to show launches on your own site, to build a tool, or to let an AI agent answer questions about them.

## Try it in one request

```
curl https://slotboard.best/v1/launches?week=current
```

The response is JSON. Each launch has its rank, its page, its badge, its votes and its clicks.

## Endpoints

| Method and path | What it returns |
| --- | --- |
| GET /v1/launches | This week's ranked launches. Filter with week, category, platform and limit. |
| GET /v1/launches/{slug} | One launch, with its rank in its week. |
| GET /v1/weeks | Every launch week, newest first, with its top three. |
| GET /v1/weeks/{key} | One week and its ranked launches. |
| GET /v1/platforms | The platforms, with how many launches each has this week. |
| GET /v1/platforms/{slug} | One platform: its ranked launches this week, and how many have ever listed there. |
| GET /v1/categories | The categories a launch can be in. |
| POST /v1/mcp | The MCP endpoint for AI assistants. See the [MCP page](https://slotboard.best/developers/mcp). |

The full description is in the [OpenAPI document](https://slotboard.best/v1/openapi.json).

## Your key

Requests without a key are limited to 120 a minute per IP address. For more, make a key on this page and send it in the Authorization header:

```
curl -H "Authorization: Bearer sb_live_your_key" https://slotboard.best/v1/launches
```

Keys are personal. Only a hash of each key is stored, so a lost key cannot be shown again. Revoke it and make a new one.

## Limits

| Who | Limit | What happens over it |
| --- | --- | --- |
| No key | 120 requests a minute per IP address | 429, with Retry-After in seconds |
| One key | 600 requests a minute | 429, with Retry-After |
| One key | 20,000 requests a day, counted in UTC | 429 until midnight UTC |
| One maker | 5 active keys | Revoke one before you make another |

Every response tells you where you stand: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Day-Limit and X-RateLimit-Day-Remaining. The per-minute count is kept per server, so it is approximate. Stay well under it.

## Errors

Errors use the problem format (RFC 9457): a type, a title, a status and a detail line. Read the detail first.

```
{ "title": "Bad platform", "status": 400, "detail": "platform is one of: web-apps, mac-apps, ..." }
```

## What you cannot use the API for

The API is for reading the board. These uses are not allowed, with or without a key:

- Republishing the whole board as your own list, or copying it to build a competing ranking.
- Presenting our ranks, votes, clicks or launch numbers as your own numbers.
- Buying, selling, trading or asking for votes, clicks, follows or reviews.
- Trying to change a vote, a rank or a launch. The API is read-only, and writes are refused.
- Sending spam, or scraping pages to collect personal data about makers or visitors.
- Sharing a key, or putting it in public code. If a key leaks, revoke it.
- Getting around a limit with more keys, more IP addresses or fake accounts.
- Presenting an answer from the API as an official Slotboard statement, unless you have checked it against the launch page.
- Anything illegal, or anything meant to harm people.

We can revoke a key that breaks these rules, without notice. Our terms are at [terms](https://slotboard.best/terms).
