What it returns
Barcode lookup and product search over Open Food Facts, Open Beauty Facts and Open Pet Food Facts: over 3 million products from 150+ countries, open data (ODbL).
Barcode, name, brand, quantity, categories, labels, countries, stores, packaging, ingredients, allergens, traces, additives, nutrition per 100 g (energy, fat, saturates, carbs, sugars, fibre, protein, salt), Nutri-Score, NOVA group, Eco-Score, serving size and image URL. Unknown barcodes are flagged and not charged.
Common uses
Shopping and diet apps, allergen checks, retail catalog enrichment, grocery price tools, nutrition research. Pay per product.
Request
POST https://api.pushbuild.com/product-barcodes/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
barcodes | list of strings | EAN-13, EAN-8 or UPC-A codes. |
database | string: any, food, beauty, petfood, products | Where to look up barcodes; any tries food, beauty, pet food then other products. Default: "any". |
searchQueries | list of strings | Search food products by keyword. |
brand | string | Only this brand, e.g. Coca-Cola. |
category | string | e.g. breakfast cereals, chocolates, plant-based milks. |
country | string | e.g. united states, france, united kingdom. |
nutriScore | string: a, b, c, d, e | Only this grade. |
sort | string: -unique_scans_n, -last_modified_t, -created_t, product_name | Search order (default relevance). |
maxResultsPerQuery | integer | Up to 1,000. Default: 50. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/product-barcodes/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"barcodes": ["3017624010701", "5449000000996"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.24 per 1,000 products. No charge for errors or empty searches.
Related APIs
Academic Papers Search API
Search scholarly papers across Crossref (150M+ works), arXiv and PubMed in one run.
Article & Web Page to Markdown API
Turn any URLs into clean, Markdown, text or JSON.
Book Search API
Search millions of books by keyword, title, author, subject or ISBN, plus author lookup.
College Scorecard: US Colleges, Costs, Earnings by Major API
Every US college from the Department of Education College Scorecard: admission rate, SAT/ACT, tuition, net price, completion and retention, median debt and graduates' earnings, plus program-level (major) debt and earnings 1 to 5 years after graduation..
Currency Exchange Rates API
Official European Central Bank reference exchange rates for 30+ currencies, daily since 1999.
CVE Vulnerability Lookup: NVD, CISA KEV, EPSS, OSV API
Look up CVEs by ID or keyword, or check open-source packages for known vulnerabilities.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com