E-Commerce

Amazon Search

Search Amazon product listings across 12 marketplaces — title, price, rating, ASIN, and Prime/deal flags — as structured JSON.

POST/api/v1/amazon/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Product search query (1-500 characters).

Example: wireless earbuds

domainstring

Amazon marketplace domain (com, co.uk, de, ...).

Example: com

countrystring

Country code for localized results.

languagestring

Language code.

currencystring

Currency code.

deviceenum<string>

Device to emulate: desktop, mobile, tablet.

sort_byenum<string>

most_recent, price_low_to_high, price_high_to_low, featured, average_review, bestsellers.

start_pagenumber

Starting page number.

pagesnumber

Number of pages to return.

category_idstring

Amazon category ID to filter by.

merchant_idstring

Amazon merchant ID to filter by.

zip_codestring

ZIP code for localized results.

autoselect_variantboolean

Auto-select a product variant.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.amazon.search("wireless earbuds")
print(results)

Response

"page": 1,

"products_count": 34,

"url": "https://www.amazon.com/s?k=wireless+earbuds&page=1&language=en_US"

"response_time": 2.14,

"credits_used": 1,

"credits_remaining": 49

}