# List products

> Search or browse public, live product listings.

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

`GET /api/v1/tools`

## Parameters

| Name | Location | Required | Detail |
| --- | --- | --- | --- |
| `cursor` | Query | Optional | A previous response’s pagination.nextCursor; up to 256 characters. |
| `q` | Query | Optional | Trimmed free-text search; 2–100 characters. |
| `category` | Query | Optional | Trimmed category slug or name; 1–80 characters. |
| `tag` | Query | Optional | Trimmed tag slug or name; 1–80 characters. |
| `limit` | Query | Optional | Integer from 1–25. Defaults to 10. |

## Example

```bash
curl "https://www.listbulb.com/api/v1/tools?q=notes&category=productivity&limit=10"
```

## Returns

`200 { data: { items, pagination: { nextCursor, hasMore, totalCount } }, meta }.`

## Errors

- `400 INVALID_QUERY`
- `429 RATE_LIMITED`

## Related
- [All REST API endpoints](https://www.listbulb.com/docs/api/endpoints)
