API Documentation

v1 · Early Access

Given any partial product identifier — name fragment, EAN, brand+model — Merkdex returns canonical product identity plus all live offers from 4,000+ Polish shops.

🔑 Authentication

Pass your API key as a header on every request:

X-API-Key: mk_your_key_here

Free tier: 10 calls/day, no credit card. Get your key at merkdex.com/#get-started.

🔍 Search

GETapi.merkdex.com/v1/search?q={query}&limit={n}

Fuzzy search across 800K+ products. Returns ranked matches with canonical identity.

🎯 Resolve by EAN / GTIN

GETapi.merkdex.com/v1/products/ean/{ean}

Exact match by barcode. Returns the canonical product record if found.

🛒 Get All Offers

GETapi.merkdex.com/v1/products/{id}/offers

All live offers for a product — new, used, refurbished — with price, seller, and link. Starter tier and above.

📦 Product Card Embed

GETapi.merkdex.com/v1/products/{id}/card

Self-contained HTML snippet: image, specs, price comparison. Drop it into any page. Pro tier. Coming soon.

Full OpenAPI spec and SDKs in progress. Questions: [email protected]