UPCitemdb API

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
5 active endpoints. Every call is 1 credit.Every parameter ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run 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

View docs ↗

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

1 credit1 required · 1 optional
POST/upcitemdb/v1/lookup
idle
// 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.

Try every endpoint in the playground

Endpoints

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 cr

    Barcode → the UPCitemdb product record.

    required
    barcode
    optional
    deep_weight
  • batch

    1 cr

    Up to 20 barcodes in one call → one UPCitemdb record per barcode, in input order, each with f…

    required
    barcodes
    optional
    deep_weight
  • search

    1 cr

    Free-text product search in UPCitemdb's keyword index → product cards (barcode, title, brand,…

    required
    query
    optional
    page, page_size
  • by_mpn

    1 cr

    Manufacturer part number or model → the UPCitemdb products carrying it, exact model/MPN match…

    required
    mpn
    optional
    page, page_size
  • validate

    1 cr

    Validate 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 it works

How the UPCitemdb API works

UPCitemdb is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

Call02
POST /upcitemdb/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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>.

01batch
POST/upcitemdb/v1/batch
{"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.

02lookup
POST/upcitemdb/v1/lookup
{"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.

03by_mpn
POST/upcitemdb/v1/by_mpn
{"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.

request
curl -X POST https://api.reefapi.com/upcitemdb/v1/lookup \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"barcode":"0885909950805"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "upcitemdb",
    "endpoint": "lookup",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat 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_countThe 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).
currencyUSD 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, asinThe 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_isbnFor 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_confidencePackage 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_variationsThe 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.

Coverage

What UPCitemdb returns, measured

Every number below was read through this API on 2026-11-21.

Electronics

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.

Books (ISBN)

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.

Part numbers

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.

Real customer barcodes

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.

Offer dates

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.

Weight

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.

Limits

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.

Use cases

What people build with UPCitemdb

The jobs this data is most often used for.

01

Turn a list of UPCs or EANs into titles, brands, models and images for a product catalogue, 20 per call.

02

See which retailers have listed a product and at what prices, with the date of each offer.

03

Find the barcodes behind a manufacturer part number to match supplier lists to retail listings.

04

Map barcodes to Amazon ASINs and book ISBNs to authors.

5

endpoints

1

credit per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
curl -X POST https://api.reefapi.com/upcitemdb/v1/lookup \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"barcode":"0885909950805"}'
python
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"])
FAQ

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.

Same key

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.