Core API
...
Core Requests
Search
2 min
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 true falsefalse left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type next steps search parameters https //docs trajectdata com/countdownapi/ebay product data api/parameters/search