---
title: Deals
slug: countdownapi/ebay-product-data-api/results/deals
docTags:
createdAt: 2024-07-29T12:49:20.016Z
---
# 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:
```json
{
"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)