Charts

2min
Charts Results
When making a request with the  type  parameter set to  type=charts  Rainforest API will return Charts results for given Charts page  url .
Charts results are retrieved from the charts page on Amazon.
Charts Page
﻿
An example of the JSON object returned from a Charts request is shown below:
JSON
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "130fc2e6a878ee40070c093a678b135b4a3eee7b",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "amazon_url": "https://www.amazon.com/charts"
  },
  "request_parameters": {
    "type": "charts",
    "url": "https://www.amazon.com/charts"
  },
  "charts_results": [
    {
      "title": "Project Hail Mary",
      "position": 1,
      "asin": "B08GB58KD5",
      "link": "https://www.amazon.com/dp/B08GB58KD5",
      "weeks_on_chart": 8,
      "author": "Andy Weir",
      "publisher": "Ballantine Books",
      "rating": 4.7,
      "ratings_total": 17762
    },
    {
      "title": "Harry Potter and the Sorcerer's Stone",
      "position": 2,
      "asin": "B017V4IMVQ",
      "link": "https://www.amazon.com/dp/B017V4IMVQ",
      "weeks_on_chart": 216,
      "author": "J.K. Rowling",
      "publisher": "Pottermore Publishing",
      "rating": 4.8,
      "ratings_total": 10706,
      "last_week_position": 3
    },
    {
      "title": "Harry Potter and the Order of the Phoenix",
      "position": 3,
      "asin": "B017WO2UR2",
      "link": "https://www.amazon.com/dp/B017WO2UR2",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.6,
      "ratings_total": 2023564,
      "last_week_position": 2
    },
    {
      "title": "Harry Potter and the Goblet of Fire",
      "position": 4,
      "asin": "B017WJH0VI",
      "link": "https://www.amazon.com/dp/B017WJH0VI",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 22598
    },
    {
      "title": "The Last Thing He Told Me",
      "position": 5,
      "asin": "B091J6C9KH",
      "link": "https://www.amazon.com/dp/B091J6C9KH",
      "weeks_on_chart": 8,
      "author": "Laura Dave",
      "publisher": "Simon & Schuster",
      "rating": 4.3,
      "ratings_total": 15901
    },
    {
      "title": "Harry Potter and the Deathly Hallows",
      "position": 6,
      "asin": "B017WPI9Z8",
      "link": "https://www.amazon.com/dp/B017WPI9Z8",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 26630,
      "last_week_position": 7
    },
    {
      "title": "Harry Potter and the Half-Blood Prince",
      "position": 7,
      "asin": "B017WOSHCY",
      "link": "https://www.amazon.com/dp/B017WOSHCY",
      "weeks_on_chart": 215,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 25179,
      "last_week_position": 8
    },
    {
      "title": "The Four Winds",
      "position": 8,
      "asin": "B0882VNQKS",
      "link": "https://www.amazon.com/dp/B0882VNQKS",
      "weeks_on_chart": 21,
      "author": "Kristin Hannah",
      "publisher": "St. Martin's Press",
      "rating": 4.5,
      "ratings_total": 60379,
      "last_week_position": 6
    },
    {
      "title": "Harry Potter and the Prisoner of Azkaban",
      "position": 9,
      "asin": "B017WGJNRK",
      "link": "https://www.amazon.com/dp/B017WGJNRK",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 29635
    },
    {
      "title": "Malibu Rising",
      "position": 10,
      "asin": "B08L9QD4NH",
      "link": "https://www.amazon.com/dp/B08L9QD4NH",
      "weeks_on_chart": 3,
      "author": "Taylor Jenkins Reid",
      "publisher": "Ballantine Books",
      "rating": 4.3,
      "ratings_total": 4626,
      "last_week_position": 13
    },
    {
      "title": "Harry Potter and the Chamber of Secrets",
      "position": 11,
      "asin": "B017V66EYQ",
      "link": "https://www.amazon.com/dp/B017V66EYQ",
      "weeks_on_chart": 193,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 30922,
      "last_week_position": 10
    },
    {
      "title": "The Midnight Library",
      "position": 12,
      "asin": "B085LHVPW8",
      "link": "https://www.amazon.com/dp/B085LHVPW8",
      "weeks_on_chart": 23,
      "author": "Matt Haig",
      "publisher": "Viking",
      "rating": 4.4,
      "ratings_total": 90126
    },
    {
      "title": "Rhythm of War",
      "position": 13,
      "asin": "B082MLHB9M",
      "link": "https://www.amazon.com/dp/B082MLHB9M",
      "weeks_on_chart": 32,
      "author": "Brandon Sanderson",
      "publisher": "Tor Books",
      "rating": 4.8,
      "ratings_total": 24245,
      "last_week_position": 11
    },
    {
      "title": "The President's Daughter",
      "position": 14,
      "asin": "B089DMG5M6",
      "link": "https://www.amazon.com/dp/B089DMG5M6",
      "weeks_on_chart": 2,
      "author": "Bill Clinton & James Patterson",
      "publisher": "Little, Brown and Company and Knopf",
      "rating": 4.7,
      "ratings_total": 4181,
      "last_week_position": 16
    },
    {
      "title": "Golden Girl",
      "position": 15,
      "asin": "B08YLK6W85",
      "link": "https://www.amazon.com/dp/B08YLK6W85",
      "weeks_on_chart": 3,
      "author": "Elin Hilderbrand",
      "publisher": "Little, Brown and Company",
      "rating": 4.6,
      "ratings_total": 6080
    },
    {
      "title": "Breakaway",
      "position": 16,
      "asin": "B08XGH8B79",
      "link": "https://www.amazon.com/dp/B08XGH8B79",
      "weeks_on_chart": 4,
      "author": "Craig Alanson",
      "publisher": "Independently published",
      "rating": 4.7,
      "ratings_total": 1346,
      "last_week_position": 14
    },
    {
      "title": "Choose Me",
      "position": 17,
      "asin": "B08WQ6MD9C",
      "link": "https://www.amazon.com/dp/B08WQ6MD9C",
      "weeks_on_chart": 3,
      "author": "Meg Ruley",
      "publisher": "Thomas & Mercer",
      "rating": 4.2,
      "ratings_total": 9583,
      "last_week_position": 20
    },
    {
      "title": "Where the Crawdads Sing",
      "position": 18,
      "asin": "B07FSXPMHY",
      "link": "https://www.amazon.com/dp/B07FSXPMHY",
      "weeks_on_chart": 116,
      "author": "Russell Galen",
      "publisher": "G.P. Putnam's Sons",
      "rating": 4.6,
      "ratings_total": 2023564
    },
    {
      "title": "People We Meet on Vacation",
      "position": 19,
      "asin": "B08GQC9P7Q",
      "link": "https://www.amazon.com/dp/B08GQC9P7Q",
      "author": "Emily Henry",
      "publisher": "Berkley",
      "rating": 4.4,
      "ratings_total": 5442
    },
    {
      "title": "Freed",
      "position": 20,
      "asin": "B08Y97CJQV",
      "link": "https://www.amazon.com/dp/B08Y97CJQV",
      "weeks_on_chart": 4,
      "author": "E L James",
      "publisher": "Bloom Books",
      "rating": 4.7,
      "ratings_total": 3553,
      "last_week_position": 17
    }
  ],
  "chart_info": {
    "title": "The Top 20 Most Sold & Most Read Books of the Week",
    "type": "MOST READ",
    "category": "FICTION",
    "time_period": "June 27, 2021"
  }
}
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "130fc2e6a878ee40070c093a678b135b4a3eee7b",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "amazon_url": "https://www.amazon.com/charts"
  },
  "request_parameters": {
    "type": "charts",
    "url": "https://www.amazon.com/charts"
  },
  "charts_results": [
    {
      "title": "Project Hail Mary",
      "position": 1,
      "asin": "B08GB58KD5",
      "link": "https://www.amazon.com/dp/B08GB58KD5",
      "weeks_on_chart": 8,
      "author": "Andy Weir",
      "publisher": "Ballantine Books",
      "rating": 4.7,
      "ratings_total": 17762
    },
    {
      "title": "Harry Potter and the Sorcerer's Stone",
      "position": 2,
      "asin": "B017V4IMVQ",
      "link": "https://www.amazon.com/dp/B017V4IMVQ",
      "weeks_on_chart": 216,
      "author": "J.K. Rowling",
      "publisher": "Pottermore Publishing",
      "rating": 4.8,
      "ratings_total": 10706,
      "last_week_position": 3
    },
    {
      "title": "Harry Potter and the Order of the Phoenix",
      "position": 3,
      "asin": "B017WO2UR2",
      "link": "https://www.amazon.com/dp/B017WO2UR2",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.6,
      "ratings_total": 2023564,
      "last_week_position": 2
    },
    {
      "title": "Harry Potter and the Goblet of Fire",
      "position": 4,
      "asin": "B017WJH0VI",
      "link": "https://www.amazon.com/dp/B017WJH0VI",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 22598
    },
    {
      "title": "The Last Thing He Told Me",
      "position": 5,
      "asin": "B091J6C9KH",
      "link": "https://www.amazon.com/dp/B091J6C9KH",
      "weeks_on_chart": 8,
      "author": "Laura Dave",
      "publisher": "Simon & Schuster",
      "rating": 4.3,
      "ratings_total": 15901
    },
    {
      "title": "Harry Potter and the Deathly Hallows",
      "position": 6,
      "asin": "B017WPI9Z8",
      "link": "https://www.amazon.com/dp/B017WPI9Z8",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 26630,
      "last_week_position": 7
    },
    {
      "title": "Harry Potter and the Half-Blood Prince",
      "position": 7,
      "asin": "B017WOSHCY",
      "link": "https://www.amazon.com/dp/B017WOSHCY",
      "weeks_on_chart": 215,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 25179,
      "last_week_position": 8
    },
    {
      "title": "The Four Winds",
      "position": 8,
      "asin": "B0882VNQKS",
      "link": "https://www.amazon.com/dp/B0882VNQKS",
      "weeks_on_chart": 21,
      "author": "Kristin Hannah",
      "publisher": "St. Martin's Press",
      "rating": 4.5,
      "ratings_total": 60379,
      "last_week_position": 6
    },
    {
      "title": "Harry Potter and the Prisoner of Azkaban",
      "position": 9,
      "asin": "B017WGJNRK",
      "link": "https://www.amazon.com/dp/B017WGJNRK",
      "weeks_on_chart": 216,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 29635
    },
    {
      "title": "Malibu Rising",
      "position": 10,
      "asin": "B08L9QD4NH",
      "link": "https://www.amazon.com/dp/B08L9QD4NH",
      "weeks_on_chart": 3,
      "author": "Taylor Jenkins Reid",
      "publisher": "Ballantine Books",
      "rating": 4.3,
      "ratings_total": 4626,
      "last_week_position": 13
    },
    {
      "title": "Harry Potter and the Chamber of Secrets",
      "position": 11,
      "asin": "B017V66EYQ",
      "link": "https://www.amazon.com/dp/B017V66EYQ",
      "weeks_on_chart": 193,
      "author": "Neil Blair",
      "publisher": "Pottermore Publishing",
      "rating": 4.9,
      "ratings_total": 30922,
      "last_week_position": 10
    },
    {
      "title": "The Midnight Library",
      "position": 12,
      "asin": "B085LHVPW8",
      "link": "https://www.amazon.com/dp/B085LHVPW8",
      "weeks_on_chart": 23,
      "author": "Matt Haig",
      "publisher": "Viking",
      "rating": 4.4,
      "ratings_total": 90126
    },
    {
      "title": "Rhythm of War",
      "position": 13,
      "asin": "B082MLHB9M",
      "link": "https://www.amazon.com/dp/B082MLHB9M",
      "weeks_on_chart": 32,
      "author": "Brandon Sanderson",
      "publisher": "Tor Books",
      "rating": 4.8,
      "ratings_total": 24245,
      "last_week_position": 11
    },
    {
      "title": "The President's Daughter",
      "position": 14,
      "asin": "B089DMG5M6",
      "link": "https://www.amazon.com/dp/B089DMG5M6",
      "weeks_on_chart": 2,
      "author": "Bill Clinton & James Patterson",
      "publisher": "Little, Brown and Company and Knopf",
      "rating": 4.7,
      "ratings_total": 4181,
      "last_week_position": 16
    },
    {
      "title": "Golden Girl",
      "position": 15,
      "asin": "B08YLK6W85",
      "link": "https://www.amazon.com/dp/B08YLK6W85",
      "weeks_on_chart": 3,
      "author": "Elin Hilderbrand",
      "publisher": "Little, Brown and Company",
      "rating": 4.6,
      "ratings_total": 6080
    },
    {
      "title": "Breakaway",
      "position": 16,
      "asin": "B08XGH8B79",
      "link": "https://www.amazon.com/dp/B08XGH8B79",
      "weeks_on_chart": 4,
      "author": "Craig Alanson",
      "publisher": "Independently published",
      "rating": 4.7,
      "ratings_total": 1346,
      "last_week_position": 14
    },
    {
      "title": "Choose Me",
      "position": 17,
      "asin": "B08WQ6MD9C",
      "link": "https://www.amazon.com/dp/B08WQ6MD9C",
      "weeks_on_chart": 3,
      "author": "Meg Ruley",
      "publisher": "Thomas & Mercer",
      "rating": 4.2,
      "ratings_total": 9583,
      "last_week_position": 20
    },
    {
      "title": "Where the Crawdads Sing",
      "position": 18,
      "asin": "B07FSXPMHY",
      "link": "https://www.amazon.com/dp/B07FSXPMHY",
      "weeks_on_chart": 116,
      "author": "Russell Galen",
      "publisher": "G.P. Putnam's Sons",
      "rating": 4.6,
      "ratings_total": 2023564
    },
    {
      "title": "People We Meet on Vacation",
      "position": 19,
      "asin": "B08GQC9P7Q",
      "link": "https://www.amazon.com/dp/B08GQC9P7Q",
      "author": "Emily Henry",
      "publisher": "Berkley",
      "rating": 4.4,
      "ratings_total": 5442
    },
    {
      "title": "Freed",
      "position": 20,
      "asin": "B08Y97CJQV",
      "link": "https://www.amazon.com/dp/B08Y97CJQV",
      "weeks_on_chart": 4,
      "author": "E L James",
      "publisher": "Bloom Books",
      "rating": 4.7,
      "ratings_total": 3553,
      "last_week_position": 17
    }
  ],
  "chart_info": {
    "title": "The Top 20 Most Sold & Most Read Books of the Week",
    "type": "MOST READ",
    "category": "FICTION",
    "time_period": "June 27, 2021"
  }
}
﻿
Rainforest API returns the following properties for Charts requests:
Property
Type
Description
chart_results
array
An array containing details of the products in the chart. Each object in the array contains the following properties:
position
number
The position of the product in the chart.
﻿
weeks_on_chart
number
The number of weeks this product has been on the chart.
﻿
last_week_position
number
The position the product has on this chart last week, if shown.
﻿
title
string
The title of the product.
﻿
link
string
The link to the product page.
﻿
asin
string
The ASIN of the product.
﻿
image
string
A link to the image of the product.
﻿
rating
number
The overall rating of the product, out of 5.
﻿
ratings_total
number
The total number of customer ratings the product has received.
﻿
author
string
The author of the product, if available.
﻿
agent
string
The agent for the product, if available.
﻿
publisher
string
The publisher of the product, if available.
chart_info
object
An object containing information about the chart.
title
string
The title of the chart.
﻿
type
string
The type of the chart i.e. "Most Read".
﻿
category
string
The category of the chart i.e. "Fiction".
﻿
time_period
string
The time period of the chart.
﻿
Next Steps
     Charts Parameters﻿
Property	Type	Description
chart_results	array	An array containing details of the products in the chart. Each object in the array contains the following properties: position number The position of the product in the chart. weeks_on_chart number The number of weeks this product has been on the chart. last_week_position number The position the product has on this chart last week, if shown. title string The title of the product. link string The link to the product page. asin string The ASIN of the product. image string A link to the image of the product. rating number The overall rating of the product, out of 5. ratings_total number The total number of customer ratings the product has received. author string The author of the product, if available. agent string The agent for the product, if available. publisher string The publisher of the product, if available.
chart_info	object	An object containing information about the chart. title string The title of the chart. type string The type of the chart i.e. "Most Read". category string The category of the chart i.e. "Fiction". time_period string The time period of the chart.
Updated 11 Aug 2024
Did this page help you?
Brand Stores
Formats & Editions