# Vibecade Public API

Vibecade exposes a small read-only public API surface for discovery, arcade browsing, and model availability.

## Discovery Links

- [API catalog](https://vibecade.com/.well-known/api-catalog)
- [OpenAPI schema](https://vibecade.com/openapi/public-api.json)
- [API status](https://vibecade.com/api/status)
- [Main llms entrypoint](https://vibecade.com/llms.txt)

## Public Endpoints

### GET /api/games

List public arcade games.

Query parameters:

- `page`: page number, default `1`
- `limit`: items per page, default `24`, max `48`
- `search`: optional text search on public game names
- `sort`: `recent` or `popular`

### GET /api/games/{slug}

Return public details for one published game.

Response notes:

- `canonicalSlug` provides the canonical slug when redirects are needed
- `needsRedirect` indicates whether the client should move to that canonical slug

### GET /api/models

Return Vibecade's public model catalog and signed-out availability state.

This response is intended for discovery and UI population, not for billing decisions.

### GET /api/status

Return discovery pointers for the public API surface.

## Auth and Usage Policy

- These endpoints are public and read-only.
- Search indexing is allowed.
- Real-time agent input and retrieval use is allowed.
- AI training reuse is not allowed.