Amazon Product Search
Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
Browse every endpoint with request samples, parameters and its per-request price. One API key calls them all; account limits apply.
At a glance
- Endpoint
- POST https://api.serpbase.dev/amazon/search
- Price
- 2 credits / request
- Authentication
- X-API-Key
- Result type
- schemas.source_data
Endpoint and billing rules
https://api.serpbase.dev/amazon/searchEach customer request uses the fixed catalog price, not a per-page rate. Web Crawl and User Agent currently cost 1 credit per request each; User Agent is not free. Genuine not-found results confirmed by source and resource identity are charged. no_results, HTTP 404 or missing hydration/parsed data alone cannot prove absence. Executed failures may currently consume credits; refunds are not guaranteed for every failure. credits_charged reports the actual charge: 0 means reported zero; null or missing means unknown. charge_status UNKNOWN remains unknown even with a numeric charge. Check account records and contact support with request_id; never assume a refund or retry blindly.
Example request parameters
Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.
| Parameter | Example type | Example value |
|---|---|---|
| domain | string | "amazon.com" |
| q | string | "wireless headphones" |
{
"domain": "amazon.com",
"q": "wireless headphones"
}| Alias | Parameter | Type |
|---|---|---|
| amazon_domain | domain | string |
| country | locale.country | string |
| cursor | pagination.cursor | string |
| device | options.device | string |
| gl | locale.country | string |
| hl | locale.language | string |
| html | include_html | boolean |
| language | locale.language | string |
| limit | pagination.limit | integer |
| markdown | include_markdown | boolean |
| mobile | options.device | boolean |
| num | pagination.limit | integer |
| page | pagination.page | integer |
| q | query | string |
| type | search_type | string |
Supported devices: desktop; default: desktop.
Request examples
curl -X POST 'https://api.serpbase.dev/amazon/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"domain":"amazon.com","q":"wireless headphones"}'const response = await fetch("https://api.serpbase.dev/amazon/search", {
"method": "POST",
"headers": {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
},
"body": "{\"domain\":\"amazon.com\",\"q\":\"wireless headphones\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);Response and API outcome
Responses are JSON. HTTP 200 is not proof of search success: inspect status and error. Fields depend on the product contract and upstream data.
View response documentationFrequently asked questions
How much does the Amazon Product Search API cost?
Each request costs 2 credits. Credits come from prepaid packs or the monthly plan, and new accounts start with free credits.
How do I call the Amazon Product Search API?
Send a POST request to https://api.serpbase.dev/amazon/search with your API key in the X-API-Key header. The response is JSON; check status (0 means success).
Which devices does it support?
Supported devices: desktop. The default is desktop.
Is the Amazon Product Search API available now?
Yes. Any active API key can call it.