Skip to main content
GET
Find products to buy
Search for a product or category. Prices are quoted in the currency of country, which is the only thing that sets them; there is no separate currency parameter. This listing returns a single page and offers no further results, so there is no next_page to follow. When a result includes an id, pass it unchanged to product details to read the full listing and every seller. Some rows have no ID; only offer a follow-up when one is present.

Authorizations

Authorization
string
header
required

Public API key: Authorization: Bearer san_....

Query Parameters

country
string

ISO 3166-1 alpha-2. Defaults to us.

Example:

"us"

query
string
required

What to shop for.

Example:

"wireless headphones"

Response

id
string<uuid>
required

Id of this request. Quote it when reporting a problem.

took_ms
number
required

How long the request took, in milliseconds.

Example:

1420

request
object
required

The parameters as accepted, after defaults and normalization. What the request actually ran with.

Example:
next_page
number | null
required

The next page to ask for, or null when there is no further page. Never a page this endpoint would reject.

Example:

2

results
object[]
required
currency
string
required

ISO 4217 code the prices are quoted in. Prices follow country, so this is never absent and is not a parameter.

Example:

"USD"