Core API
...
Parameters
Customer Feedback
Reviews
4 min
reviews parameters get get /request 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 lookup an epid by gtin / isbn / upc / ean countdown api can automatically convert gtin/isbn/upc/ean codes to epids and return reviews data for that gtin for details of how to lookup ebay product details by gtin/isbn/upc/ean please see refer to the guide https //docs trajectdata com/countdownapi/ebay product data api/reference/gtin upc ean to epid for example, to request customer reviews, sorted by "most recent", for the epid 1522036563 on ebay com the request would be http https //api countdownapi com/request?api key=demo\&type=reviews\&ebay domain=ebay com\&epid=1522036563\&sort by=most recentcurl l get https //api countdownapi com/request \\ d api key="demo" \\ d type="reviews" \\ d ebay domain="ebay com" \\ d epid="1522036563" \\ d sort by="most recent"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "reviews", ebay domain "ebay com", epid "1522036563", sort by "most recent" } // make the http get request to countdown api axios get('https //api countdownapi com/request', { params }) then(response => { // print the json response from countdown api console log(json stringify(response data, 0, 2)); }) catch(error => { // catch and print the error console log(error); })import requests import json \# set up the request parameters params = { 'api key' 'demo', 'type' 'reviews', 'ebay domain' 'ebay com', 'epid' '1522036563', 'sort by' 'most recent' } \# make the http get request to countdown api api result = requests get('https //api countdownapi com/request', params) \# print the json response from countdown api print(json dumps(api result json()))\<?php \# set up the request parameters $querystring = http build query(\[ 'api key' => 'demo', 'type' => 'reviews', 'ebay domain' => 'ebay com', 'epid' => '1522036563', 'sort by' => 'most recent' ]); \# make the http get request to countdown api $ch = curl init(sprintf('%s?%s', 'https //api countdownapi com/request', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); $api result = curl exec($ch); curl close($ch); \# print the json response from countdown api echo $api result; ?> reviews parameters the following parameters are available for all requests made when type=reviews parameter required description ebay domain optional the ebay domain to retrieve reviews for the product specified in the epid parameter from for a full list of supported ebay domains see supported ebay domains https //docs trajectdata com/countdownapi/ebay product data api/reference/ebay domains note if the ebay domain and epid parameters are supplied then the url parameter is ignored epid optional the ebay epid (product id) to retrieve reviews for used in combination with the ebay domain parameter note if the epid and ebay domain parameters are supplied then the url parameter is ignored gtin optional a gtin, isbn, upc or ean code to retrieve results for internally countdown api will first convert the gtin/isbn/upc/ean to an ebay epid, then retrieve the results for that epid from ebay used in combination with the ebay domain parameter note if the gtin and ebay domain parameters are supplied then the url parameter is ignored skip gtin cache optional by default countdown api will cache the gtin to epid mapping for 2 months to force a new gtin lookup (for example, if you suspect the existing mapping is stale), use the skip gtin cache=true request parameter (note that using skip gtin cache=true decrements 2 credits from your balance, instead of 1) url optional the ebay product page url to retrieve reviews from note if the url parameter is supplied then the ebay domain and epid parameters are ignored condition optional determines product condition reviews are filtered to valid values are all returns reviews of products in all conditions new returns reviews of new products refurbished returns reviews of refurbished products preowned returns reviews of pre owned products sort by optional determines the sort order of reviews to return valid values are most relevant returns reviews in order of relevancy to the search term most recent returns reviews in date order, with the most recent first rating high to low returns reviews ordered by rating, high to low rating low to high returns reviews ordered by rating, low to high search term optional a search term to use to search reviews page optional the current page of reviews to retrieve inspect the pagination total pages property in the reviews results https //docs trajectdata com/countdownapi/ebay product data api/results/reviews to see how many pages of reviews are available max page optional use the max page parameter to get multiple pages of results in one request the api will automatically paginate through pages and concatenate the results into one response see the pagination https //docs trajectdata com/countdownapi/ebay product data api/pagination docs for more information next steps reviews results https //docs trajectdata com/countdownapi/ebay product data api/results/reviews