Bulk match — POST /v1/match

Bulk match

Send up to 10,000 of your own rows and get canonical ids back, each with a method and a confidence — including the ones we refuse to guess at.

POST /v1/match

Request

No parameters beyond the path and your bearer token.

Request & response

POST /v1/match
{ "rows": [
   { "id": "sku-1", "gtin": "885909950805" },
   { "id": "sku-2", "brand": "Ninja", "title": "Foodi 8-qt air fryer" } ] }

→ 200
{ "matched": [
   { "id": "sku-1", "product_id": "prd_8Fk2xQ",
     "method": "gtin_exact",  "confidence": 1.00 },
   { "id": "sku-2", "product_id": "prd_71bQa2",
     "method": "title_fuzzy", "confidence": 0.68, "review": true } ],
  "unmatched": [] }

Notes

Rows below the trust threshold come back flagged `review: true` rather than silently accepted. A false positive underprices you; a false negative just costs a lookup.