# UPCitemdb API: Get product by barcode

> Identifies a product by its 12- or 13-digit barcode and returns its details, recorded price range and store offers from UPCitemdb.

Unofficial. Not affiliated with or endorsed by UPCitemdb.

- Page: https://fous.com/methods/upcitemdb.com/get-product-by-barcode
- Method: `upcitemdb.com/get_product_by_barcode`, version 1
- Website: upcitemdb.com
- Returns: product name, brand, model, UPC/EAN, category, images, lowest and highest price, store offers
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `barcode` | string | yes | `"012000161155"` | The 12- or 13-digit number printed under the barcode, with optional spaces or dashes; for example 012000161155. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "barcode": "012000161155"
}
```

Its output:

```json
{
  "ean": "0012000161155",
  "upc": "012000161155",
  "size": null,
  "brand": "LIFEWTR",
  "model": "012000161155",
  "colour": "Clear",
  "offers": [
    {
      "price_usd": 3.59,
      "offer_link": "https://www.upcitemdb.com/norob.php?id=x2x253t213537454t2&tid=1&seq=1792748049&plt=4ef5f0f7c66d297903ab587779e8aeb9",
      "store_name": "Walgreens",
      "last_updated_date": "2026-10-18"
    },
    {
      "price_usd": 1.48,
      "offer_link": "https://www.upcitemdb.com/norob.php?id=v2r253t2x213b444u2&tid=1&seq=1792748049&plt=ad8b18f1424e2e71aa72834a8eb4c73c",
      "store_name": "Frys Electronics",
      "last_updated_date": "2018-06-21"
    },
    {
      "price_usd": 1.49,
      "offer_link": "https://www.upcitemdb.com/norob.php?id=x2s263w2y2339464q2&tid=1&seq=1792748049&plt=09846e02f6386b57fbef0eaa5d247948",
      "store_name": "Target",
      "last_updated_date": "2020-09-21"
    }
  ],
  "weight": "1.00lb",
  "category": "Food, Beverages & Tobacco > Beverages > Water",
  "page_link": "https://www.upcitemdb.com/upc/012000161155",
  "description": "LIFEWTR Premium Purified Bottled Water  pH Balanced with Electrolytes For Taste",
  "image_links": [
    "https://i5.walmartimages.com/asr/b29c7d39-72ae-464d-8bb3-1a89fbda40d6.102cd8b37ec485c62739a1f933389b1b.jpeg?odnHeight=450&odnWidth=450&odnBg=ffffff",
    "https://target.scene7.com/is/image/Target/GUEST_46ff2a61-1d87-4887-8a8c-d284dc77bdb1?wid=1000&hei=1000",
    "https://pics.walgreens.com/prodimg/595160/450.jpg"
  ],
  "product_name": "LIFEWTR Premium Purified Bottled Water  pH Balanced with Electrolytes For Taste",
  "lowest_price_usd": 1.48,
  "highest_price_usd": 96
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"upcitemdb.com/get_product_by_barcode","input":{"barcode":"012000161155"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What product is barcode 012000161155 and what's its typical price range?
- Look up the item with UPC 036000291452 and show me the store offers.
- Can you identify the product behind the EAN 5012345678900 and tell me its brand and category?
- I found a 13-digit code 4006381333931 on a box; what is this product and where can I buy it cheapest?
- Check upcitemdb for barcode 0 49000 00276 4 and give me the product images and lowest and highest recorded prices.

## Input schema

```json
{
  "type": "object",
  "required": [
    "barcode"
  ],
  "properties": {
    "barcode": {
      "type": "string",
      "description": "The 12- or 13-digit number printed under the barcode, with optional spaces or dashes; for example 012000161155."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "product_name",
    "brand",
    "model",
    "description",
    "category",
    "upc",
    "ean",
    "colour",
    "size",
    "weight",
    "image_links",
    "lowest_price_usd",
    "highest_price_usd",
    "offers",
    "page_link"
  ],
  "properties": {
    "ean": {
      "type": [
        "string",
        "null"
      ]
    },
    "upc": {
      "type": [
        "string",
        "null"
      ]
    },
    "size": {
      "type": [
        "string",
        "null"
      ]
    },
    "brand": {
      "type": [
        "string",
        "null"
      ]
    },
    "model": {
      "type": [
        "string",
        "null"
      ]
    },
    "colour": {
      "type": [
        "string",
        "null"
      ]
    },
    "offers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "store_name",
          "price_usd",
          "last_updated_date",
          "offer_link"
        ],
        "properties": {
          "price_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "offer_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "store_name": {
            "type": "string"
          },
          "last_updated_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          }
        },
        "additionalProperties": false
      }
    },
    "weight": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "page_link": {
      "type": "string"
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "image_links": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "product_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "lowest_price_usd": {
      "type": [
        "number",
        "null"
      ]
    },
    "highest_price_usd": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [Open Food Facts API: Get packaged food product](https://fous.com/methods/openfoodfacts.org/get-product.md): Looks up a packaged food by barcode or by product name and brand, returning ingredients, allergens, Nutri-Score, NOVA processing level and nutrition from Open Food Facts.
- [Ulta Beauty API: Get product](https://fous.com/methods/ulta.com/get-product.md): Looks up one Ulta Beauty product by name or product link and returns its details, prices, sizes or shades, ingredients, directions, ratings and images. Prices and availability may change.
- [Walmart API: Get product](https://fous.com/methods/walmart.com/get-product.md): Gets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
- [bhphotovideo.com API: Get B&H Photo product](https://fous.com/methods/bhphotovideo.com/get-product.md): Gets a B&H Photo product's details by name, product link, or B&H number. A name uses the best matching search result; details and prices reflect the public page.
- [IKEA API: Search products](https://fous.com/methods/ikea.com/search-products.md): Searches IKEA products in a chosen country and returns current prices, details, photos and reviews in IKEA's result order.
- [Zara API: Get product](https://fous.com/methods/zara.com/get-product.md): Gets a Zara item's price, colours, sizes with availability, materials and images by item name or Zara item link in a chosen country. A name returns the closest match from Zara's search.
- [Lowe's API: Get product details](https://fous.com/methods/lowes.com/get-product.md): Finds a Lowe's product by name, item number or product link and returns its details, price, specifications, images and availability at the nearest store for a ZIP code (or the site's default store).
- [Instacart API: Search store products](https://fous.com/methods/instacart.com/search-products.md): Searches a named Instacart store's guest-visible grocery products for a US ZIP code. Prices are in USD and can differ from in-store prices; stock estimates can change.
