Amazon API endpoint
Searches `amazon.com` by keyword, with optional sort order and page. Each result card has the ASIN, title, link, image, price and list price, rating and review count, the bought-in-last-month figure, and flags for sponsored placement and free delivery.
/amazon/searchQuery parameters:
k: required. Search keyword. Example: apple watch.s: optional. Sort order. Example: review-rank.page: optional. 1-based page number. Example: 1.| Field | Filled in, of 48 checked | Values in the sample |
|---|---|---|
| asin | 48 | |
| title | 48 | median 132 characters |
| is_sponsored | 48 | true in 0 of 48 |
| link | 48 | amazon.com |
| image | 48 | m.media-amazon.com |
| rating | 48 | 0 to 5, median 4.1 |
| review_count | 48 | 0 to 4,800, median 30 |
| price | 48 | 0 to 419, median 10.11 |
| list_price | 48 | 0 to 99.99, median 0 |
| number_of_bought_in_last_month | 48 | 0 to 200, median 0 |
| is_free_delivery | 48 | true in 0 of 48 |
| more_choice | 7 | amazon.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| k | string | Yes | Search keyword | apple watch | |
| s | string | No | Sort order | review-rank | |
| page | integer | No | 1-based page number | 1 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/amazon/search?k=apple+watch&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": [
{
"asin": "142325113X",
"title": "ChatGPT Uses & Prompts: a QuickStudy Laminated Reference Guide",
"is_sponsored": false,
"link": "https://www.amazon.com/ChatGPT-Uses-Prompts-QuickStudy-Laminated/dp/142325113X/",
"image": "https://m.media-amazon.com/images/I/71qzQ91Qe0L._AC_UL320_.jpg",
"rating": 4.4,
"review_count": 223,
"price": 8.34,
"list_price": 8.95,
"number_of_bought_in_last_month": 0,
"is_free_delivery": false,
"more_choice": "https://www.amazon.com/gp/offer-listing/142325113X/"
}
]
}Request schema
No body schema
Response schema
#/definitions/amazon.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | array | No | ||||
| data[].asin | string | No | B0DGJ736JM | Amazon Standard Identification Number of the product. | ||
| data[].image | string | No | https://m.media-amazon.com/images/I/61eE8SSyPWL._AC_UY545_FMwebp_QL65_.jpg | URL of the product image. | ||
| data[].is_free_delivery | boolean | No | true | True when the card advertises free delivery. | ||
| data[].is_sponsored | boolean | No | true | True for a sponsored placement. | ||
| data[].link | string | No | https://www.amazon.com/Apple-Smartwatch-Midnight-Aluminium-Detection/dp/B0DGJ736JM/ | Link to the product page on amazon.com. | ||
| data[].list_price | number | No | 249 | List price before any discount, when the card shows one. | ||
| data[].more_choice | string | No | https://www.amazon.com/gp/offer-listing/B08KYJPTB6/ | Link to more buying choices for the product, when the card has one. | ||
| data[].number_of_bought_in_last_month | integer | No | 1000 | Amazon's "bought in past month" figure. 0 when the card does not show one. | ||
| data[].price | number | No | 189 | Current price shown on the card. | ||
| data[].rating | number | No | 4.4 | Average star rating, out of 5. | ||
| data[].review_count | integer | No | 1055 | Number of ratings. | ||
| data[].title | string | No | Watch SE (2nd Gen) [GPS 40mm] Smartwatch with Midnight Aluminium Case with Midnight Sport Band S/M. Fitness and Sleep Trackers, Crash Detection, Heart Rate Monitor, Retina Display | Product title as shown on the result card. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/amazon/search?k=apple+watch&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"