UPCitemdb products by UPC, EAN or ISBN: title, brand, model, images and retailer offers with prices
- endpoints
- 5
- credit per call
- 1
The UPCitemdb API returns products from UPCitemdb (upcitemdb.com) by UPC, EAN or ISBN barcode as JSON: title, brand, model and manufacturer part number (MPN), category path, description, colour and size, images, ASIN, author for books, package weight where UPCitemdb lists one, and the retailer offers UPCitemdb has recorded, each with merchant, price, currency and the date it was recorded, plus the lowest and highest price.
/upcitemdb/v1
- POST/upcitemdb/v1/lookup1 credit
- POST/upcitemdb/v1/batch1 credit
- POST/upcitemdb/v1/search1 credit
- POST/upcitemdb/v1/by_mpn1 credit
- POST/upcitemdb/v1/validate1 credit
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
UPCitemdb API
4 of 5 endpoints, ready to run
The UPCitemdb record behind one barcode: title, brand, model, MPN, category path, images, ASIN, author for books, and every retailer offer with price and date
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What UPCitemdb endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
lookup
1 crBarcode → the UPCitemdb product record.
- required
- barcode
- optional
- deep_weight
batch
1 crUp to 20 barcodes in one call → one UPCitemdb record per barcode, in input order, each with f…
- required
- barcodes
- optional
- deep_weight
search
1 crFree-text product search in UPCitemdb's keyword index → product cards (barcode, title, brand,…
- required
- query
- optional
- page, page_size
by_mpn
1 crManufacturer part number or model → the UPCitemdb products carrying it, exact model/MPN match…
- required
- mpn
- optional
- page, page_size
validate
1 crValidate and decode a barcode with no network call.
- required
- barcode
- optional
- —
Every parameter, every allowed value →
Missing a UPCitemdb endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the UPCitemdb API works
UPCitemdb is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a list of UPCs to titles, models and the prices retailers asked
Read up to 20 barcodes per call, then open the ones you need in full. Old POST /barcode/v1/... calls keep working unchanged; the call for UPCitemdb on its own is POST /upcitemdb/v1/<action>.
{"barcodes": ["0885909950805", "9780439023528"]}One record per barcode in input order with found and checked flags; a barcode UPCitemdb does not hold carries its decoded identifier instead. Only found barcodes are billed.
{"barcode": "0885909950805"}On 2026-11-21: Apple iPhone 6 64GB Space Gray, model and MPN MG5A2LL/A, ASIN B00NQGOZV0, category path, and 8 offers from 8 merchants (eBay, Newegg, Walmart Marketplace, Best Buy, Rakuten and others) from $64.99 to $749.99, each with the date UPCitemdb recorded it.
{"mpn": "910-005565"}The barcodes behind one part number: 5 products for the Logitech G502 Lightspeed, 3 of them exact model matches, each with its own UPC.
For each barcode: title, brand, model and MPN, colour and size, category path, images, ASIN, author for books, and the merchant, price, currency and date of every offer UPCitemdb lists, with the lowest and highest price.
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": { … },
"meta": {
"api": "upcitemdb",
"endpoint": "lookup",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a UPCitemdb field contains
Fields that read differently from how they look. Each row was measured through this API on 2026-11-21 unless it says otherwise.
| Field | What it holds |
|---|---|
| offers[] | Every retailer offer UPCitemdb lists: merchant, offer title, price, currency and updated_t, the date UPCitemdb recorded it. The iPhone 6 offers ran from 2015-06-15 to 2026-11-12; 6 of 28 book offers were from November 2026. Link, stock and shipping were empty on all 36 offers checked. |
| price_lowest, price_highest, store_count | The lowest and highest offer price and the number of stores, over every recorded offer whatever its date (iPhone 6: $64.99 from a 2022 offer, $749.99 from a 2015 offer, 8 stores). |
| currency | USD on 29 of 36 offers. The 7 without a currency were UK and Canadian stores (eBay UK, OnBuy, Wordery, Alibris UK, Indigo), so do not assume USD when it is empty. |
| model, mpn, asin | The manufacturer model and part number (MG5A2LL/A) and the Amazon ASIN UPCitemdb links to the barcode (B00NQGOZV0). For a book the ASIN is the ISBN-10 (0439023521). |
| author, is_isbn | For a 978/979 barcode is_isbn is true, issuing_country is "ISBN (Bookland — books)" and author is filled when UPCitemdb has it (Suzanne Collins). |
| weight, weight_unit, weight_confidence | Package weight as a number and a unit (g, kg, oz or lb), with weight_grams. Measured 2026-08-07 on 61 retailer-sourced barcodes: present on 19.7% by default, 29.5% with deep_weight=true. UPCitemdb prints unit and case weights under the same label; weight_confidence is low when the weight cannot match the declared size. Absent weight is null, never 0. |
| exact_match (by_mpn) | true when the product's model or MPN equals the part number you sent. 910-005565: 5 products, 3 exact; the others carry it inside a longer model string ("G502 910-005565", "910-005565-cr"). |
| name_variations | The other titles retailers used for the same barcode, which helps matching a product across shops. |
A barcode UPCitemdb does not hold answers NOT_FOUND with the decoded barcode (GTIN type, check digit, GS1 prefix, issuing country) in error.detail, so a mistyped code is told apart from a valid one nobody lists.
What UPCitemdb returns, measured
Every number below was read through this API on 2026-11-21.
0885909950805 returned Apple iPhone 6 64GB Space Gray in 1.6 seconds: brand, model and MPN MG5A2LL/A, colour, size, category path (Electronics > Communications > Telephony > Mobile Phones), image, ASIN, 8 retailer offers, lowest $64.99, highest $749.99.
9780439023528 returned The Hunger Games (Paperback), author Suzanne Collins, ASIN 0439023521, 28 offers from booksellers and retailers (Alibris, Target, Books-A-Million, eCampus and others) from $1.31 to $18.59, in 1.2 seconds.
by_mpn 910-005565 returned 5 products with 5 different barcodes for the same Logitech mouse, 3 marked exact_match. UPCitemdb counted 10 matches for the part number.
Of 10 barcodes sent by a customer (US cosmetics and apparel, Chinese and Spanish goods), 3 were found, among them a MILK MAKEUP blush set ($34 at Kohl's) and a Superbad T-shirt ($15 to $29.99 at Target). Of 20 Japanese and German office-supply barcodes, 3 were found. Each miss returned the decoded barcode instead.
Every offer carries the date UPCitemdb last recorded it. The iPhone 6 offers ran from 2015-06-15 to 2026-11-12; 6 of the 28 book offers were from November 2026. These are recorded prices, not a live price check.
Package weight comes as weight + weight_unit with weight_grams and a weight_confidence flag. Measured 2026-08-07 on 61 retailer-sourced barcodes: weight present on 19.7% by default and 29.5% with deep_weight. UPCitemdb lists unit and case weights under the same label, so read weight_confidence. Neither product above had a weight.
Offers come mostly from US retailers in USD: 29 of the 36 offers above were in USD, and the 7 without a currency were UK and Canadian stores (eBay UK, OnBuy, Wordery, Alibris UK, Indigo). Offer links, stock and shipping were empty on all 36. An offer title can describe an accessory rather than the product (a screen protector among the iPhone offers). No nutrition data: for food use the open-food-facts API.
What people build with UPCitemdb
The jobs this data is most often used for.
Turn a list of UPCs or EANs into titles, brands, models and images for a product catalogue, 20 per call.
See which retailers have listed a product and at what prices, with the date of each offer.
Find the barcodes behind a manufacturer part number to match supplier lists to retail listings.
Map barcodes to Amazon ASINs and book ISBNs to authors.
endpoints
credit per call
What UPCitemdb data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 746 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/upcitemdb/v1/lookup \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"barcode":"0885909950805"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/upcitemdb/v1/lookup",
headers={"x-api-key": REEF_KEY},
json={
"barcode": "0885909950805"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up UPCitemdb.
Is there a UPCitemdb API?▾
Yes. The upcitemdb API on ReefAPI returns UPCitemdb products by UPC, EAN or ISBN as JSON: title, brand, model, MPN, images, ASIN, book author and the retailer offers with price and date, plus MPN and keyword search, 20 barcodes per batch call. The call is POST /upcitemdb/v1/<action>; old POST /barcode/v1/... calls keep working unchanged.
Does it return retailer prices for a UPC?▾
Yes, the offers UPCitemdb has recorded: merchant, price, currency and the date of each, with the lowest and highest price. The iPhone 6 (0885909950805) had 8 offers from $64.99 to $749.99 on 2026-11-21. These are recorded prices with their dates, not a live check of each shop.
Does it work for books and ISBNs?▾
Yes. ISBN 9780439023528 returned The Hunger Games (Paperback), author Suzanne Collins, ASIN 0439023521 and 28 offers from $1.31 to $18.59 on 2026-11-21.
Can I find barcodes from a manufacturer part number?▾
Yes, with by_mpn. Logitech part 910-005565 returned 5 products, each with its own barcode, 3 of them exact model matches, exact matches first.
How many barcodes does it find?▾
It depends on the product kind. On 2026-11-21, 3 of 10 real customer barcodes (US cosmetics and apparel, Chinese and Spanish goods) were found, and 3 of 20 Japanese and German office-supply barcodes. UPCitemdb is strongest on goods sold in the United States.
Does it return the product weight?▾
When UPCitemdb lists one, as weight + weight_unit with weight_grams and weight_confidence. Measured 2026-08-07 on 61 retailer-sourced barcodes: 19.7% had a weight by default and 29.5% with deep_weight=true, which spends one extra call per barcode.
Can I look up many barcodes at once?▾
Yes. batch takes up to 20 barcodes per call and returns one row per barcode in input order, each with found and checked flags. Only barcodes that are found are billed.
Does it return nutrition for food barcodes?▾
No. UPCitemdb carries commerce data (title, brand, offers). For nutrition, Nutri-Score and allergens by barcode use the open-food-facts API.
What is the UPCitemdb API?▾
UPCitemdb API is a ReefAPI endpoint group for 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. It returns live JSON through POST requests under /upcitemdb/v1.
Is the UPCitemdb API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. UPCitemdb calls use the same shared credit balance as every other ReefAPI engine.
Do I need an UPCitemdb login or account?▾
No login to UPCitemdb is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the UPCitemdb data?▾
The page example is captured from a live lookup call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the UPCitemdb API use?▾
UPCitemdb actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call UPCitemdb from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call upcitemdb actions with the same key, credit pool and JSON envelope used by normal REST requests.
19 Utilities & AI APIs on the same key
One key, one credit pool, one response envelope. If you are pulling UPCitemdb, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-21.