Reviews

3 min

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 for a single product on Ebay.

Customer Reviews Page

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.

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 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 . 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 . 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