Amazon Book Charts API Documentation

GET   /api/v1/search?engine=amazon_book_charts

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) and nonfiction.

  • Name
    week
    Required
    Optional
    Description

    Parameter defines the chart week, as any day of that week in YYYY-MM-DD format (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 on amazon.com, September 2018 on amazon.ca and July 2019 on amazon.co.uk and amazon.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.uk and amazon.de, each with its own lists.

  • Name
    language
    Required
    Optional
    Description

    Parameter defines the display language. Available values depend on amazon_domain: en_US and es_US on amazon.com, en_CA and fr_CA on amazon.ca, en_GB on amazon.co.uk, de_DE and en_GB on amazon.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_key authenticates 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 true to 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

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=amazon_book_charts&week=2026-11-08
Request
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)
Response
{
  "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

Most Sold Nonfiction
GET
https://www.searchapi.io/api/v1/search?category=nonfiction&engine=amazon_book_charts&week=2026-11-08
Request
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)
Response
{
  "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

Chart on Another Amazon Domain
GET
https://www.searchapi.io/api/v1/search?amazon_domain=amazon.de&category=nonfiction&engine=amazon_book_charts&week=2026-11-08
Request
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)
Response
{
  "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
    },
    "..."
  ]
}