Charts

2 min

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:

{
  "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