The playground

Try any of 817 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com
post/barcode/v1/search1 credit

Free-text product-name search across the open databases → product cards with pagination. Optional category scope. (Competitor: keyword/title/category search.)

Working example
Parameters

Free-text product-name keyword search (matches title across the open databases). Aliases: q, search, name, title.

Optional Open-Food-Facts category tag to scope a search/brand query (e.g. 'sodas', 'chocolate-spreads', 'biscuits').

Which Open-*-Facts sibling DB to search/lookup against when source=off. lookup auto-falls-back food→products when source=auto.

Which open source(s) to query for lookup/batch. 'auto' merges both.

1-based page number (clamped 1-1000). Page forward with meta.next_page. Note: Open Food Facts throttles deep pages per-IP; the engine retries on a fresh proxy. (1–1000)

Results per page (1-50, default 20); out-of-range values are clamped. (1–50)

request preview
curl -X POST https://api.reefapi.com/barcode/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"nutella"}'

Hit Send to run this endpoint live.