# REST API endpoints

> Every public REST endpoint, including its exact inputs, outputs, and errors.

Canonical: https://www.listbulb.com/docs/api/endpoints
Last updated: 2026-11-22

## At a glance

All responses use the `{ data, meta }` envelope. GET endpoints are anonymous; creating a draft requires a personal API key and idempotency key.

## Endpoints

- [GET /api/v1/tools](https://www.listbulb.com/docs/api/endpoints/list-products) - List products: Search or browse public, live product listings.
- [GET /api/v1/tools/:slug](https://www.listbulb.com/docs/api/endpoints/get-product) - Get product: Read one public, live product by its stable listing slug.
- [GET /api/v1/categories](https://www.listbulb.com/docs/api/endpoints/list-categories) - List categories: List categories that currently contain live products.
- [GET /api/v1/tags](https://www.listbulb.com/docs/api/endpoints/list-tags) - List tags: List tags assigned to live products.
- [GET /api/v1/leaderboard](https://www.listbulb.com/docs/api/endpoints/weekly-leaderboard) - Weekly leaderboard: The weekly launch cohort in the same order, and with the same public bulb counts, as the home page and /launches.
- [GET /api/v1/recent](https://www.listbulb.com/docs/api/endpoints/recent-launches) - Recent launches: Recently launched live products, as shown on /recently-launched.
- [POST /api/v1/tools](https://www.listbulb.com/docs/api/endpoints/create-draft) - Create private draft: Create a private owner-bound product draft with a personal API key. Category can be omitted while drafting; choose one in the editor before selecting a plan or submitting.
