API / Search & discovery
Keyword and structured search across every connected seller. Returns canonical products with live offers, spread and a verdict — not raw listings you have to deduplicate yourself.
GET /v1/search
| Name | Type | Notes |
|---|---|---|
| q | string | Plain language, brand, model, or any identifier. |
| category | string | Taxonomy node from /v1/categories. |
| seller | string[] | Restrict to named sellers. |
| in_stock | bool | Only offers currently purchasable. |
| max_price | int | Minor units. Filters landed cost, not sticker. |
| cursor | string | Opaque cursor from next_cursor. |
GET /v1/search?q=noise+cancelling+headphones&max_price=25000
→ 200
{ "results": [
{ "product_id": "prd_8Fk2xQ",
"title": "Sony WH-1000XM5", "gtin": "00885909950805",
"best": { "seller": "bestbuy", "price": "$198.00" },
"offers": 4, "spread": "$101.99", "verdict": "excellent" } ],
"next_cursor": "eyJvIjoy…" }