Resolve — POST /v1/resolve

Resolve

GTIN, UPC, EAN, ASIN, seller SKU, product link or plain language into one canonical product and every listing that carries it.

POST /v1/resolve

Request

Name	Type	Notes
ref	string	Any identifier, a product link, or free text.
sellers	string[]	Optional. Restrict which sources are searched.

Request & response

POST /v1/resolve
{ "ref": "https://www.walmart.com/ip/21284588" }

→ 200
{ "product_id": "prd_8Fk2xQ",
  "gtin": "00079340802766",        // checksum-verified
  "brand": "Loctite",
  "match": { "method": "gtin_exact", "confidence": 1.0 },
  "listings": [
    { "seller": "walmart", "sku": "21284588",  "price": 1499 },
    { "seller": "amazon",  "sku": "B000BQWZ4S", "price": 1612 } ] }

Notes

Check digits are verified. An identifier that fails its own checksum is worse than no identifier, so it is rejected rather than stored.

match.method and match.confidence are always returned. Publishing match quality is the one credible differentiator in a category where everyone claims AI matching and nobody shows a number.