---
title: Charts
slug: rainforestapi/product-data-api/results/charts
docTags:
createdAt: 2024-07-30T12:48:41.129Z
---
# Charts Results
When making a request with the `type` [parameter](https://docs.trajectdata.com/rainforestapi/product-data-api/parameters/charts) set to `type=charts` Rainforest API will return Charts results for given Charts page `url` .
Charts results are retrieved from the [charts page](https://www.amazon.com/charts) on Amazon.
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"
}
}
```
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](https://docs.trajectdata.com/rainforestapi/product-data-api/parameters/charts)