API Documentation

Use our REST API to programmatically translate product identifiers.

Authentication

Include your API key in the X-API-Key header or as a api_key query parameter.

Generate API keys in your dashboard.

GET/api/v1/translate

Auto-detect identifier type and translate

Parameters

identifier, country

Example

curl -H "X-API-Key: aet_xxx" "https://asin-ean-translator.scraper.cc/api/v1/translate?identifier=B0BZFQ7V2G&country=us"

GET/api/v1/asin-to-ean

Explicit ASIN to EAN translation

Parameters

asin, country

Example

curl -H "X-API-Key: aet_xxx" "https://asin-ean-translator.scraper.cc/api/v1/asin-to-ean?asin=B0BZFQ7V2G&country=us"

GET/api/v1/ean-to-asin

Explicit EAN to ASIN translation

Parameters

ean, country

Example

curl -H "X-API-Key: aet_xxx" "https://asin-ean-translator.scraper.cc/api/v1/ean-to-asin?ean=0194687748994&country=us"

POST/api/v1/batch

Batch translate multiple identifiers

Parameters

body: { identifiers: string[], country: string }

Example

curl -X POST -H "X-API-Key: aet_xxx" -H "Content-Type: application/json" -d '{"identifiers":["B0BZFQ7V2G","0194687748994"],"country":"us"}' "https://asin-ean-translator.scraper.cc/api/v1/batch"

GET/api/v1/extract-gtin

Extract GTIN from product URL

Parameters

url

Example

curl -H "X-API-Key: aet_xxx" "https://asin-ean-translator.scraper.cc/api/v1/extract-gtin?url=https://www.amazon.com/dp/B0BZFQ7V2G"

Response Format

All endpoints return JSON with this structure:

{
  "success": true,
  "data": {
    "input": "B0BZFQ7V2G",
    "input_type": "asin",
    "country": "us",
    "asin": "B0BZFQ7V2G",
    "ean_list": ["0194253946090"],
    "upc_list": ["194253946090"],
    "title": "Apple AirPods Pro (2nd Generation)",
    "brand": "Apple",
    "price": 189.99,
    "currency": "USD",
    "rating": 4.7,
    "review_count": 125847,
    "images": ["https://..."]
  }
}

Error Response

{
  "success": false,
  "error": "Product not found"
}