Core API
...
Results
Core Requests
Search
2min
search results when making a request with the type parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/search set to type=search countdown api will return search results from the ebay domain specified in the ebay domain parameter search results are retrieved from the search results page https //www ebay com/sch/i html? nkw=memory+cards on ebay an example of the json object returned from a search request is shown below { "request info" { "success" true, "credits used" 1, "credits remaining" 999 }, "request metadata" { "id" "f78c211030e249334f2741f37cc7f3a884392054", "created at" "2020 01 01t00 00 00 000z", "processed at" "2020 01 01t00 00 00 001z", "total time taken" 0 1, "ebay url" "https //ebay com/sch/i html? nkw=memory+cards& sacat=0" }, "request parameters" { "type" "search", "search term" "memory cards", "ebay domain" "ebay com" }, "search information" { "did you mean" "memory memory", "did you mean results count" 650, "spelling correction" "memory memory", "original search term" "memory cards" }, "search results" \[ { "position" 1, "title" "sandisk ultra 32gb 64gb 128gb 256gb micro sd c10 sdhc sdxc flash memory tf card", "epid" "264141604548", "link" "https //www ebay com/itm/sandisk ultra 32gb 64gb 128gb 256gb micro sd c10 sdhc sdxc flash memory tf card/264141604548", "image" "https //i ebayimg com/thumbs/images/m/mkmhxpfgx1s 1xnpei9rfjw/s l225 webp", "hotness" "518+ sold", "condition" "brand new", "is auction" false, "buy it now" false, "free returns" false, "shipping cost" 3 99, "ended" { "type" "sold", "date" { "raw" "aug 27, 2021" } }, "sponsored" true, "best offer accepted" true, "prices" \[ { "symbol" "$", "value" 7 85, "currency" "usd", "raw" "$7 85", "name" "low" }, { "symbol" "$", "value" 28 85, "currency" "usd", "raw" "$28 85", "name" "high" } ], "price" { "symbol" "$", "value" 7 85, "currency" "usd", "raw" "$7 85", "name" "low" } }, { "position" 2, "title" "sandisk micro sd card 8gb 16gb 32gb memory class 4 android nintendo cell phone", "epid" "264141604548", "link" "https //www ebay com/itm/sandisk ultra 32gb 64gb 128gb 256gb micro sd c10 sdhc sdxc flash memory tf card/264141604548", "image" "https //i ebayimg com/thumbs/images/m/mcib asxcbhbcbo9b3owq2w/s l225 webp", "hotness" "3,025+ sold", "condition" "brand new", "is auction" false, "buy it now" false, "free returns" true, "shipping cost" 2 5, "sponsored" true, "ended" { "type" "sold", "date" { "raw" "jan 1, 2020" } }, "prices" \[ { "symbol" "$", "value" 6 99, "currency" "usd", "raw" "$6 99", "name" "low" }, { "symbol" "$", "value" 9 99, "currency" "usd", "raw" "$9 99", "name" "high" } ], "price" { "symbol" "$", "value" 6 99, "currency" "usd", "raw" "$6 99", "name" "low" } } ], "facets" \[ { "display name" "storage capacity", "values" \[ { "name" "64 gb", "param value" "facets=storage%2520capacity=64+gb", "count" 9689 }, { "name" "32 gb", "param value" "facets=storage%2520capacity=32+gb", "count" 8057 }, { "name" "128 gb", "param value" "facets=storage%2520capacity=128+gb", "count" 7782 }, { "name" "256 gb", "param value" "facets=storage%2520capacity=256+gb", "count" 6703 }, { "name" "1tb", "param value" "facets=storage%2520capacity=1tb", "count" 662 }, { "name" "512 gb", "param value" "facets=storage%2520capacity=512+gb", "count" 1732 }, { "name" "16 gb", "param value" "facets=storage%2520capacity=16+gb", "count" 3924 }, { "name" "8 gb", "param value" "facets=storage%2520capacity=8+gb", "count" 1291 } ], "name" "storage%2520capacity" }, { "display name" "speed class", "values" \[ { "name" "class 10", "param value" "facets=speed%2520class=class+10", "count" 31047 }, { "name" "class 4", "param value" "facets=speed%2520class=class+4", "count" 1148 }, { "name" "a1", "param value" "facets=speed%2520class=a1", "count" 1490 }, { "name" "uhs speed class 1", "param value" "facets=speed%2520class=uhs+speed+class+1", "count" 1782 }, { "name" "class 1", "param value" "facets=speed%2520class=class+1", "count" 430 }, { "name" "uhs speed class 3", "param value" "facets=speed%2520class=uhs+speed+class+3", "count" 297 }, { "name" "class 2", "param value" "facets=speed%2520class=class+2", "count" 72 }, { "name" "class 6", "param value" "facets=speed%2520class=class+6", "count" 52 } ], "name" "speed%2520class" }, { "display name" "brand", "values" \[ { "name" "sandisk", "param value" "facets=brand=sandisk", "count" 10116 }, { "name" "samsung", "param value" "facets=brand=samsung", "count" 3289 }, { "name" "unbranded", "param value" "facets=brand=unbranded", "count" 5558 }, { "name" "kingston", "param value" "facets=brand=kingston", "count" 3306 }, { "name" "sony", "param value" "facets=brand=sony", "count" 54 }, { "name" "vida it", "param value" "facets=brand=vida+it", "count" 2045 }, { "name" "pny", "param value" "facets=brand=pny", "count" 218 }, { "name" "lexar", "param value" "facets=brand=lexar", "count" 436 } ], "name" "brand" }, { "display name" "compatible model", "values" \[ { "name" "universal", "param value" "facets=compatible%2520model=universal", "count" 19988 }, { "name" "for samsung galaxy note8", "param value" "facets=compatible%2520model=for+samsung+galaxy+note8", "count" 594 }, { "name" "for sony xperia z5", "param value" "facets=compatible%2520model=for+sony+xperia+z5", "count" 428 }, { "name" "for htc one m8", "param value" "facets=compatible%2520model=for+htc+one+m8", "count" 426 }, { "name" "for sony xperia z", "param value" "facets=compatible%2520model=for+sony+xperia+z", "count" 397 }, { "name" "for samsung galaxy note", "param value" "facets=compatible%2520model=for+samsung+galaxy+note", "count" 343 }, { "name" "for alcatel fierce xl", "param value" "facets=compatible%2520model=for+alcatel+fierce+xl", "count" 332 }, { "name" "for htc one", "param value" "facets=compatible%2520model=for+htc+one", "count" 328 } ], "name" "compatible%2520model" }, { "display name" "format", "values" \[ { "name" "microsdxc", "param value" "facets=format=microsdxc", "count" 4461 }, { "name" "microsd", "param value" "facets=format=microsd", "count" 21155 }, { "name" "sd", "param value" "facets=format=sd", "count" 1141 }, { "name" "microsdhc", "param value" "facets=format=microsdhc", "count" 5859 }, { "name" "tf", "param value" "facets=format=tf", "count" 711 }, { "name" "microsdxc uhs i", "param value" "facets=format=microsdxc+uhs i", "count" 2290 }, { "name" "sdxc", "param value" "facets=format=sdxc", "count" 953 }, { "name" "sdhc", "param value" "facets=format=sdhc", "count" 851 } ], "name" "format" }, { "display name" "features", "values" \[ { "name" "high speed", "param value" "facets=features=high+speed", "count" 30844 }, { "name" "high capacity", "param value" "facets=features=high+capacity", "count" 21407 }, { "name" "waterproof", "param value" "facets=features=waterproof", "count" 16113 }, { "name" "wi fi", "param value" "facets=features=wi fi", "count" 4209 }, { "name" "not specified", "param value" "facets=features=not+specified", "count" 11813 } ], "name" "features" }, { "display name" "compatible brand", "values" \[ { "name" "universal", "param value" "facets=compatible%2520brand=universal", "count" 22478 }, { "name" "for samsung", "param value" "facets=compatible%2520brand=for+samsung", "count" 5537 }, { "name" "for sony", "param value" "facets=compatible%2520brand=for+sony", "count" 2653 }, { "name" "for lg", "param value" "facets=compatible%2520brand=for+lg", "count" 2534 }, { "name" "for huawei", "param value" "facets=compatible%2520brand=for+huawei", "count" 1913 }, { "name" "for amazon", "param value" "facets=compatible%2520brand=for+amazon", "count" 1887 }, { "name" "for motorola", "param value" "facets=compatible%2520brand=for+motorola", "count" 1836 }, { "name" "for nokia", "param value" "facets=compatible%2520brand=for+nokia", "count" 1665 } ], "name" "compatible%2520brand" }, { "display name" "manufacturer warranty", "values" \[ { "name" "3 months", "param value" "facets=manufacturer%2520warranty=3+months", "count" 9601 }, { "name" "lifetime", "param value" "facets=manufacturer%2520warranty=lifetime", "count" 2785 }, { "name" "yes", "param value" "facets=manufacturer%2520warranty=yes", "count" 1048 }, { "name" "1 month", "param value" "facets=manufacturer%2520warranty=1+month", "count" 986 }, { "name" "10 years", "param value" "facets=manufacturer%2520warranty=10+years", "count" 517 }, { "name" "1 year", "param value" "facets=manufacturer%2520warranty=1+year", "count" 364 }, { "name" "5 years", "param value" "facets=manufacturer%2520warranty=5+years", "count" 288 }, { "name" "no", "param value" "facets=manufacturer%2520warranty=no", "count" 144 } ], "name" "manufacturer%2520warranty" }, { "display name" "country/region of manufacture", "values" \[ { "name" "united states", "param value" "facets=country%252fregion%2520of%2520manufacture=united+states", "count" 9168 }, { "name" "china", "param value" "facets=country%252fregion%2520of%2520manufacture=china", "count" 2473 }, { "name" "taiwan", "param value" "facets=country%252fregion%2520of%2520manufacture=taiwan", "count" 2327 }, { "name" "unknown", "param value" "facets=country%252fregion%2520of%2520manufacture=unknown", "count" 208 }, { "name" "malaysia", "param value" "facets=country%252fregion%2520of%2520manufacture=malaysia", "count" 150 }, { "name" "philippines", "param value" "facets=country%252fregion%2520of%2520manufacture=philippines", "count" 131 }, { "name" "korea, republic of", "param value" "facets=country%252fregion%2520of%2520manufacture=korea,+republic+of", "count" 80 }, { "name" "japan", "param value" "facets=country%252fregion%2520of%2520manufacture=japan", "count" 61 } ], "name" "country%252fregion%2520of%2520manufacture" }, { "display name" "condition", "values" \[] }, { "display name" "price", "values" \[] }, { "display name" "buying format", "values" \[] }, { "display name" "item location", "values" \[ { "name" "default", "param value" "facets=lh prefloc=default" }, { "name" "us only", "param value" "facets=lh prefloc=us+only" }, { "name" "north america", "param value" "facets=lh prefloc=north+america" }, { "name" "worldwide", "param value" "facets=lh prefloc=worldwide" } ], "name" "lh prefloc" }, { "display name" "shipping options", "values" \[ { "name" "free shipping", "param value" "facets=lh fs=free+shipping" } ], "name" "lh fs" }, { "display name" "local pickup", "values" \[ { "name" "free in store pickup", "param value" "facets=lh bopis=free+in store+pickup" }, { "name" "free local pickup", "param value" "facets=lh bopis=free+local+pickup" }, { "name" "zip code", "param value" "facets=lh bopis=zip+code" } ], "name" "lh bopis" }, { "display name" "show only", "values" \[ { "name" "free returns", "param value" "facets=lh fr=free+returns" }, { "name" "returns accepted", "param value" "facets=lh fr=returns+accepted" }, { "name" "authorized seller", "param value" "facets=lh fr=authorized+seller" }, { "name" "completed items", "param value" "facets=lh fr=completed+items" }, { "name" "sold items", "param value" "facets=lh fr=sold+items" }, { "name" "deals & savings", "param value" "facets=lh fr=deals+&+savings" }, { "name" "authenticity guarantee", "param value" "facets=lh fr=authenticity+guarantee" } ], "name" "lh fr" } ], "pagination" { "current page" 1, "total results" "9893", "has next page" true, "next page" 2 } } countdown api returns the following properties for search requests property type description search results array an array of search result objects, containing each of the product results shown on the search results page the search result object has the following properties position number the position of the result on the search results page title string the product name epid string the ebay product id (epid) for the listing link string the product page link image string a link to the image of the product hotness string the value of the 'hotness' entry shown next to the product listing condition string the condition of the product in the listing is auction boolean true/false indicating whether this is an auction format listing buy it now boolean true/false indicating whether this listing offers a buy it now price free returns boolean true/false indicating whether this listing offers free returns sponsored boolean true/false indicating whether this listing is sponsored (i e promoted) best offer accepted boolean set to true when the "best offer accepted" text is shown next to the search result best offer boolean set to true when the "best offer" text is shown next to the search result (different from best offer accepted in that just "best offer" is shown, not "best offer accepted") is rewritten result boolean set to true when this search result appears beneath the "results matching fewer words" banner (meaning the search result doesn't exactly match the search term and has been suggested as an alternative) an example of the "results matching fewer words banner is shown below if you wish to exlude rewritten results use the allow rewritten results=false request parameter item location string the item location, if shown next to the search result rating number the overall rating of the product, out of 5 ratings total number the total number of customer ratings the product has received shipping cost number a number describing the shipping cost of the item prices array prices array the prices array contains details about the products pricing, as shown underneath the product title it is an array of price objects, the properties of which are described below symbol string the currency symbol, i e $ for usd value number the price of the offer currency string the currency of the offer as a iso 4217 https //en wikipedia org/wiki/iso 4217 currency code raw string the raw price as displayed on the offer listing name string the name of the price if applicable, for example "low" and "high" in the case of a range price if the name property is empty then this price is the only price shown against the product ended object ended object an object describing how the listing ended, if shown typically displayed when the completed items=true request parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/search is used the properties of the ended object are described below type string set to ended when the listing was shown as "ended", set to sold when the listing was shown as "sold" can be used as an indicator of whether listing ended naturally, or resulted in a sale date object an object describing the date on which the listing ended naturally or was sold contains a string property raw containing the raw date string of the listing end as shown next to the search result seller info object seller info object an object with seller information retrieved from page name string name of ebay seller account review count number total number of reviews positive feedback percent number percent of positive reviews for seller price object a price object representing the first item in the prices array this is normally the "main" or "lowest" (in the case of a range) price for the product and is included as a convienience to make extracting the main price easier facets array facet object an array containing details of any available search facets (refinements) shown on the search result page you can use the facets returned here to refine your query by supplying facet information into the facets request parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/search each object in the facets array contains the following properties name string the name of the facet (can be used in the facets request parameter) display name string the display name of the facet (i e the user facing name) values array facet values array the facet values array shows the values of the given facet, along with the number of products matching that facet value name string the facet value, can be used in the facets request parameter count number the count of the number of products that match this facet value in the current search results, if shown (omitted if not shown or zero) param value string the example value of a subsequent requests facets parameter to filter the results to this facet value pagination object an object containing details of the current search results page and the total number of results 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/search current page number the current page number total results number the total number of results available for the given search has next page boolean true / false as to whether a next page of search results is available next page number the page number of the next page of results can be used in a subsequent type=search requests' page parameter to request search results from the next page search information object an object containing details any spelling corrections or redirections applied to the search results original search term string populated with the original search term did you mean string populated with the "did you mean" spelling correction shown when a misspelled search term is provided and ebay has suggested a different search term but not automatically redirected to that search term did you mean results count number the estimated number of search results from the "did you mean" suggested search term spelling correction string populated with the search term ebay automatically redirected the search results to in the case of the original search term not yielding any results next steps search parameters https //docs trajectdata com/countdownapi/ebay product data api/parameters/search