UPCitemdb
Products by UPC, EAN or ISBN from UPCitemdb: title, brand, model, MPN, images, ASIN, book author and the retailer offers it recorded, with price and date.
/upcitemdb/v1/lookup1 creditBarcode → the UPCitemdb product record: title, brand, model and MPN, category, description, images, colour/size, package weight as an explicit {weight, weight_unit} pair (with weight_grams, weight_source and a weight_confidence flag), ASIN, author for books, and the retailer offers UPCitemdb lists (merchant, price, updated date) with the lowest and highest price; plus check-digit validation, GTIN-13 normalisation and the GS1 issuing country. A barcode UPCitemdb 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. |
| deep_weight = false | optional | — | Spend ONE extra UPCitemdb call per barcode to read the weight from UPCitemdb's JSON row when the product page printed none. Measured on 61 retailer-sourced barcodes: weight coverage 19.7% off (default, 1 call) → 29.5% on (2 calls). Read weight_confidence before trusting it. |
/upcitemdb/v1/batch1 creditUp to 20 barcodes in one call → one UPCitemdb 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. |
| deep_weight = false | optional | — | Spend ONE extra UPCitemdb call per barcode to read the weight from UPCitemdb's JSON row when the product page printed none. Measured on 61 retailer-sourced barcodes: weight coverage 19.7% off (default, 1 call) → 29.5% on (2 calls). Read weight_confidence before trusting it. |
/upcitemdb/v1/search1 creditFree-text product search in UPCitemdb's keyword index → product cards (barcode, title, brand, model, category, image) with pagination.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Free-text product search in UPCitemdb's keyword index (title, brand, model). Aliases: q, search, name, title. |
| 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. |
/upcitemdb/v1/by_mpn1 creditManufacturer part number or model → the UPCitemdb products carrying it, exact model/MPN matches first (each row says matched_mpn and exact_match).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| mpn | required | — | Manufacturer Part Number / model number → matching products. Aliases: model, model_number, part_number. Results whose model/mpn field equals the query are surfaced first (exact_match=true). |
| 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. |
/upcitemdb/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/upcitemdb/v1/lookup \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"barcode":"0885909950805"}'{
"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.