Deals

2 min

Deals Results

When making a request with the type parameter 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 on Ebay.

Deals Results Page

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 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 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 . 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