Product Search
Run a keyword search and get back a ranked page of products with price, rating, review count, Prime eligibility, badges and delivery copy. Supports auto-pagination, price bands, department scoping and sponsored filtering.
Query parameters
| Name | Type | Default | Description |
|---|---|---|---|
|
query
required |
string | — | Search keywords. |
| page | integer | 1 | 1-based page number. |
| limit | integer | 0 |
Auto-paginate until N items are collected. 0 returns a single page. Max 200.
|
| sort | string | — |
Result ordering.
relevanceprice_ascprice_descratingnewestbestseller
|
| department | string | — |
Restrict to a department, e.g. electronics.
|
| min_price | number | — | Lowest price to include, in the marketplace's currency. |
| max_price | number | — | Highest price to include. |
| prime_only | boolean | false | Only return Prime-eligible results. |
| include_sponsored | boolean | true | Keep sponsored placements in the results. |
| marketplace | string | US | Two-letter marketplace code (US, UK, DE, FR, IT, ES, CA, JP, IN, AU, …). |
| zip | string | — | Delivery postcode. Without one, many listings report “cannot be shipped to your location” and come back with no price or images. Always send it for price-accurate data. |
Request
curl -sS "https://amazoncrawler.com/v1/products/search?query=wireless+mouse&marketplace=US&zip=10001" \
-H "x-api-key: YOUR_API_KEY"import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://amazoncrawler.com/v1/products/search",
params={
"query": "wireless mouse",
"marketplace": "US",
"zip": "10001",
},
headers={"x-api-key": API_KEY},
timeout=30,
)
response.raise_for_status()
data = response.json()
print(data)const API_KEY = "YOUR_API_KEY";
const url = new URL("https://amazoncrawler.com/v1/products/search");
const params = {
query: "wireless mouse",
marketplace: "US",
zip: "10001",
};
Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
const response = await fetch(url, {
headers: { "x-api-key": API_KEY },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);<?php
$apiKey = 'YOUR_API_KEY';
$query = http_build_query([
'query' => 'wireless mouse',
'marketplace' => 'US',
'zip' => '10001',
]);
$ch = curl_init("https://amazoncrawler.com/v1/products/search?$query");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-api-key: $apiKey"],
CURLOPT_TIMEOUT => 30,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
)
func main() {
u, _ := url.Parse("https://amazoncrawler.com/v1/products/search")
q := u.Query()
q.Set("query", "wireless mouse")
q.Set("marketplace", "US")
q.Set("zip", "10001")
u.RawQuery = q.Encode()
req, _ := http.NewRequest("GET", u.String(), nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
var data map[string]any
json.NewDecoder(res.Body).Decode(&data)
fmt.Println(data)
}Response · 200 OK
{
"page": 1,
"sort": null,
"count": 20,
"query": "wireless mouse",
"results": [
{
"url": "https://www.amazon.com/dp/B07CMS5Q6P/ref=sr_1_1_sspa",
"asin": "B07CMS5Q6P",
"badge": "Best Seller",
"image": "https://m.media-amazon.com/images/I/51sg9BLSMTL.jpg",
"price": {
"amount": 29.99,
"display": "$29.99",
"currency": "USD",
"list_price": 49.99
},
"prime": false,
"title": "Logitech G305 Lightspeed Wireless Gaming Mouse - Black | HERO sensor, 12,000 DPI, Six programmable buttons, 250-hour battery, On-board memory",
"rating": 4.6,
"delivery": "FREE delivery Mon, Aug 10 on $35 of items shipped by Amazon",
"position": 4,
"sponsored": true,
"reviews_count": 39364,
"bought_past_month": "10K+ bought in past month"
},
{
"url": "https://www.amazon.com/dp/B005EJH6Z4/ref=sr_1_2_ffob_sspa",
"asin": "B005EJH6Z4",
"badge": null,
"image": "https://m.media-amazon.com/images/I/61YQeAUIboL.jpg",
"price": {
"amount": 12.58,
"display": "$12.58",
"currency": "USD",
"list_price": null
},
"prime": false,
"title": "Amazon Basics 2.4 GHz Wireless Optical Computer Mouse with USB Nano Receiver",
"rating": 4.5,
"delivery": "FREE delivery Mon, Aug 10 on $35 of items shipped by Amazon",
"position": 5,
"sponsored": true,
"reviews_count": 69507,
"bought_past_month": "10K+ bought in past month"
}
],
"marketplace": "US",
"has_next_page": true,
"total_results": 42555
}