DocsV1 (Legacy)
This is documentation for V1 of the API, which is no longer maintained. Use the V2 documentation for new integrations.
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}Header
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:
200Barcode not found.200Barcode 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
}Lookup Product
Legacy V1 product search uses a query string and optional result count, returning matching product names, style codes, release and colorway data.
Lookup Image
Legacy V1 image lookup uses a product style code and returns the image as a binary stream when found; the page lists validation and missing-image outcomes.