Core APIs
...
Results
Specialist Pages

Charts

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