API reference · E-commerce
Amazon Product Search
Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
https://api.serpbase.dev/amazon/searchExample
curl -X POST 'https://api.serpbase.dev/amazon/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
--max-time 60 \
-d '{"domain":"amazon.com","q":"wireless headphones"}'No recorded response is published for this endpoint yet. Run the example in the Playground to see a live one.
Parameters
formatMore
markdown returns the same result as Markdown text (text/markdown) for language models: no envelope, no duplicate alias fields, no inline images. Same credits; failures keep the JSON envelope.
domainqamazon_domainMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
countryMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
cursorMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
deviceMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
glMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
hlMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
htmlMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
languageMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
limitMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
markdownMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
mobileMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
numMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
pageMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
typeMore
Use one spelling at a time; the API validates the parameters and values supported by this product.
The sample shows example parameters, not the complete request contract. Known fields are validated by the API; additional parameters are allowed.
What comes back
The fields are those in the response above; every endpoint also carries status, credits_charged and request_id.
If it fails
A failed request has a non-zero status and an error, and is not charged. The ones you will see here:
1000A parameter is missing or wrongFix the request1020No credits leftTop up1029Over your requests per secondWait Retry-After seconds1502 · 1504The source could not be read this timeRetry