Docs

API reference

Food brands

GET /v1/brands/search

Search brands or list foods for a brand.

Markdown Full spec OpenAPI

Stable brand records (fds_fb_…) for USDA branded foods. Same idea as authors: do not scan brand_owner text on every product.

MCP: search_brands

GET /v1/brands/popular?limit=24

Same shape as GET /v1/authors/popular: { results: [...] }, ordered by product count.

GET /v1/brands/search?q=tillamook
Query Notes
q yes. Name or prefix
limit Default 20, max 50

Get a brand

GET /v1/brands/{id}

Foods for a brand

GET /v1/brands/{id}/foods?limit=20

Returns food objects. Ids are fds_fb_ + hash20(brand: + normalized owner|name).