Skip to main content

Lookup Barcode GET Endpoint

Our GET endpoint allows you to lookup an EAN (European Article Number) and return information about the related product.

Route​

/api/barcode/lookup/{barcode}
Authorization: Bearer {Your API Key}

Query Parameters​

You can select the data to be returned by using the fields parameter. Available fields include:

  • product
  • product.product_name
  • product.product_brand
  • product.product_category
  • product.product_description
  • product.product_style_code
  • product.product_colorway
  • product.product_release_date
  • product.product_retail_price
  • product.product_image
  • product.product_sizes
  • product.product_added
  • product.product_updated
  • barcode
  • barcode.barcode_type
  • barcode.barcode_value
  • barcode.barcode_added
  • barcode.product_size

Responses​

You will receive one of the following responses:

  • 200 Barcode not found.
  • 200 Barcode Information.

Here's an example of a successful request and response:

Request:

https://barcodes.gg/api/barcode/lookup/195245980597?show_data=1&fields=*

Response:

{
    "error": false,
    "product": {
        "product_name": "Nike Air Max 96 II Black White",
        "product_brand": "Nike",
        "product_category": "sneakers",
        "product_description": null,
        "product_style_code": "DH4756-100",
        "product_colorway": "Black/White",
        "product_release_date": "2022-03-01",
        "product_retail_price": "160",
        "product_image": "hidden, its a base64 string",
        "product_sizes": [...],
        "product_added": "2023-06-12T07:58:58.600000Z",
        "product_updated": "2023-06-12T19:18:56.317000Z",
    },
    "barcode": {
        "barcode_type": "UPC",
        "barcode_value": "195245980597",
        "barcode_added": null,
        "product_size": {
            "us": "7.5",
            "uk": "6.5",
            "eu": "40.5"
        }
    },
    "response_time": "377ms",
    "request_fulfilled": true,
    "request_debited": true
}