Deals

deals results when making a request with the type parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/deals set to type=deals countdown api will return deals results from the ebay deals page specified in the url parameter deals results are retrieved from the deals results page https //www ebay com/deals on ebay an example of the json object returned from a deals 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 //www ebay com/deals" }, "request parameters" { "type" "deals", "url" "https //www ebay com/deals" }, "categories" \[ { "name" "sun sational deals", "link" "https //www ebay com/deals/featured/sun sational deals" }, { "name" "use code techsave10 for 10% off on back to school tech", "link" "https //www ebay com/deals/featured/use code techsave10 for 10 off on back to school tech" }, { "name" "use code fashionsave25 for 25% off back to school fashion", "link" "https //www ebay com/deals/featured/use code fashionsave25 for 25 off back to school fashion" }, { "name" "use code homesave15 for 15% off back to school home and decór", "link" "https //www ebay com/deals/featured/use code homesave15 for 15 off back to school home and decor" }, { "name" "adidas back to school items up to 60% off", "link" "https //www ebay com/deals/featured/adidas back to school items up to 60 off" }, { "name" "up to 70% off ebay refurbished tech", "link" "https //www ebay com/deals/featured/up to 70 off ebay refurbished tech" }, { "name" "up to 70% off ebay refurbished home & garden", "link" "https //www ebay com/deals/featured/up to 70 off ebay refurbished home garden" }, { "name" "trending sneakers for a steal", "link" "https //www ebay com/deals/featured/trending sneakers for a steal" }, { "name" "up to 40% off best tech items", "link" "https //www ebay com/deals/featured/up to 40 off best tech items" }, { "name" "best of home & garden", "link" "https //www ebay com/deals/featured/best of home garden" }, { "name" "up to 70% off refurbished smartphones, tablets, and more", "link" "https //www ebay com/deals/featured/up to 70 off refurbished smartphones tablets and more" }, { "name" "hot summer fashion deals for her up to 60% off", "link" "https //www ebay com/deals/featured/hot summer fashion deals for her up to 60 off" }, { "name" "watches exclusively from jomashop", "link" "https //www ebay com/deals/featured/watches exclusively from jomashop" }, { "name" "make a splash with deep tech discounts", "link" "https //www ebay com/deals/featured/make a splash with deep tech discounts" }, { "name" "get the most out of summer with new sunny sports gear", "link" "https //www ebay com/deals/featured/get the most out of summer with new sunny sports gear" }, { "name" "luxury watch labor day sale", "link" "https //www ebay com/deals/featured/luxury watch labor day sale" }, { "name" "top rated bullion deals", "link" "https //www ebay com/deals/featured/top rated bullion deals" }, { "name" "up to 50% off your next deck", "link" "https //www ebay com/deals/featured/up to 50 off your next deck" }, { "name" "best of motors", "link" "https //www ebay com/deals/featured/best of motors" }, { "name" "up to 60% off summer fragrances", "link" "https //www ebay com/deals/featured/up to 60 off summer fragrances" } ], "deals results" \[ { "position" 1, "title" "hp 17 cn1053cl 17 3\\" fhd ips laptop intel core i5 1155g7 12gb 1tb win10 4s324ua", "link" "https //www ebay com/itm/165544504451? trkparms=5373%3a0%7c5374%3afeatured", "epid" "165544504451", "image" "https //i ebayimg com/images/g/vnoaaoswmstis49y/s l400 jpg", "price" { "value" 349 99, "raw" "$349 99", "currency" "usd" }, "was price" { "value" 899 99, "raw" "$899 99", "currency" "usd" }, "type" "spotlight deal", "page" "1", "position overall" 1 }, { "position" 2, "title" "lenovo flex 3 chromebook 11 6\\" hd touch screen laptop mediatek mt8183 4 ", "link" "https //www ebay com/itm/203977362824? trkparms=5373%3a0%7c5374%3afeatured", "epid" "203977362824", "image" "https //i ebayimg com/images/g/uueaaoswzkvimhxl/s l300 jpg", "type" "trending deal", "hotness" "almost gone", "page" "1", "position overall" 2 }, { "position" 3, "title" "lenovo ideapad gaming 3 laptop 15 6\\" 120hz i5 11300h 8gb ram 512gb ssd gtx 1650", "link" "https //www ebay com/itm/304548952395? trkparms=5373%3a0%7c5374%3afeatured", "epid" "304548952395", "image" "https //i ebayimg com/images/g/lboaaoswqvjivg7x/s l300 jpg", "price" { "value" 529 99, "raw" "$529 99", "currency" "usd" }, "was price" { "value" 880 99, "raw" "$880 99", "currency" "usd" }, "type" "trending deal", "page" "1", "position overall" 3 }, { "position" 4, "title" "6 piece bed sheets deep pocket microfiber comfort 1800 series printed sheet set", "link" "https //www ebay com/itm/263034094173? trkparms=5373%3a0%7c5374%3afeatured", "epid" "263034094173", "image" "https //i ebayimg com/images/g/uduaaoswc7hiigae/s l300 jpg", "price" { "value" 9 99, "raw" "$9 99", "currency" "usd" }, "was price" { "value" 87 86, "raw" "$87 86", "currency" "usd" }, "type" "trending deal", "page" "1", "position overall" 4 }, { "position" 5, "title" "adidas originals ultraboost slip on dna shoes women's", "link" "https //www ebay com/itm/154926682565? trkparms=5373%3a0%7c5374%3afeatured", "epid" "154926682565", "image" "https //i ebayimg com/images/g/skqaaoswmgpi2u1u/s l300 jpg", "price" { "value" 114, "raw" "$114 00", "currency" "usd" }, "was price" { "value" 190, "raw" "$190 00", "currency" "usd" }, "type" "trending deal", "page" "1", "position overall" 5 }, { "position" 6, "title" "soundcore life dot 2 xr true wireless earbuds noise cancelling in ear headphones", "link" "https //www ebay com/itm/384343398732? trkparms=5373%3a0%7c5374%3afeatured", "epid" "384343398732", "image" "https //i ebayimg com/images/g/e70aaosw2hdixift/s l300 jpg", "price" { "value" 29 99, "raw" "$29 99", "currency" "usd" }, "was price" { "value" 99 99, "raw" "$99 99", "currency" "usd" }, "type" "trending deal", "page" "1", "position overall" 6 } ], "pagination" { "pages" \[ { "current page" 1, "has next page" true }, { "current page" 2, "has next page" true } ] } } countdown api returns the following properties for search requests property type description deals results array an array of deal result objects, containing each of the product results shown on the deals results page the deal result object has the following properties position number the position of the result on the deals 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 deal price object a price object representing the price of the deal contains raw , value and currency properties was price object a was price object representing the strikethrough was price of the deal contains raw , value and currency properties type string the type of deal (showing the heading, if any, the deal is classified under on the deals page) values are spotlight deal , trending deal , featured deal , category deal category name string in the case of type=category deal , category name contains the name of the category category link string in the case of type=category deal , category link contains the link of the deals category can be passed in a subsequent type=deals requests' url parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/deals to retrieve deals results from that category categories array an array of sub categories shown on the deals page can be passed in a subsequent type=deals requests' url parameter https //docs trajectdata com/countdownapi/ebay product data api/parameters/deals to retrieve deals results from that category name string the name of the category link string the link to the category 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/deals current page number the current page number 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=deals requests' page parameter to request deals results from the next page next steps deals parameters https //docs trajectdata com/countdownapi/ebay product data api/parameters/deals