# API reference

The full, always-current reference is generated from the OpenAPI spec.

- **Interactive reference and playground**: [/dev](/dev/). Pick an endpoint, fill a form, send a live request, and copy the code.
- **API explorer (Swagger)**: [/swagger](/swagger)
- **Redoc**: [/redoc](/redoc)
- **Raw spec**: [/openapi.json](/openapi.json). Use it to generate a client or a connector.

## Endpoints at a glance

**Discover**

| Method and path | Purpose |
|---|---|
| `GET /v1/search` | Ranked cross-brand product cards. |
| `GET /v1/suggest` | Typeahead suggestions. |
| `GET /v1/browse` | Faceted grid for a category or brand. |
| `GET /v1/recommend` | Related or cross-brand products. |
| `GET /v1/brands` | List brands. |
| `GET /v1/brands/{slug}` | One brand. |
| `GET /v1/brands/{slug}/products` | A brand's catalogue. |
| `GET /v1/categories` | The category tree. |

**Understand**

| Method and path | Purpose |
|---|---|
| `GET /v1/products/{id}` | Full product detail. |
| `GET /v1/products/{id}/reviews` | Paged reviews. |

**Price (live)**

| Method and path | Purpose |
|---|---|
| `GET /v1/products/{id}/price` | Exact live price and stock. |
| `POST /v1/prices` | Batch live price for up to twenty products. |
| `GET /v1/coupons` | Working discount codes for a brand or product. |

**Platform**

| Method and path | Purpose |
|---|---|
| `GET /v1/plans` | The access policy: free tier plus key-based limits. |
| `GET /v1/quota` | The rate limit and your usage. |
| `GET /v1/stats` | Catalogue totals. |

**Agents**

| Method and path | Purpose |
|---|---|
| `POST /v1/mcp` | The MCP server (JSON-RPC 2.0). |

## Next steps

- [MCP and connectors](#/mcp): the agent surface.
- [Get started](#/get-started): the five minute path.