---
title: Reviews
slug: countdownapi/ebay-product-data-api/results/reviews
docTags:
createdAt: 2024-07-29T12:49:20.016Z
---
# 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:
```json
{
"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:
:::hint{type="info"}
**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.
-
1. `name`
2. `string`
3. The name of the product attribute i.e. "Capacity".
-
1. `value`
2. `string`
3. 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)