Amazon Book Charts API Documentation
The Amazon Book Charts API returns Amazon's weekly book charts: the top 20 most sold and most read books in fiction and nonfiction. Each book comes with its rank, weeks on the chart, rank movement, rating and its Kindle and audiobook editions, for the latest week or any past week.
API Parameters
Chart
-
- Name
-
chart_type - Required
- Optional
- Description
-
Parameter defines which chart to retrieve. Available values:
most_sold- default. Books ranked by copies sold and pre-ordered.most_read- Books ranked by how many customers read them each day.
-
- Name
-
category - Required
- Optional
- Description
-
Parameter defines the book category of the chart. Available values:
fiction(default) andnonfiction.
-
- Name
-
week - Required
- Optional
- Description
-
Parameter defines the chart week, as any day of that week in
YYYY-MM-DDformat (e.g.2026-11-08). Each chart counts the days from Monday to Sunday and is dated by that Sunday. Defaults to the latest published week. Weeks go back to May 2017 onamazon.com, September 2018 onamazon.caand July 2019 onamazon.co.ukandamazon.de.
Localization
-
- Name
-
amazon_domain - Required
- Optional
- Description
-
Parameter defines the Amazon domain of the chart. Amazon Book Charts is available on
amazon.com(default),amazon.ca,amazon.co.ukandamazon.de, each with its own lists.
-
- Name
-
language - Required
- Optional
- Description
-
Parameter defines the display language. Available values depend on
amazon_domain:en_USandes_USonamazon.com,en_CAandfr_CAonamazon.ca,en_GBonamazon.co.uk,de_DEanden_GBonamazon.de.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
amazon_book_charts.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?engine=amazon_book_charts&week=2026-11-08
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "amazon_book_charts",
"week": "2026-11-08"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_XwVQDxe9T8m6FeoyFMtkxpSt",
"status": "Success",
"created_at": "2026-11-17T18:00:00Z",
"request_time_taken": 1.42,
"parsing_time_taken": 0.05,
"total_time_taken": 1.47,
"request_url": "https://www.amazon.com/charts/2026-11-08/mostsold/fiction",
"html_url": "https://www.searchapi.io/api/v1/searches/search_XwVQDxe9T8m6FeoyFMtkxpSt.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_XwVQDxe9T8m6FeoyFMtkxpSt"
},
"search_parameters": {
"engine": "amazon_book_charts",
"chart_type": "most_sold",
"category": "fiction",
"week": "2026-11-08",
"amazon_domain": "amazon.com"
},
"chart_information": {
"chart_type": "most_sold",
"category": "fiction",
"week": "2026-11-08",
"previous_week": "2026-11-01"
},
"books": [
{
"position": 1,
"asin": "B0GR711WBV",
"title": "A Court of Splintered Harmony",
"link": "https://www.amazon.com/dp/B0GR711WBV",
"thumbnail": "https://m.media-amazon.com/images/I/810PuG+z0hL.jpg",
"author": "Sarah J. Maas",
"rating": 4.2,
"reviews": 45968,
"weeks_on_chart": 17,
"kindle_asin": "B0GR711WBV",
"audiobook_asin": "B0GR6QBV2B",
"audiobook_sample": "https://samples.audible.com/bk/reco/021898/bk_reco_021898_sample.mp3"
},
"..."
]
}
Most Sold Nonfiction
https://www.searchapi.io/api/v1/search?category=nonfiction&engine=amazon_book_charts&week=2026-11-08
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "amazon_book_charts",
"category": "nonfiction",
"week": "2026-11-08"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_gf1NVTEAHy2h5FC2n1tnVCpu",
"status": "Success",
"created_at": "2026-11-17T18:00:00Z",
"request_time_taken": 1.42,
"parsing_time_taken": 0.05,
"total_time_taken": 1.47,
"request_url": "https://www.amazon.com/charts/2026-11-08/mostsold/nonfiction",
"html_url": "https://www.searchapi.io/api/v1/searches/search_gf1NVTEAHy2h5FC2n1tnVCpu.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_gf1NVTEAHy2h5FC2n1tnVCpu"
},
"search_parameters": {
"engine": "amazon_book_charts",
"chart_type": "most_sold",
"category": "nonfiction",
"week": "2026-11-08",
"amazon_domain": "amazon.com"
},
"chart_information": {
"chart_type": "most_sold",
"category": "nonfiction",
"week": "2026-11-08",
"previous_week": "2026-11-01"
},
"books": [
{
"position": 1,
"asin": "1400356822",
"title": "Contend",
"link": "https://www.amazon.com/dp/1400356822",
"thumbnail": "https://m.media-amazon.com/images/I/812qlvJI8hL.jpg",
"author": "Philip Anthony Mitchell",
"rating": 4.9,
"reviews": 1336,
"weeks_on_chart": 8,
"previous_position": 2,
"kindle_asin": "B0GRGM5G1Z",
"audiobook_asin": "B0GRGF7QPB",
"audiobook_sample": "https://samples.audible.com/bk/tnwd/004234/bk_tnwd_004234_sample.mp3"
},
"..."
]
}
Chart on Another Amazon Domain
https://www.searchapi.io/api/v1/search?amazon_domain=amazon.de&category=nonfiction&engine=amazon_book_charts&week=2026-11-08
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "amazon_book_charts",
"category": "nonfiction",
"week": "2026-11-08",
"amazon_domain": "amazon.de"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_x4SWzo7oHuwAw4jej4gjhdLg",
"status": "Success",
"created_at": "2026-11-17T18:00:00Z",
"request_time_taken": 1.42,
"parsing_time_taken": 0.05,
"total_time_taken": 1.47,
"request_url": "https://www.amazon.de/charts/2026-11-08/mostsold/nonfiction",
"html_url": "https://www.searchapi.io/api/v1/searches/search_x4SWzo7oHuwAw4jej4gjhdLg.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_x4SWzo7oHuwAw4jej4gjhdLg"
},
"search_parameters": {
"engine": "amazon_book_charts",
"chart_type": "most_sold",
"category": "nonfiction",
"week": "2026-11-08",
"amazon_domain": "amazon.de"
},
"chart_information": {
"chart_type": "most_sold",
"category": "nonfiction",
"week": "2026-11-08",
"previous_week": "2026-11-01"
},
"books": [
{
"position": 1,
"asin": "374231002X",
"title": "Murdoku",
"link": "https://www.amazon.de/dp/374231002X",
"thumbnail": "https://m.media-amazon.com/images/I/71ahDaBQQKL.jpg",
"author": "Manuel Garand",
"rating": 4.7,
"reviews": 710,
"weeks_on_chart": 24
},
"..."
]
}