Amazon API endpoint
Returns one page of a ranked Amazon chart (Best Sellers, New Releases, or Most Wished For) for a department or department subcategory on `amazon.com`. Discover valid department/node values with amazon-charts-categories.
/amazon/chartsQuery parameters:
chart: required. Chart type. Allowed values: best_sellers, new_releases, most_wished_for.department: required. Amazon department slug. Example: electronics.node: optional. Numeric browse node id scoping the chart to one of the department's subcategories. Example: 172541.page: optional. 1-based page number, default 1. Amazon charts are capped at a small number of pages per category; requesting a page past the last one returns a not-found error.Notable behavior:
department — the department-less root chart page is a department picker, not a product listing, so it is rejected rather than returned as an empty/misleading chart.| Field | Filled in, of 30 checked | Values in the sample |
|---|---|---|
| rank | 30 | 1 to 30, median 15 |
| asin | 30 | |
| title | 30 | median 125 characters |
| link | 30 | amazon.com |
| image | 30 | images-na.ssl-images-amazon.com |
| price | 30 | 5.99 to 424.99, median 39.99 |
| rating | 30 | 4 to 4.7, median 4.5 |
| review_count | 30 | 162 to 571,259, median 22,147 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| chart | string | Yes | Chart type Allowed values: best_sellers, new_releases, most_wished_for. | best_sellers | |
| department | string | Yes | Amazon department slug | electronics | |
| node | string | No | Numeric browse node id | 172541 | |
| 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/charts?chart=best_sellers&department=electronics&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"chart": "best_sellers",
"department": "electronics",
"category_name": "Electronics",
"page": 1,
"has_next_page": true,
"source_url": "https://www.amazon.com/gp/bestsellers/electronics",
"items": [
{
"rank": 1,
"asin": "B08JHCVHTY",
"title": "Blink Plus Plan with monthly auto-renewal",
"link": "https://www.amazon.com/dp/B08JHCVHTY/",
"image": "https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL300_SR300,200_.png",
"price": 11.99,
"rating": 4.4,
"review_count": 280227
}
]
}
}Request schema
No body schema
Response schema
#/definitions/amazon.chartsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | amazon.ChartResponse | No | ||||
| data.category_name | string | No | Electronics | |||
| data.chart | string | No | best_sellers | |||
| data.department | string | No | electronics | |||
| data.has_next_page | boolean | No | true | |||
| data.items | array | No | ||||
| data.items[].asin | string | No | B08JHCVHTY | |||
| data.items[].image | string | No | https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL300_SR300,200_.png | |||
| data.items[].link | string | No | https://www.amazon.com/dp/B08JHCVHTY/ | |||
| data.items[].price | number | No | 11.99 | |||
| data.items[].rank | integer | No | 1 | |||
| data.items[].rating | number | No | 4.4 | |||
| data.items[].review_count | integer | No | 280227 | |||
| data.items[].title | string | No | Blink Plus Plan with monthly auto-renewal | |||
| data.node | string | No | 172541 | |||
| data.page | integer | No | 1 | |||
| data.source_url | string | No | https://www.amazon.com/gp/bestsellers/electronics | |||
| 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/charts?chart=best_sellers&department=electronics&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"