Core API
...
Results
Customer Feedback

Reviews

3min
reviews results the reviews parameters are applicable when making a request with type=reviews to retrieve customer reviews for a single product on ebay the product is specified using either the epid and ebay domain parameters or the url parameter (where the url parameter contains a link to an ebay product page) the parameters should be appended as querystring parameters to the ebay product data api get http request reviews are retrieved from the customer reviews page https //www ebay com/urw/product reviews/1522036563 for a single product on ebay an example of the json object returned from a reviews request is shown below { "request info" { "success" true, "credits used" 1, "credits remaining" 999 }, "request metadata" { "id" "54cc09fd13451b514834c57b6c550331af52181c", "created at" "2020 01 01t00 00 00 000z", "processed at" "2020 01 01t00 00 00 001z", "total time taken" 0 1, "ebay url" "https //www ebay com/urw/product reviews/1522036563" }, "request parameters" { "type" "reviews", "ebay domain" "ebay com", "epid" "1522036563" }, "product" { "title" "kingston micro sdhc class 4 16gb memory card (sdc4/16gb)", "link" "https //www ebay com/urw/product reviews/1522036563? fcid=3#" }, "summary" { "rating" 4 7, "ratings total" 843, "reviews total" 565, "rating breakdown" { "5 star" 716, "4 star" 81, "3 star" 23, "2 star" 4, "1 star" 19 } }, "top favourable" { "id" "10000000264239225", "title" "reliable and steady", "body" "currently using in a raspberry pi, the card seems to be resilient albeit not very fast (class 4) raspberry pis have a tendency to corrupt sensitive sd cards if not shut down before power loss so far, so good, despite recent local power failures which indicates card is ok much cheaper and appears to be more robust than a class 10 but slower ", "rating" 4, "date" { "raw" "dec 20, 2018", "utc" "2018 12 20t12 00 00 000z" }, "profile" { "name" "brev01", "link" "http //www ebay com/usr/brev01" }, "verified purchase" true, "seller name" "premium247", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "premium247" } ], "helpful votes" 1, "unhelpful votes" 0 }, "top critical" { "id" "10000000277273247", "title" "fine but slow", "body" "product is good for simple use like for saving photos and videos this is not suitable for developers if you want to use it for raspberry pi projects dont buy this due to slow right speed ", "rating" 3, "date" { "raw" "oct 09, 2019", "utc" "2019 10 09t11 00 00 000z" }, "profile" { "name" "2012muscat00", "link" "http //www ebay com/usr/2012muscat00" }, "verified purchase" true, "seller name" "themobilehutt", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "themobilehutt" } ], "helpful votes" 1, "unhelpful votes" 0 }, "reviews" \[ { "id" "10000000264239225", "title" "reliable and steady", "body" "currently using in a raspberry pi, the card seems to be resilient albeit not very fast (class 4) raspberry pis have a tendency to corrupt sensitive sd cards if not shut down before power loss so far, so good, despite recent local power failures which indicates card is ok much cheaper and appears to be more robust than a class 10 but slower ", "rating" 4, "date" { "raw" "dec 20, 2018", "utc" "2018 12 20t12 00 00 000z" }, "profile" { "name" "brev01", "link" "http //www ebay com/usr/brev01" }, "verified purchase" true, "seller name" "premium247", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "premium247" } ], "helpful votes" 1, "unhelpful votes" 0 }, { "id" "10000000277273247", "title" "fine but slow", "body" "product is good for simple use like for saving photos and videos this is not suitable for developers if you want to use it for raspberry pi projects dont buy this due to slow right speed ", "rating" 3, "date" { "raw" "oct 09, 2019", "utc" "2019 10 09t11 00 00 000z" }, "profile" { "name" "2012muscat00", "link" "http //www ebay com/usr/2012muscat00" }, "verified purchase" true, "seller name" "themobilehutt", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "themobilehutt" } ], "helpful votes" 1, "unhelpful votes" 0 }, { "id" "10000000269258114", "title" "works as expected, good storage capacity, possible ocd", "body" "free postage, cheap, does what you expect it to i really don't know why i'm writing this review i haven't even used the sd card properly yet it's probably undiagnosed ocd but when ebay or amazon ask me to i just really need to write one and has a good looking box/packaging!", "rating" 5, "date" { "raw" "mar 31, 2019", "utc" "2019 03 31t11 00 00 000z" }, "profile" { "name" "harjohlan 1", "link" "http //www ebay com/usr/harjohlan 1" }, "verified purchase" true, "seller name" "premium247", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "premium247" } ], "helpful votes" 1, "unhelpful votes" 3 }, { "id" "10000000259429559", "title" "16gb micro sd card", "body" "great memory card some electronics still won't take a 32gb, or handle it well, this is the next best thing works perfectly in my sport cams as 32gbca failed miserably great value for the cost effective solution option ", "rating" 5, "date" { "raw" "sep 13, 2018", "utc" "2018 09 13t11 00 00 000z" }, "profile" { "name" "dwelb1", "link" "http //www ebay com/usr/dwelb1" }, "verified purchase" true, "seller name" "365daystechshop", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "365daystechshop" } ], "helpful votes" 1, "unhelpful votes" 0 }, { "id" "10000000259427262", "title" "good", "body" "exactly what i needed, fits in my phone and has a decent amount of storage on it not the exact amount advertised, a little less, but it's good for the job and i'm happy with it ", "rating" 5, "date" { "raw" "sep 13, 2018", "utc" "2018 09 13t11 00 00 000z" }, "profile" { "name" "tishtash92", "link" "http //www ebay com/usr/tishtash92" }, "verified purchase" true, "seller name" "365daystechshop", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "365daystechshop" } ], "helpful votes" 1, "unhelpful votes" 0 }, { "id" "10000000257453538", "title" "can't be faulted šŸ‘", "body" "these memory cards are excellent value for money and work brilliantly so i bought another one a few days later and will more than likely buy a few more in future i highly recommend šŸ‘šŸ‘šŸ‘šŸ‘šŸ‘", "rating" 5, "date" { "raw" "aug 04, 2018", "utc" "2018 08 04t11 00 00 000z" }, "profile" { "name" "eardl steve", "link" "http //www ebay com/usr/eardl steve" }, "verified purchase" true, "seller name" "security specia ", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "security specia " } ], "helpful votes" 1, "unhelpful votes" 0 }, { "id" "10000000259799512", "title" "memory card", "body" "this product works very well, it is a known make & reliable, it s performance is adequate & fast a good purchase ", "rating" 5, "date" { "raw" "sep 21, 2018", "utc" "2018 09 21t11 00 00 000z" }, "profile" { "name" "lampwick46", "link" "http //www ebay com/usr/lampwick46" }, "verified purchase" true, "seller name" "365daystechshop", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "365daystechshop" } ], "helpful votes" 0, "unhelpful votes" 0 }, { "id" "10000000265343150", "title" "a bargain", "body" "i bought this memory card works great , very easy to use and set up , well worth the money i paid for it , will buy again", "rating" 5, "date" { "raw" "jan 12, 2019", "utc" "2019 01 12t12 00 00 000z" }, "profile" { "name" "hanna bower", "link" "http //www ebay com/usr/hanna bower" }, "verified purchase" true, "seller name" "premium247", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "premium247" } ], "helpful votes" 0, "unhelpful votes" 0 }, { "id" "10000000258685817", "title" "memory card", "body" "this product is perfect for my phone, gives me lots of room for new photos so i don't have to keep deleting photos off my old memory card, i would recommend this item ", "rating" 5, "date" { "raw" "aug 29, 2018", "utc" "2018 08 29t11 00 00 000z" }, "profile" { "name" "nor4100 x4ezswpmt", "link" "http //www ebay com/usr/nor4100 x4ezswpmt" }, "verified purchase" true, "seller name" "ebargains11", "attributes" \[ { "name" "verified purchase", "value" "yes" }, { "name" "condition", "value" "new" }, { "name" "sold by", "value" "ebargains11" } ], "helpful votes" 0, "unhelpful votes" 0 }, { "id" "10000000176941180", "title" "i will be more cautious when buying memory cards in the future", "body" "this kingston micro sdhc card initially did not work with the new mp3 player i bought when plugged in to the computer to transfer the music i was asked to format the disc when i started the procedure with windows 7 w7 would only recognize, formatting to 4gb i checked with microsoft and kingston and, on the internet( which showed a lot of people with the same problem) ms have an update for xp but, not guaranteed nothing foe w7 and kingston nothing the supplier was good about the situation and would have accepted a return my concern suppliers of these cards, should have something written in their advertising!it would also be an advantage if product manufacturers had a protocol that the equipment automatically formats when a new memory card is installed as my camera ", "rating" 3, "date" { "raw" "mar 02, 2013", "utc" "2013 03 02t12 00 00 000z" }, "profile" { "name" "nivleko10", "link" "http //www ebay com/usr/nivleko10" }, "helpful votes" 0, "unhelpful votes" 0 } ], "pagination" { "current page" 1, "next page link" "https //www ebay com/urw/kingston micro sdhc class 4 16gb memory card sdc4 16gb /product reviews/1522036563? fcid=3\&pgn=2", "total reviews" 565 } } countdown api returns the following properties for reviews requests paginating results ebay returns 10 reviews per page to request more reviews issue additional requests incrementing the page parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/reviews property type description reviews array an array of review objects, containing each of the customer reviews shown on the customer reviews page the review object has the following properties id string the unique, ebay assigned, id of the customer review this can be used by your app to flag whether you have previously processed this review on a prior request title string the title of the review body string the body text of the review rating number the product rating given by the reviewer, out of 5 helpful votes number the number of helpful votes this review has received from other ebay customers unhelpful votes number the number of unhelpful votes this review has received from other ebay customers verified purchase boolean whether this reviewer is an ebay verified purchaser of the product seller name string the name of the ebay seller who sold the product this reviewer reviewed attributes array attributes array the attributes array contains details of the product attributes as shown underneath the product title on the customer reviews page name string the name of the product attribute i e "capacity" value string the value of the product attribute i e "128 gb" date object the date object contains details about the date of the review raw string the raw date as retrieved from the ebay page utc string the date of the review, parsed from the raw date, in iso 8601 https //en wikipedia org/wiki/iso 8601 format if countdown api cannot parse the raw date then this property will be null profile object the profile object contains details of the profile of the reviewer name string the reviewer's profile name link string a link to the reviewer's profile page on the ebay domain top favourable object the most helpful favourable customer review the properties of the top favourable object are identical to the review object above top critical object the most helpful critical customer review the properties of the top critical object are identical to the review object above product object an object containing details of the product (in so far as those details are shown on the customer reviews page) for full product details you should issue a request with type=product to retrieve details from the product page https //docs trajectdata com/countdownapi/ebay product data api/results/product title string the product name link string the product page link summary object an object containing a summary of all reviews for the product, as shown at the top left of the customer reviews page rating number the overall rating of the product, out of 5 ratings total number the total number of customer ratings the product has received reviews total number the total number of customer reviews the product has received reviews breakdown object an object containing the total number of customer ratings the product has received, per star rating pagination object an object containing details of the current reviews page and the total number of reviews pages that are available to paginate you should specify the page number in your request's page parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/reviews current page number the current page number total reviews number the total number of reviews available next page link string a link to the next page of reviews can be used to determine whether additional reviews are available and whether a subsequent pagination request is required next steps reviews parameters https //docs trajectdata com/countdownapi/ebay product data api/parameters/reviews