Skip to main content
GET
Beta — this endpoint is in active development and may change without notice. Field names, ranking, and coverage are still evolving. We’d love your feedback: book a 30-minute customer interview and help shape the v1 — we’ll send you a $50 Amazon gift card as a thank-you.
GET /search returns a single ranked list of buyable products across every supported retailer — Amazon, Walmart, Target, Best Buy, Home Depot, Lowe’s, Costco, eBay, Wayfair, Macy’s, and more — in one call. Each result’s url is the orderable retailer URL: pass it directly to Create order. There is no opaque sku id and no separate ASIN / item-id field — the URL is the contract. This is distinct from the per-retailer /products/search, which searches one retailer at a time. Use /search when you want breadth.

Ranking

Results are ranked by a quality signal that combines rating and review volume, with price as a tiebreaker for unrated items. The list is then woven across retailers so a single retailer doesn’t dominate the top — typically you’ll see two or three different retailers in the first few results.

Beta limits

These will change before v1:
  • No condition filter — used / marketplace listings may appear when the source doesn’t expose condition.
  • Coverage varies by query; some long-tail and DTC retailers may not appear.
  • No limit, sort, or filter parameters yet.
  • Response shape may add fields (e.g. condition, shipping ETA). Existing fields won’t be removed without notice.

Help shape the beta

Customer interview — 30 minutes · $50 Amazon gift card

We’re actively iterating on /search. Tell us what queries you’re running, what coverage you need, and what’s missing. As a thank-you we’ll send you a $50 Amazon gift card.

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Query Parameters

q
string
required

Search term

Minimum string length: 1

Response

Successful Response

Response from the cross-retailer search endpoint.

status
string
required
query
string
required
results
Sku · object[]