Core API
...
Parameters
Core Requests
Product
4 min
product parameters get get /request the product parameters are applicable when making a request with type=product to retrieve details of 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 product details are retrieved from the product page https //www ebay co uk/itm/233599133856 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 product data 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 details for the epid 233599133856 on ebay com the request would be http https //api countdownapi com/request?api key=demo\&type=product\&ebay domain=ebay com\&epid=233599133856curl l get https //api countdownapi com/request \\ d api key="demo" \\ d type="product" \\ d ebay domain="ebay com" \\ d epid="233599133856"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "product", ebay domain "ebay com", epid "233599133856" } // 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' 'product', 'ebay domain' 'ebay com', 'epid' '233599133856' } \# 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' => 'product', 'ebay domain' => 'ebay com', 'epid' => '233599133856' ]); \# 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; ?> product parameters the following parameters are available for all requests made when type=product parameter required description ebay domain optional the ebay domain to retrieve product details from for the product specified in the epid parameter 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 product details 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 product details from note if the url parameter is supplied then the ebay domain and epid parameters are ignored include html optional determines whether raw html is included in the response (this can increase the size of the response) can be set to true or false (the default) note when adding requests with include html=true to a collection the maximum number of requests is lower (100) because including the html within the response makes the collection result sets much larger the limit is in place to ensure result set files are of a manageable size if you have need to run a large number of requests all with include html=true then simply split the requests across multiple 100 request collections include parts compatibility optional determines whether countdown returns the parts compatibility property as part of the product request the parts compatibility properties are typically shown in the descriptive section of the ebay product listing page for example, a compatibility table showing the vehicle a particular part is compatible with (screenshot shown below) note when include parts compatibility=true 2 credits are charged instead of 1 for the request (this is due to the increased number of internal requests required to retrieve parts compatibility attributes) note when include parts compatibility=true is only available on ebay us or ebay uk (i e when ebay domain=ebay com or ebay domain=ebay co uk ) note when include parts compatibility=true the epid parameter must be supplied (as it is required for parts compatibility lookup) the url parameter cannot be used when include parts compatibility=true next steps product results https //docs trajectdata com/countdownapi/ebay product data api/results/product