Common parameters

These parameters work across every Amazon type. Type-specific parameters (like asin for type=product or seller_id for seller types) live on each endpoint page.

Parameters

Parameter	Type	Required	Description
api_key	string	yes	Your SERP API key
engine	string	yes	Must be amazon
type	string	yes	Which surface (search, product, bestsellers, deals, category, seller_profile, seller_products, seller_feedback)
domain	string	no	Target marketplace (e.g. amazon.co.uk, amazon.de). Default amazon.com
device	desktop | mobile	no	Simulated device
page	integer	no	Page number for paginated types
output	json | html	no	Response format. Default json

Device and marketplace examples

US desktop bestsellers for electronics:

curl "https://ecom.shifter.io/v1?engine=amazon&api_key=YOUR_API_KEY&type=bestsellers&category_id=electronics&domain=amazon.com"

German mobile search:

curl "https://ecom.shifter.io/v1?engine=amazon&api_key=YOUR_API_KEY&type=search&q=laptop&domain=amazon.de&device=mobile"

Pagination

page is 1-indexed. When a response includes a next_page URL, follow it directly or increment page.

# Page 1
curl "https://ecom.shifter.io/v1?engine=amazon&api_key=YOUR_API_KEY&type=search&q=books&page=1"

# Page 2
curl "https://ecom.shifter.io/v1?engine=amazon&api_key=YOUR_API_KEY&type=search&q=books&page=2"

See also

• Access the API
• Supported domains
• All endpoints