Overview

The Barcode Spider API allows developers to retrieve detailed product information using barcode identifiers such as UPC, EAN, and ISBN.

With a single request, you can access:

  • Product details (name, brand, description, etc.)
  • Barcode metadata
  • Category and attributes
  • Images and offers

Base URL

https://api.barcodespider.com/v2/

Authorization

The API supports two authentication methods:

1. Bearer Token (Recommended)

Pass your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Example

curl -X GET "https://api.barcodespider.com/v2/products/070640310500" \
-H "Authorization: Bearer YOUR_API_KEY"

2. URL Parameter

Alternatively, you can pass your API key directly in the URL:

https://api.barcodespider.com/v2/products/{barcode}?key=YOUR_API_KEY

Example

curl "https://api.barcodespider.com/v2/products/070640310500?key=YOUR_API_KEY"

👉 Sign up now and get your API key instantly

Endpoint

Get Product by Barcode

Retrieve product data using a barcode value.

GET /products/{barcode}

Example

GET https://api.barcodespider.com/v2/products/070640310500?key=YOUR_API_KEY

Code Examples

The following code samples are provided to assist in your integration process. Each example demonstrates how to initiate an API request and handle the response across multiple programming languages.

Integrations

The API can be easily integrated into:

  • E-commerce platforms → auto-fill product data
  • Inventory systems → barcode lookup
  • Mobile apps → barcode scanning apps
  • POS systems → product validation

Supports integration with:

  • Backend (PHP, Node.js, Python)
  • Frontend (JavaScript)
  • Mobile (Android / iOS via HTTP requests)

JSON Response

JSON Response Structure

{
    "meta": {
        "success": true,
        "code": 200,
        "message": "Data returned"
    },
    "identifiers": {
        "barcode_type": "UPC-A",
        "values": {
            "upc": "781138811156",
            "ean13": "0781138811156",
            "isbn13": null,
            "isbn10": null
        },
        "gs1_allocation": {
            "type": "gs1_country",
            "name": "United States and Canada",
            "code": "US/CA",
            "range": "60-99"
        },
        "region": {
            "name": "United States and Canada",
            "iso": "US,CA"
        }
    },
    "product": {
        "name": "On The Border Spicy Jalapeno tobaco Queso 15.25 oz Jar",
        "brand": "On The Border",
        "model": "x-SJB 12",
        "category": {
            "id": 5740,
            "path": "Food, Beverages & Tobacco > Food Items > Dips & Spreads"
        },
        "manufacturer": "On The Border",
        "mpn": null,
        "asin": "B08HT4KTZB",
        "color": null,
        "size": "15.25 oz",
        "weight": "15.25 oz",
        "is_adult": false,
        "description": "Introducing On The Border Spicy Jalapeno Queso a flavor-packed delight that is sure to elevate your snacking and dining experience. Packed in a generous 15.25 oz jar this queso dip is a tantalizing blend of creamy melted cheese and the fiery kick of jalape?o peppers. Crafted with care this queso boats a rich and velvety texture making it the perfect companion for tortilla chips nachos or as a zesty topping for your favorite dishes. The bold spiciness of jalapenos is expertly balanced with the",
        "features": [
            "Creamy blend of cheese with a noticeable, zesty kick from diced jalapenos.",
            "Gluten-free, no MSG, 0g trans fat. Each 2-tablespoon serving contains approximately 45 calories, 3g of fat, and 270mg of sodium."
        ],
        "attributes": {
            "ingredients": {
                "raw_text": "Water, Monterey Jack Cheese (Milk, Cheese Cultures, Salt, Enzymes), Jalapeno Peppers, Soybean Oil, Maltodextrin, Modified Corn Starch, Whey Protein Concentrate, Contains Less Than 2% Of: Green Chiles, Diced Tomatoes In Juice, Sodium Phosphate, Natural Flavors, Datem, Sodium Citrate, Lactic Acid, Vinegar, Sodium Alginate, Sorbic Acid (Preservative), Xanthan Gum, Dried Red And/or Green Bell Peppers, Spices, Dried Onions, Dried Garlic, Yellow 5 & Yellow 6, Tomato Powder"
            }
        },
        "images": [
            "https://i5.walmartimages.com/asr/56fcb3ec-ac5e-496c-b237-5f6c14de3a17.56bb7a9c916aee5fa3e41bdf57ae7661.jpeg?odnHeight=450&odnWidth=450",
			"https://i5.walmartimages.com/asr/56fcb3ec-ac5e-496c-b237-5f6c14de3a17.56bb7a9c916aee5fa3e1.jpeg"
        ]
    },
    "offers": [
        {
            "seller": "walmart.com",
            "listing_title": "On The Border Spicy Jalapeno Queso 15.25 oz Jar",
            "price": {
                "amount": 11.4,
                "currency": "USD"
            },
            "url": "https://walmart.com/search?q=On+The+Border+Spicy+Jalapeno+Queso+15.25+oz+Jar"
        }
    ]
}

JSON Response Structure

Meta

FieldTypeDescription
successbooleanRequest status
codeintegerHTTP status code
messagestringResponse message

Identifiers

Field Type Description
barcode_type string Type of barcode (e.g. UPC-A)
values.upc string UPC code
values.ean13 string EAN-13 code
values.isbn13 string ISBN-13
values.isbn10 string ISBN-10
gs1_allocation.type string Allocation type
gs1_allocation.name string Region name
gs1_allocation.code string Region code
gs1_allocation.range string GS1 range
region.name string Region name
region.iso string ISO country codes

Product

Field Type Description
name string Product name
brand string Brand name
model string Product model
category.id integer Category ID
category.path string Category hierarchy
manufacturer string Manufacturer
mpn string Manufacturer part number
asin string Amazon ASIN
color string Product color
size string Product size
weight string Product weight
is_adult boolean Adult product flag
description string Product description
features array Key features
attributes object Additional attributes
images array Image URLs

Offers Array

Field Type Description
seller string Seller name
listing_title string Listing title
price.amount float Price value
price.currency string Currency code
url string Product URL

Error Response

When an error occurs, the API returns a structured response:

Example Error


{
  "meta": {
    "success": false,
    "code": 401,
    "message": "Unauthorized"
  }
}

Common Error Codes

Code Meaning Description
400 Bad Request Invalid request parameters
401 Unauthorized Invalid or missing API key
404 Not Found Product not found
429 Too Many Requests Rate limit exceeded

Rate Limit

To ensure fair usage and system stability, the API enforces rate limiting based on your subscription plan.

PlanLimitDescription
Free / Trial 1 request / 5 seconds Suitable for testing and low-volume usage
Paid 1 request / 1 second Designed for production and higher usage needs

If you exceed the limit, the API will return a 429 Too Many Requests response.

Hotlinking Image Policy

The images field in the API response contains external image URLs.

  • Images are hosted by third-party providers (e.g. retailers, marketplaces).
  • Hotlinking is allowed, but availability is not guaranteed.
  • We recommend downloading and caching images on your own server for better reliability.
  • Barcode Spider API is not responsible for broken or removed images.

For production applications, it is highly recommended to implement your own image storage or CDN.

Notes

  • Always use HTTPS for secure communication.
  • Cache responses when possible to reduce API usage.
  • Handle errors gracefully in your application.
  • Use Bearer authentication for better security.