Open Food Facts
Food products by barcode from Open Food Facts: nutrition per 100 g, Nutri-Score, NOVA, Eco-Score, ingredients, allergens, images, plus brand and keyword search.
/open-food-facts/v1/lookup1 creditBarcode → the Open Food Facts product record: name, brand, category, images, net content (quantity), nutrition per 100 g (energy, fat, sugars, salt …), Nutri-Score, NOVA group, Eco-Score, ingredients and allergens, with check-digit validation, GTIN-13 normalisation and the GS1 issuing country decoded from the code. off_db picks Open Food, Beauty, Pet Food or Products Facts; with food it falls back to Products Facts. A barcode Open Food Facts does not hold answers NOT_FOUND with the decoded code in error.detail.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| barcode | required | — | The barcode to look up: UPC-A (12), EAN-13 (13), EAN-8 (8), GTIN-14, or ISBN-13 (978/979…). Spaces/dashes are stripped; check digit is validated (mod-10). Aliases: upc, ean, gtin, isbn, code. |
| off_db = food | optional | food · beauty · petfood · products | Which Open Facts database to read: food (default), beauty, petfood or products. lookup also tries Open Products Facts when the food database has no record. |
/open-food-facts/v1/batch1 creditUp to 20 barcodes in one call → one Open Food Facts record per barcode, in input order, each with found/checked flags; a barcode with no record carries its decoded identifier instead. Billed per barcode found.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| barcodes | required | — | Up to 20 barcodes — a JSON array or a comma-separated string (competitor caps batch at 10; we allow 20). Each is normalized + validated; results preserve input order with per-item source. |
| off_db = food | optional | food · beauty · petfood · products | Which Open Facts database to read: food (default), beauty, petfood or products. lookup also tries Open Products Facts when the food database has no record. |
/open-food-facts/v1/search1 creditFree-text product search in Open Food Facts → product cards (barcode, name, brand, category, image, Nutri-Score) with pagination; optional category tag.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Free-text product-name search in Open Food Facts (relevance-ranked by Open Food Facts' own search service). Aliases: q, search, name, title. |
| category | optional | — | Optional Open-Food-Facts category tag to scope a search/brand query (e.g. 'sodas', 'chocolate-spreads', 'biscuits'). |
| off_db = food | optional | food · beauty · petfood · products | Which Open Facts database to read: food (default), beauty, petfood or products. lookup also tries Open Products Facts when the food database has no record. |
| page = 1 | optional | 1–1000 | 1-based page number (clamped 1-1000). Page forward with meta.next_page. Note: Open Food Facts throttles deep pages, so a deep page may take an extra moment while the engine retries. |
| page_size = 20 | optional | 1–50 | Results per page (1-50, default 20); out-of-range values are clamped. |
/open-food-facts/v1/by_brand1 creditEvery Open Food Facts product of a brand → product cards with pagination; optional category tag.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| brand | required | — | Brand or manufacturer name → that brand's products. Aliases: manufacturer, brand_name. |
| category | optional | — | Optional Open-Food-Facts category tag to scope a search/brand query (e.g. 'sodas', 'chocolate-spreads', 'biscuits'). |
| off_db = food | optional | food · beauty · petfood · products | Which Open Facts database to read: food (default), beauty, petfood or products. lookup also tries Open Products Facts when the food database has no record. |
| page = 1 | optional | 1–1000 | 1-based page number (clamped 1-1000). Page forward with meta.next_page. Note: Open Food Facts throttles deep pages, so a deep page may take an extra moment while the engine retries. |
| page_size = 20 | optional | 1–50 | Results per page (1-50, default 20); out-of-range values are clamped. |
/open-food-facts/v1/by_prefix1 creditGS1 company prefix (the first 6+ digits of a barcode) → the Open Food Facts products whose barcode starts with it, plus the decoded issuing country and prefix basis.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| prefix | required | — | A GS1 company prefix — the first 6+ digits of a barcode (the competitor's `491234*` partial-barcode method). Returns products whose barcode starts with these digits + the decoded issuing country. |
| off_db = food | optional | food · beauty · petfood · products | Which Open Facts database to read: food (default), beauty, petfood or products. lookup also tries Open Products Facts when the food database has no record. |
| page = 1 | optional | 1–1000 | 1-based page number (clamped 1-1000). Page forward with meta.next_page. Note: Open Food Facts throttles deep pages, so a deep page may take an extra moment while the engine retries. |
| page_size = 20 | optional | 1–50 | Results per page (1-50, default 20); out-of-range values are clamped. |
/open-food-facts/v1/validate1 creditValidate and decode a barcode with no network call: mod-10 check digit, GTIN type, GTIN-13 form, GS1 issuing country, ISBN detection.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| barcode | required | — | The barcode to look up: UPC-A (12), EAN-13 (13), EAN-8 (8), GTIN-14, or ISBN-13 (978/979…). Spaces/dashes are stripped; check digit is validated (mod-10). Aliases: upc, ean, gtin, isbn, code. |
curl -X POST https://api.reefapi.com/open-food-facts/v1/lookup \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"barcode":"3017620422003"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.