EAN Manager

The EAN Lookup API resolves EAN barcodes to product information by querying external product databases (Icecat, GS1, and others). Results are cached to minimize external API costs.

POST/ean-lookup/lookup

Look up an EAN

Resolves a single EAN against the available provider databases.

Body parameters

Name
ean
Type
string
Description
The EAN to look up (8 or 13 digits).
Name
use_cache
Type
boolean
Description
Return a cached result if available (default: true).
Name
providers
Type
array
Description
Providers to query: icecat, gs1. Queries all active providers if omitted.

Request

POST

/ean-lookup/lookup

curl -X POST https://api.pixeepim.com/api/v1/ean-lookup/lookup \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "ean": "3760000000001",
    "use_cache": true,
    "providers": ["icecat", "gs1"]
  }'

Response

{
  "ean": "3760000000001",
  "found": true,
  "provider": "icecat",
  "data": {
    "name": "Produit exemple",
    "brand": "Ma Marque",
    "category": "Électronique",
    "description": "Description détaillée du produit.",
    "specs": {
      "weight": "500g",
      "color": "Noir"
    },
    "images": [
      "https://cdn.icecat.biz/img/example.jpg"
    ]
  },
  "lookup_date": "2026-05-14T10:30:00Z"
}

POST/ean-lookup/batch-lookup

Batch lookup

Resolves multiple EANs in parallel. Maximum 500 EANs per request.

Body parameters

Name
eans
Type
array
Description
Array of EAN strings to look up (max 500).
Name
use_cache
Type
boolean
Description
Return cached results where available (default: true).
Name
parallel
Type
boolean
Description
Query providers in parallel for faster resolution (default: true).

Request

POST

/ean-lookup/batch-lookup

curl -X POST https://api.pixeepim.com/api/v1/ean-lookup/batch-lookup \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "eans": [
      "3760000000001",
      "3760000000002",
      "9999999999999"
    ],
    "use_cache": true
  }'

Response

{
  "results": [
    {
      "ean": "3760000000001",
      "found": true,
      "provider": "icecat",
      "data": {
        "name": "Produit A",
        "brand": "Marque A"
      }
    },
    {
      "ean": "3760000000002",
      "found": true,
      "provider": "gs1",
      "data": {
        "name": "Produit B",
        "brand": "Marque B"
      }
    },
    {
      "ean": "9999999999999",
      "found": false,
      "provider": null,
      "data": null
    }
  ],
  "total": 3,
  "found": 2,
  "processing_time_ms": 234
}

GET/ean-lookup/cache/stats

Cache stats

Returns statistics about the EAN lookup cache and available providers.

Request

GET

/ean-lookup/cache/stats

curl https://api.pixeepim.com/api/v1/ean-lookup/cache/stats \
  -H "Authorization: Bearer {api_key}"

Response

{
  "total_lookups": 12450,
  "successful_lookups": 10980,
  "failed_lookups": 1470,
  "cache_hits": 7200,
  "cache_misses": 5250,
  "available_providers": [
    {
      "name": "icecat",
      "status": "active",
      "confidence": 0.95,
      "description": "International product database"
    },
    {
      "name": "gs1",
      "status": "active",
      "confidence": 0.88,
      "description": "GS1 global product registry"
    }
  ]
}

GET/ean-lookup/pending

Pending EANs

Lists EANs that are queued for lookup but haven't been resolved yet. You can force an immediate lookup for a specific pending EAN.

Query parameters

Name
skip
Type
integer
Description
Offset (default: 0).
Name
limit
Type
integer
Description
Items per page, max 100 (default: 50).

List pending

GET

/ean-lookup/pending

curl https://api.pixeepim.com/api/v1/ean-lookup/pending \
  -H "Authorization: Bearer {api_key}"

Force lookup

POST

/ean-lookup/pending/{ean}/lookup

curl -X POST https://api.pixeepim.com/api/v1/ean-lookup/pending/3760000000001/lookup \
  -H "Authorization: Bearer {api_key}"