POSTPublicbar-code-query

Barcode Lookup

Quickly query product name, brand, reference price, manufacturer, and other detailed information by inputting a product barcode (e.g., EAN-13), suitable for retail, inventory management, and other scenarios.

Usage Cost

10 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Capabilities

The Product Barcode Query API allows developers to retrieve basic product information by inputting a standard product barcode (e.g., the common 13-digit EAN-13 code). The returned data typically includes product name, brand, reference price, and manufacturer. This API helps developers quickly build a product information database, reducing manual entry costs.

Request and Response

Request Parameters: Only barcode (product barcode) needs to be provided. Ensure the input barcode is a pure numeric string.
Return Results: The API will return a JSON object containing product information. Core fields include name (product name), brand (brand), price (reference price, usually the suggested retail price), and manufacturer (manufacturer).
Troubleshooting Failures: If no product is found, please check if the barcode was entered correctly, or if the product uses a non-standard barcode or an internal circulation code.

Use Cases

Retail POS and Scanning: Quickly identify and display product information by scanning barcodes in POS systems or mobile applications.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "barcode": "6901028089296"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "name": "中华(软)香烟",
    "brand": "中华",
    "price": "65.00",
    "manufacturer": "上海烟草集团有限责任公司"
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
barcode	string	6901028089296

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.name	string	中华(软)香烟
data.brand	string	中华
data.price	string	65.00
data.manufacturer	string	上海烟草集团有限责任公司

curl --request POST \ --url 'https://openapi.toolkk.com/v1/bar-code-query' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "barcode": "6901028089296"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/bar-code-query" payload = { "barcode": "6901028089296" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/bar-code-query" payload := []byte("{\n \"barcode\": \"6901028089296\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"barcode\": \"6901028089296\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/bar-code-query")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/bar-code-query'; $payload = "{\n \"barcode\": \"6901028089296\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

Barcode Lookup

Try it online

Documentation

API Capabilities

Request and Response

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Usage Notes and Limitations

Shell Example

Python Example

Go Example

Java Example

PHP Example