API Documentation

Authorization: Bearer YOUR_API_KEY

# or

X-API-Key: YOUR_API_KEY

curl "https://barcodereport.com/api/search_barcode?barcode=747062088118" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "barcode": "747062088118",
  "title": "Replacement for UL2354 BATTERY UL2354 Replacement Battery",
  "brand": "CHOSEN SUPPLIES",
  "category": "Electronics > Electronics Accessories > Power > Batteries",
  "description": "Manufacturer: CHOSEN SUPPLIES.",
  "image_url": "https://example.com/images/747062088118.jpg",
  "min_price": "43.19",
  "price_currency": "USD",
  "old_barcode": null,
  "authors": null,
  "number_of_pages": null,
  "publish_date": null,
  "isbn": null,
  "ean_13": null,
  "upc_a": null,
  "gtin_14": null,
  "model_number": null,
  "color": null,
  "size": null,
  "weight": null,
  "product_dimension": null,
  "amazon_asin": null
}

curl -X POST "https://barcodereport.com/api/v1/lookup" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"barcodes": ["049000050103", "3017620422003", "860999888771"]}'

{
    "count": 3,
    "found": 2,
    "results": [
        {
            "requested_barcode": "049000050103",
            "found": true,
            "product": {
                "barcode": "049000050103",
                "title": "Coca-cola bottle, 2 liters",
                "brand": "Coca-Cola",
                "…": "…"
            }
        },
        {
            "requested_barcode": "3017620422003",
            "found": true,
            "product": {
                "barcode": "3017620422003",
                "title": "Nutella Ferrero Hazelnut Chocolate Spread 400g",
                "…": "…"
            }
        },
        {
            "requested_barcode": "860999888771",
            "found": false,
            "product": null
        }
    ]
}

{
    "query": "nutella",
    "page": 1,
    "per_page": 20,
    "has_more": true,
    "results": [
        {
            "barcode": "3017620422003",
            "title": "Nutella Ferrero Hazelnut Chocolate Spread 400g",
            "brand": "Ferrero",
            "category": "Food, Beverages & Tobacco",
            "image_url": "…"
        }
    ]
}

{
  "name": "Jane Doe",
  "email": "[email protected]",
  "plan_name": "Standard Plan",
  "plan_limit": 10000,
  "api_usage": 1432,
  "usage_remaining": 8568,
  "usage_reset_at": "Wed, 22 Jul 2026 14:39:00 GMT",
  "created_at": "Tue, 20 Jan 2026 14:51:02 GMT"
}

{
  "error": "You have reached the maximum usage limit. Please upgrade your plan",
  "code": "quota_exceeded"
}

import requests

API_KEY = "your_api_key"

response = requests.get(
    "https://barcodereport.com/api/search_barcode",
    params={"barcode": "747062088118"},
    headers={"X-API-Key": API_KEY},
    timeout=10,
)

if response.status_code == 200:
    product = response.json()
    print(product["title"], product.get("brand"))
elif response.status_code == 404:
    print("No record for that barcode")
else:
    # Branch on the stable code, not the message.
    print("Error:", response.json().get("code"))

const API_KEY = "your_api_key";

const res = await fetch(
  "https://barcodereport.com/api/search_barcode?barcode=747062088118",
  { headers: { "X-API-Key": API_KEY } }
);

const data = await res.json();

if (res.ok) {
  console.log(data.title, data.brand);
} else if (data.code === "rate_limited") {
  const wait = Number(res.headers.get("Retry-After") ?? 60);
  console.warn(`Backing off for ${wait}s`);
} else {
  console.error(data.code, data.error);
}

$ch = curl_init("https://barcodereport.com/api/search_barcode?barcode=747062088118");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["X-API-Key: your_api_key"],
    CURLOPT_TIMEOUT        => 10,
]);

$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);

if ($status === 200) {
    echo $data["title"];
} else {
    echo "Error: " . $data["code"];
}

require "net/http"
require "json"

uri = URI("https://barcodereport.com/api/search_barcode")
uri.query = URI.encode_www_form(barcode: "747062088118")

request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = "your_api_key"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts response.code == "200" ? data["title"] : data["code"]