---
title: Product
slug: countdownapi/ebay-product-data-api/results/product
docTags:
createdAt: 2024-07-29T12:49:20.016Z
---
# Product Results
When making a request with the `type` [parameter](https://docs.trajectdata.com/countdownapi/ebay-product-data-api/parameters/product) set to `type=product` Countdown API will return product details for the product specified in either the `epid` and `ebay_domain` parameters or the `url` parameter. You can also request make a `type=product` by specifying a GTIN, EAN, ISBN or UPC code in the `gtin` parameter.
:::hint{type="info"}
**Master Pages vs. Individual Listing Pages**
There are two types of product pages that Countdown API can return data from. A **Master Page** shows a summary of all listings for a known product summerized in the `top_picks` array - i.e. "listings for the 'Nest Cam Indoor' product" and an Individual Listing Page will show detail for an individual listing.
Master Pages are denoted by `is_master=true` in the response and Individual Listing Pages are denoted by `is_master=false` in the response.
Countdown API will automatically detect the type of product page when the request is run, there is no difference in the request parameters required and no need to know what type of product page you're requesting ahead of running the request.
Master Pages and Individual Listing Pages have different results schemas, which are detailed below.
:::
***
### Master Page Results
Master Pages (see [example here](https://www.ebay.com/p/3105882?_fcid=1)) show multiple offers in the `top_picks` array for a single, known product.
Typically the offers shown will be for different `conditions` - i.e. new, used, preowned, auction etc and contain links to the Individual Listing Pages for the given listings. Master Pages can be identified by `is_master=true` in the response.
An example of the JSON object returned from an Product request referencing a Master Page is shown below:
```json
{
"request_info": {
"success": true,
"credits_used": 1,
"credits_remaining": 999
},
"request_metadata": {
"id": "48d63ef58b3eb240d5b18115b674c4170faba51f",
"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/p/3105882?_fcid=1"
},
"request_parameters": {
"type": "product",
"ebay_domain": "ebay.com",
"gtin": "075678234422"
},
"is_master": true,
"top_picks": [
{
"product": {
"title": "We Can't Dance by Genesis (CD, Nov-1991, Atlantic (Label))",
"epid": "324374817802",
"link": "https://www.ebay.com/itm/We-Cant-Dance-by-Genesis-CD-Nov-1991-Atlantic-Label-/324374817802",
"attributes": [
{
"name": "Producer",
"value": "Phil Collins, Nick Davis, Genesis, Mike Rutherford, Tony Banks"
},
{
"name": "Record Label",
"value": "Atlantic"
},
{
"name": "UPC",
"value": "0075678234422"
},
{
"name": "Ebay Product ID (ePID)",
"value": "3105882"
},
{
"name": "Release Year",
"value": "1991"
},
{
"name": "Style",
"value": "Progressive/Art Rock"
},
{
"name": "Genre",
"value": "Rock, Art Rock, Rock & Pop"
},
{
"name": "Artist",
"value": "Genesis"
},
{
"name": "Format",
"value": "CD"
},
{
"name": "Distributor",
"value": "Wea (Distributor)"
},
{
"name": "Recording Mode",
"value": "Stereo"
},
{
"name": "Release Date",
"value": "19911112"
},
{
"name": "Duration",
"value": "71min."
},
{
"name": "Spar CODE",
"value": "N/A"
},
{
"name": "Recording Type",
"value": "Studio"
}
],
"gtin": "0075678234422"
},
"all_listings": {
"link": "http://www.ebay.com/sch/i.html?_sop=15&_pmc=true&isRefine=true&_productid=3105882&LH_ItemCondition=1000&rt=nc",
"count": 6
},
"seller": {
"name": "lytecordz",
"link": "https://www.ebay.com/usr/lytecordz",
"feedback_score": 15618,
"positive_feedback_percent": 98.8
},
"shipping": {
"raw": "+ $18.90 Addl. Costs",
"price": 18.9,
"currency": "USD",
"location": "Sparks, NV",
"delivery_estimate": "Thu, Jan 28 - Mon, Feb 1"
},
"condition": {
"raw": "Brand new: Lowest price",
"name": "brand_new_lowest_price",
"is_new": true,
"is_used": false
},
"is_auction": false,
"offer": {
"price": 14.62,
"raw": "$14.62",
"currency": "USD"
}
},
{
"product": {
"title": "We Can't Dance, Genesis",
"epid": "183808957214",
"link": "https://www.ebay.com/itm/We-Cant-Dance-Genesis-/183808957214",
"attributes": [
{
"name": "Producer",
"value": "Phil Collins, Nick Davis, Genesis, Mike Rutherford, Tony Banks"
},
{
"name": "Record Label",
"value": "Atlantic"
},
{
"name": "UPC",
"value": "0075678234422"
},
{
"name": "Ebay Product ID (ePID)",
"value": "3105882"
},
{
"name": "Release Year",
"value": "1991"
},
{
"name": "Style",
"value": "Progressive/Art Rock"
},
{
"name": "Genre",
"value": "Rock, Art Rock, Rock & Pop"
},
{
"name": "Artist",
"value": "Genesis"
},
{
"name": "Format",
"value": "CD"
},
{
"name": "Distributor",
"value": "Wea (Distributor)"
},
{
"name": "Recording Mode",
"value": "Stereo"
},
{
"name": "Release Date",
"value": "19911112"
},
{
"name": "Duration",
"value": "71min."
},
{
"name": "Spar CODE",
"value": "N/A"
},
{
"name": "Recording Type",
"value": "Studio"
}
],
"gtin": "0075678234422"
},
"all_listings": {
"link": "http://www.ebay.com/sch/i.html?_sop=15&_pmc=true&isRefine=true&_productid=3105882&LH_ItemCondition=1500|1750|2750&rt=nc",
"count": 67
},
"seller": {
"name": "*gopeachy*",
"link": "https://www.ebay.com/usr/*gopeachy*",
"feedback_score": 182377,
"positive_feedback_percent": 98.4
},
"shipping": {
"raw": "+ $6.00 Shipping",
"price": 6,
"currency": "USD",
"location": "Jacksonville, Florida",
"delivery_estimate": "Mon, Feb 1 - Thu, Feb 25"
},
"condition": {
"raw": "New (other): Lowest price",
"name": "other_new_lowest_price",
"is_new": true,
"is_used": false
},
"is_auction": false,
"offer": {
"price": 4.89,
"raw": "$4.89",
"currency": "USD"
}
},
{
"product": {
"title": "We Can't Dance, Genesis, Very Good Audio CD",
"epid": "164048194873",
"link": "https://www.ebay.com/itm/We-Cant-Dance-Genesis-Very-Good-Audio-CD-/164048194873",
"attributes": [
{
"name": "Producer",
"value": "Phil Collins, Nick Davis, Genesis, Mike Rutherford, Tony Banks"
},
{
"name": "Record Label",
"value": "Atlantic"
},
{
"name": "UPC",
"value": "0075678234422"
},
{
"name": "Ebay Product ID (ePID)",
"value": "3105882"
},
{
"name": "Release Year",
"value": "1991"
},
{
"name": "Style",
"value": "Progressive/Art Rock"
},
{
"name": "Genre",
"value": "Rock, Art Rock, Rock & Pop"
},
{
"name": "Artist",
"value": "Genesis"
},
{
"name": "Format",
"value": "CD"
},
{
"name": "Distributor",
"value": "Wea (Distributor)"
},
{
"name": "Recording Mode",
"value": "Stereo"
},
{
"name": "Release Date",
"value": "19911112"
},
{
"name": "Duration",
"value": "71min."
},
{
"name": "Spar CODE",
"value": "N/A"
},
{
"name": "Recording Type",
"value": "Studio"
}
],
"gtin": "0075678234422"
},
"all_listings": {
"link": "http://www.ebay.com/sch/i.html?_sop=15&_pmc=true&isRefine=true&_productid=3105882&LH_ItemCondition=3000|4000|5000|6000&rt=nc",
"count": 147
},
"seller": {
"name": "schoolkids_records",
"link": "https://www.ebay.com/usr/schoolkids_records",
"feedback_score": 926,
"positive_feedback_percent": 99.8
},
"shipping": {
"raw": "+ $5.29 Shipping",
"price": 5.29,
"currency": "USD",
"location": "Raleigh, North Carolina",
"delivery_estimate": "Tue, Feb 2 - Fri, Feb 26"
},
"condition": {
"raw": "Pre-owned: Lowest price",
"name": "pre_owned_lowest_price",
"is_new": false,
"is_used": true
},
"is_auction": false,
"offer": {
"price": 1.91,
"raw": "$1.91",
"currency": "USD"
}
},
{
"product": {
"title": "Genesis - We Can't Dance (CD, Atlantic) Jesus Knows Me, Never A Time",
"epid": "293866660285",
"link": "https://www.ebay.com/itm/Genesis-We-Cant-Dance-CD-Atlantic-Jesus-Knows-Me-Never-A-Time-/293866660285",
"attributes": [
{
"name": "Producer",
"value": "Phil Collins, Nick Davis, Genesis, Mike Rutherford, Tony Banks"
},
{
"name": "Record Label",
"value": "Atlantic"
},
{
"name": "UPC",
"value": "0075678234422"
},
{
"name": "Ebay Product ID (ePID)",
"value": "3105882"
},
{
"name": "Release Year",
"value": "1991"
},
{
"name": "Style",
"value": "Progressive/Art Rock"
},
{
"name": "Genre",
"value": "Rock, Art Rock, Rock & Pop"
},
{
"name": "Artist",
"value": "Genesis"
},
{
"name": "Format",
"value": "CD"
},
{
"name": "Distributor",
"value": "Wea (Distributor)"
},
{
"name": "Recording Mode",
"value": "Stereo"
},
{
"name": "Release Date",
"value": "19911112"
},
{
"name": "Duration",
"value": "71min."
},
{
"name": "Spar CODE",
"value": "N/A"
},
{
"name": "Recording Type",
"value": "Studio"
}
],
"gtin": "0075678234422"
},
"all_listings": {
"link": "http://www.ebay.com/sch/i.html?_sop=15&_pmc=true&LH_BO=1&isRefine=true&_productid=3105882&LH_ItemCondition=1000|2750|1750|1500|2000|3000|4000|5000|2500|6000|7000&rt=nc",
"count": 74
},
"seller": {
"name": "detricksound",
"link": "https://www.ebay.com/usr/detricksound",
"feedback_score": 16753,
"positive_feedback_percent": 99.8
},
"shipping": {
"raw": "+ $6.95 Shipping",
"price": 6.95,
"currency": "USD",
"delivery_estimate": "Columbus, Ohio"
},
"condition": {
"raw": "Make an offer: Pre-owned",
"name": "pre_owned_make_an_offer",
"is_new": false,
"is_used": true
},
"is_auction": false,
"offer": {
"price": 0.99,
"raw": "$0.99",
"currency": "USD"
}
},
{
"product": {
"title": "Genesis - We Can't Dance (CD, Nov-1991, Atlantic, Original Mix)",
"epid": "324450782974",
"link": "https://www.ebay.com/itm/Genesis-We-Cant-Dance-CD-Nov-1991-Atlantic-Original-Mix-/324450782974",
"attributes": [
{
"name": "Producer",
"value": "Phil Collins, Nick Davis, Genesis, Mike Rutherford, Tony Banks"
},
{
"name": "Record Label",
"value": "Atlantic"
},
{
"name": "UPC",
"value": "0075678234422"
},
{
"name": "Ebay Product ID (ePID)",
"value": "3105882"
},
{
"name": "Release Year",
"value": "1991"
},
{
"name": "Style",
"value": "Progressive/Art Rock"
},
{
"name": "Genre",
"value": "Rock, Art Rock, Rock & Pop"
},
{
"name": "Artist",
"value": "Genesis"
},
{
"name": "Format",
"value": "CD"
},
{
"name": "Distributor",
"value": "Wea (Distributor)"
},
{
"name": "Recording Mode",
"value": "Stereo"
},
{
"name": "Release Date",
"value": "19911112"
},
{
"name": "Duration",
"value": "71min."
},
{
"name": "Spar CODE",
"value": "N/A"
},
{
"name": "Recording Type",
"value": "Studio"
}
],
"gtin": "0075678234422"
},
"all_listings": {
"link": "http://www.ebay.com/sch/i.html?_sop=1&_pmc=true&isRefine=true&LH_Auction=1&_productid=3105882&LH_ItemCondition=1000|2750|1750|1500|2000|3000|4000|5000|2500|6000|7000&rt=nc",
"count": 7
},
"seller": {
"name": "ilovepickles78",
"link": "https://www.ebay.com/usr/ilovepickles78",
"feedback_score": 999,
"positive_feedback_percent": 100
},
"shipping": {
"raw": "+ $23.65 Addl. Costs",
"price": 23.65,
"currency": "USD",
"location": "Houston, Texas",
"delivery_estimate": "Mon, Feb 1 - Tue, Feb 9"
},
"condition": {
"raw": "Auction: Pre-owned",
"name": "pre_owned_auction",
"is_new": false,
"is_used": true
},
"is_auction": true,
"offer": {
"price": 3.99,
"raw": "$3.99",
"currency": "USD"
}
}
]
}
```
Countdown API returns the following properties for Master Page Product requests (i.e. when `is_master=true` ):
| *`Property`* | *`Type`* | *`Description`* |
| ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *`is_master`* | *`boolean`* | A boolean set to `true` indicating that this is a Master Product page. |
| *`sold_out`* | *`boolean`* | A boolean set to `true` when all selling channels for the product in this Master Product page are currently sold out. Corresponds to the "Currently Sold Out" message on the Master Product page.
-
:inlineImage[]{src="https://apiimages.imgix.net/countdownapi/images/png/docs/countdownapi_sold_out.png?auto=format&ixlib=react-9.5.1-beta.1&w=180" alt caption} |
| *`top_picks`* | *`array`* | An array containing all of the Top Picks as shown on the Master Product page.
The `top_picks` array will be populated with objects containing the same properties as shown on an Individual Listing page (see the Individual Listing page response schema below).
Typically a Top Pick will be shown for each condition of listing shown on the Master Page - i.e. one for brand new, one for pre-owned, one for used, one for auction, etc.
Inspect the `top_picks.condition.name` property to see the description of the Top Pick condition. |
***
### Individual Listing Page Results
Individual Listing Pages (see [example here](https://www.ebay.com/itm/233599133856?_fcid=1) contain details of an individual listing. Individual Listing Pages can be identified by `is_master=false` in the response.
An example of the JSON object returned from an Product request referencing an Individual Listing Page is shown below:
```json
{
"request_info": {
"success": true,
"credits_used": 1,
"credits_remaining": 999
},
"request_metadata": {
"id": "48d63ef58b3eb240d5b18115b674c4170faba51f",
"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/itm/233599133856?_fcid=1"
},
"request_parameters": {
"type": "product",
"ebay_domain": "ebay.com",
"epid": "233599133856"
},
"is_master": false,
"is_auction": true,
"product": {
"title": "Sandisk Micro SD Card Ultra Memory Card 32GB 64GB 128GB Smartphones Tablet lot",
"attributes": [
{
"name": "MPN",
"value": "does not apply"
},
{
"name": "Brand",
"value": "SanDisk"
},
{
"name": "Compatible Brand",
"value": "Universal"
},
{
"name": "Series",
"value": "Ultra"
},
{
"name": "Storage Capacity",
"value": "128 GB"
},
{
"name": "Format",
"value": "MicroSD"
},
{
"name": "Speed Class",
"value": "Class 10"
},
{
"name": "Features",
"value": "High Capacity, High Speed, Waterproof"
}
],
"description": "Balmain Underpants",
"description_external_url": "https://vi.vipr.ebaydesc.com/ws/eBayISAPI.dll?ViewItemDescV4&item=185574140039&t=0&category=57989&seller=onihasotof_59&excSoj=1&excTrk=1&lsite=0&ittenable=false&domain=ebay.com&descgauge=1&cspheader=1&oneClk=2&secureDesc=1",
"model_number": "does not apply",
"brand": "SanDisk",
"epid": "233599133856",
"spid": "2047675",
"categories": [
{
"name": "Cell Phones & Accessories",
"link": "https://www.ebay.com/b/Cell-Phones-Accessories-/15032"
},
{
"name": "Cell Phone Accessories",
"link": "https://www.ebay.com/b/Cell-Phone-Accessories-/9394"
},
{
"name": "Memory Cards",
"link": "https://www.ebay.com/b/Memory-Cards-/96991"
}
],
"images": [
{
"link": "https://i.ebayimg.com/images/g/AswAAOSwPMley-Gz/s-l300.jpg"
},
{
"link": "https://i.ebayimg.com/images/g/9L8AAOSwd~Fey-G5/s-l300.jpg"
},
{
"link": "https://i.ebayimg.com/images/g/CL4AAOSwu0Fey-G9/s-l300.jpg"
},
{
"link": "https://i.ebayimg.com/images/g/9rgAAOSw42Fey-HB/s-l300.jpg"
},
{
"link": "https://i.ebayimg.com/images/g/V2gAAOSwAM5ey-Jh/s-l300.jpg"
},
{
"link": "https://i.ebayimg.com/images/g/sfkAAOSwk2Jey-Jn/s-l300.jpg"
},
{
"link": "https://i.ebayimg.com/images/g/q00AAOSwqCdey-Jt/s-l300.jpg"
},
{
"link": "https://i.ebayimg.com/images/g/npYAAOSwI9ley-J8/s-l300.jpg"
}
],
"image_count": 8,
"primary_image": "https://i.ebayimg.com/images/g/AswAAOSwPMley-Gz/s-l300.jpg",
"last_updated": "Dec 25, 2020 17:02:13 PST",
"variants": [
{
"name": "Size: US 8.5 / EU 42 Color: White",
"attributes": [
{
"name": "Size",
"value": "US 8.5 / EU 42"
},
{
"name": "Color",
"value": "White"
}
],
"image": "https://i.ebayimg.com/images/g/mVoAAOSwL6dhAITW/s-l500.jpg",
"epid": "433278779849",
"price": 20.63,
"currency": "USD",
"stock_status": {
"status": "in_stock",
"quantity_sold": 64,
"quantity_available": 2482
}
},
{
"name": "Size: US 8 / EU 41 Color: White",
"attributes": [
{
"name": "Size",
"value": "US 8 / EU 41"
},
{
"name": "Color",
"value": "White"
}
],
"image": "https://i.ebayimg.com/images/g/mVoAAOSwL6dhAITW/s-l500.jpg",
"epid": "433278779848",
"price": 19.64,
"currency": "USD",
"stock_status": {
"status": "in_stock",
"quantity_sold": 55,
"quantity_available": 2445
}
}
]
},
"returns_policy": {
"raw": "30 day returns. Buyer pays for return shipping",
"returns_accepted": true
},
"stock_status": {
"raw": "https://schema.org/InStock",
"status": "in_stock",
"quantity_available": 10,
"quantity_sold": 4760
},
"condition": {
"raw": "New",
"name": "new",
"description": "A brand-new, unused, unopened, undamaged item in its original packaging (where packaging is applicable). Packaging should be the same as what is found in a retail store, unless the item is handmade or was packaged by the manufacturer in non-retail packaging, such as an unprinted box or plastic bag. See the seller's listing for full details.",
"is_new": true,
"is_used": false
},
"auction": {
"time_left": {
"raw": "6d 15h"
},
"end_date": {
"raw": 1611041068000,
"utc": "2021-01-19T07:24:28.000Z"
},
"bids": 3,
"winning_bid_price_raw": "C $127.59",
"winning_bid_price": 127.59,
"winning_bid_price_converted_raw": "Approximately US $99.57(including shipping)",
"winning_bid_price_converted": 99.57,
"buy_it_now": false
},
"offer": {
"price": 4.95,
"currency": "USD",
"best_offer_accepted": true,
"sale_date": {
"raw": "07 Aug, 2021 20:21:04 BST"
}
},
"payment_methods": [
"PayPal",
"Google Pay",
"Visa",
"Master Card",
"Amex",
"Discover",
"PayPal Credit"
],
"seller": {
"name": "uno-mass",
"link": "https://www.ebay.com/usr/uno-mass",
"feedback_score": 18945,
"positive_feedback_percent": 99.8
},
"promotion": {
"why_buy": [
"4,760 sold",
"More than 50% sold",
"30-day returns"
]
},
"shipping": {
"price": 18.59,
"service": "International Priority Shipping to Italy via the Global Shipping Program",
"ships_to": "United States and many other countries",
"location": "Addison, Texas, United States",
"delivery_estimate": "Mon. Jan. 25 and Thu. Jan. 28"
},
"reviews": [
{
"id": "10000000261589368",
"title": "Conversione luci",
"body": "Kit fatto molto bene arrivato prima del previsto. Appena montato, cambia totalmente l'interno dell'abitacolo e non solo. Consigliato a tutti quelli che vogliono cambiare l'aspetto della loro auto internamente",
"rating": 5,
"helpful_votes": 2,
"unhelpful_votes": 0,
"attributes": [
{
"name": "Acquisto verificato:",
"value": "Sì"
},
{
"name": "Condizione:",
"value": "nuovo"
},
{
"name": "Venduto da:",
"value": "esselle-parts"
}
],
"date": {
"raw": "30 ott 2018"
},
"profile": {
"name": "simcasad",
"link": "https://www.ebay.it/usr/simcasad"
}
},
{
"id": "10000000275642908",
"title": "Ottimo prodotto",
"body": "Kit perfetto per giulietta my2016 no errore su linea cunbus, luce abitacolo intensa e bianca, kit completo di tutte le luci di cui abbiamo bisogno, compatibili 100%.",
"rating": 5,
"helpful_votes": 1,
"unhelpful_votes": 0,
"attributes": [
{
"name": "Acquisto verificato:",
"value": "Sì"
},
{
"name": "Condizione:",
"value": "nuovo"
},
{
"name": "Venduto da:",
"value": "esselle-parts"
}
],
"date": {
"raw": "22 ago 2019",
"utc": "2019-08-22T11:00:00.000Z"
},
"profile": {
"name": "mimmo2703",
"link": "https://www.ebay.it/usr/mimmo2703"
}
},
{
"id": "10000000275341892",
"title": "Ottima qualitá",
"body": "Ottima qualitá del prodotto. Facile montaggio. Eccezzionale resa luminosa ed estetica",
"rating": 4,
"helpful_votes": 1,
"unhelpful_votes": 0,
"attributes": [
{
"name": "Acquisto verificato:",
"value": "Sì"
},
{
"name": "Condizione:",
"value": "nuovo"
},
{
"name": "Venduto da:",
"value": "esselle-parts"
}
],
"date": {
"raw": "15 ago 2019",
"utc": "2019-08-15T11:00:00.000Z"
},
"profile": {
"name": "3l3ctr0",
"link": "https://www.ebay.it/usr/3l3ctr0"
}
},
{
"id": "10000000298027819",
"title": "Niente male",
"body": "Tutto il kit è interamente adattabile: possiedo una giulietta di ultima serie, fra le ultime prodotte in casa Alfa romeo, e tutto il kit si adatta alla perfezione; su alcune luci bisogna giocare un po per far sì che vadano bene, ma una volta capito come vanno montate funzionano alla perfezione. 3 stelle perché mi aspettavo di più dalle luci emesse dalla targa e perché una lucina del coprisole non andava benissimo e ho dovuto forzare leggermente i contatti per far si che toccassero bene la lampadina.",
"rating": 3,
"helpful_votes": 0,
"unhelpful_votes": 0,
"attributes": [
{
"name": "Acquisto verificato:",
"value": "Sì"
},
{
"name": "Condizione:",
"value": "nuovo"
},
{
"name": "Venduto da:",
"value": "esselle-parts"
}
],
"date": {
"raw": "27 mar 2021",
"utc": "2021-03-27T12:00:00.000Z"
},
"profile": {
"name": "p356847",
"link": "https://www.ebay.it/usr/p356847"
}
}
]
}
```
Countdown API returns the following properties for Individual Listing Page Product requests (i.e. when `is_master=false` ):
| *`Property`* | *`Type`* | *`Description`* |
| ----------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *`is_master`* | *`boolean`* | A boolean set to `false` indicating that this is a Individual Listing page. |
| *`is_auction`* | *`boolean`* | A boolean indicating whether the product listing is an auction or not. |
| *`make_offer`* | *`boolean`* | A boolean set to `true` if the "Make Offer" button is visible on the listing, null if not. |
| *`product`* | *`object`* | An object containing details of the primary product shown on the product page.
- `title`
- `string`
- The product name.
- `epid`
- `string`
- The Ebay product ID (EPID) for the product.
- `spid`
- `string`
- The Ebay secondary product ID (SPID) for the product.
- `link`
- `string`
- The product page link.
- `brand`
- `string`
- The product brand name (if available).
- `model_number`
- `string`
- The product model number (if available).
- `description`
- `string`
- The product description (if available). **Note** that in certain circumstances descriptions nested in IFrames on the listing page will not be available.
- `primary_image`
- `object`
- **Primary Image Object**
The primary image object contains primary image shown when the product page was loaded.
-
1. `link`
2. `string`
3. A link to the main image.
- `images`
- `array`
- **Images Array**
The images property contains an array of image objects containing the other available product images, excluding the main image. The image object has the following properties:
-
1. `link`
2. `string`
3. A link to the image.
- `attributes`
- `array`
- **Attributes Array**
The attributes array contains details of the product attributes as shown underneath the product title.
-
1. `name`
2. `string`
3. The name of the product attribute i.e. "Capacity".
-
1. `value`
2. `string`
3. The value of the product attribute i.e. "128 GB".
- `variants`
- `array`
- **Variants Array**
An array containing details of the product variants shown with this product. Each object in the array may contain the following properties (the presence of these properties will vary depending on whether Ebay themselves show them, you should expect one or more to be null):
-
1. `name`
2. `string`
3. The name of the variant (i.e. "8 Pack"), if shown.
-
1. `epid`
2. `string`
3. The EPID of the variant, if shown.
-
1. `image`
2. `string`
3. The link to the variant's image, if shown.
-
1. `price`
2. `number`
3. The price of the variant, if shown.
-
1. `currency`
2. `string`
3. The currency of the variant, if shown.
-
1. `attributes`
2. `array`
3. An array of `name` `value` containing the variant attribute names and values, if shown.
-
1. `stock_status`
2. `object`
3. An object containing the stock status of the variant, if shown. Contains `status` , `quantity_sold` and `quantity_available` properties. |
| *`auction`* | *`object`* | **Auction Object
**
An object containing auction-specific information that is present when this is an auction listing (i.e when `is_auction=true` :
- `bids`
- `number`
- The number of bids currently placed on this auction.
- `winning_bid_price`
- `number`
- The current winning bid price.
- `winning_bid_price_raw`
- `string`
- The current winning bid price in raw form. Typically including the currency identifier.
- `winning_bid_price_converted`
- `number`
- The current winning bid price, converted into the currency of the Ebay domain (if different from the listing currency).
- `winning_bid_price_converted_raw`
- `string`
- The current winning bid price, converted into the currency of the Ebay domain (if different from the listing currency) in raw form. Typically including the currency identifier.
- `buy_it_now`
- `boolean`
- A boolean indicating whether Buy It Now is available for this auction.
- `time_left`
- `object`
- An object describing the time left on the auction. The `raw` property contains a locale-specific string showing the time remaining on the auction.
- `end_date`
- `object`
- An object describing the end date of the auction. The `raw` property contains a locale-specific string showing the time remaining on the auction. If possible, Countdown API will parse the end date into a standard UTC timestamp and present it in the `utc` property. |
| *`returns_policy`* | *`object`* | **Return Policy Object
**
An object showing details of the returns policy for the product, if available:
- `raw`
- `string`
- The raw returns policy description as shown on the product page.
- `returns_accepted`
- `boolean`
- Whether or not returns are accepted, `true` or `false` . |
| *`stock_status`* | *`object`* | **Stock Status Object**
An object showing details of the stock status for the product, if available:
- `raw`
- `string`
- The raw stock status string as shown on the product page.
- `status`
- `string`
- The normalized stock status string, for example `in_stock` .
- `quantity_available`
- `number`
- The number of products that are available for sale.
- `quantity_sold`
- `number`
- The quantity of this product that have been sold. |
| *`condition`* | *`object`* | **Condition Object
**
An object containing details of the condition for the product that's being offered for sale, if available:
- `raw`
- `string`
- The raw condition string as shown on the product page.
- `name`
- `string`
- The normalized condition name string, for example `new` .
- `description`
- `number`
- The full test description of the condition.
- `is_new`
- `boolean`
- A boolean indicating whether the product is new condition or not.
- `is_used`
- `boolean`
- A boolean indicating whether the product is used condition or not. |
| *`offer`* | *`object`* | **Offer Object
**
An object showing details of the offer for the product, if available:
- `price`
- `number`
- The price of the product.
- `currency`
- `string`
- The 3-letter currency code of the price.
- `best_offer_accepted`
- `boolean`
- Set to `true` when the "Best Offer accepted" text is shown next to the price on the product page.
- `end_date`
- `object`
- An object, present when the listing is flagged as "ended", with a `raw` property containing the raw date, as shown on the listing page, when the listing ended. |
| *`payment_methods`* | *`array`* | An array of strings with each entry in the array being a payment method that is accepted as payment for this product, for example `PayPal` . |
| *`seller`* | *`object`* | **Seller Object**
An object showing details of the seller for the product, if available:
- `name`
- `string`
- The seller name.
- `link`
- `string`
- A link to the seller's Ebay profile page.
- `feedback_score`
- `number`
- The feedback score for the seller of the product.
- `positive_feedback_percent`
- `string`
- The seller positive feedback expressed as a percentage. |
| *`shipping`* | *`object`* | **Shipping Object**
An object showing details of the shipping for the product, if available:
- `price`
- `number`
- The shipping price of the product.
- `link`
- `string`
- A link to the seller's Ebay profile page.
- `service`
- `string`
- The service name description of the shipping.
- `ships_to`
- `string`
- The text from the "ships to" section of the shipping information.
- `location`
- `string`
- The location the product is shipped from.
- `delivery_estimate`
- `string`
- The delivery time estimate for shipping the product to the location specified in the `customer_location` and/or `customer_zipcode` . |
| *`reviews`* | *`array`* | **Reviews Object
**
An array of Review objects, containing each of the Customer Reviews shown on the Individual Listing product page.
**Note** to see all reviews you should make a `type=reviews` [request ](https://docs.trajectdata.com/countdownapi/ebay-product-data-api/parameters/reviews).
The Review object has the following properties:
- `id`
- `string`
- The unique, Ebay-assigned, ID of the customer review. This can be used by your app to flag whether you have previously processed this review on a prior request.
- `title`
- `string`
- The title of the review.
- `body`
- `string`
- The body text of the review.
- `rating`
- `number`
- The product rating given by the reviewer, out of 5.
- `helpful_votes`
- `number`
- The number of helpful votes this review has received from other Ebay customers.
- `unhelpful_votes`
- `number`
- The number of unhelpful votes this review has received from other Ebay customers.
- `seller_name`
- `string`
- The name of the Ebay seller who sold the product this reviewer reviewed.
- `attributes`
- `array`
- **Attributes Array**
The attributes array contains details of the product attributes as shown underneath the product title on the customer reviews page.
-
1. `name`
2. `string`
3. The name of the product attribute i.e. "Capacity".
-
1. `value`
2. `string`
3. The value of the product attribute i.e. "128 GB".
**Date Object**
The date object contains details about the date of the review.
- `raw`
- `string`
- The raw date as retrieved from the Ebay page.
- `utc`
- `string`
- The date of the review, parsed from the raw date, in [ISO 8601 ](https://en.wikipedia.org/wiki/ISO_8601)format. If Countdown API cannot parse the raw date then this property will be null.
**Profile Object**
The profile object contains details of the profile of the reviewer.
- `name`
- `string`
- The reviewer's profile name.
- `link`
- `string`
- A link to the reviewer's profile page on the Ebay domain. |
| *`parts_compatibility`* | *`array`* | **Parts Compatibility Array**
Determines whether Countdown returns the `parts_compatibility` property as part of the product request. The parts compatibility properties are typically shown in the descriptive section of the Ebay product listing page - for example, a compatibility table showing the vehicle a particular part is compatible with (screenshot shown below).
-
:inlineImage[]{src="https://apiimages.imgix.net/countdownapi/images/png/docs/countdown_parts_compatability.png?auto=format&ixlib=react-9.5.1-beta.1&w=240" alt caption}
**Note**: The `parts_compatibility` property is only shown when the `include_parts_compatibility=true` request parameter is set.
- `product`
- `string`
- The name of the product that the current product is compatible with.
- `properties`
- `array`
- An array of objects containing `id` , `name` and `value` properties describing the properties of the compatible product. |
***
### Unavailable / Redirected Products
Often times, when the specified `epid` is unavaialble Ebay will redirect the user to another, similar, listing. In these scenarios Countdown will return a response with the `redirected=true` property set, as-per the example below. The redirected EPID, and the link, are shown in the `redirected_link` and `redirected_epid` properties allowing you (should your use-case require it) to make a subsequent request for the redirected EPID.
An example of the JSON object returned from a redirected Product request is shown below:
```json
{
"request_info": {
"success": true,
"credits_used": 1,
"credits_remaining": 999
},
"request_metadata": {
"id": "48d63ef58b3eb240d5b18115b674c4170faba51f",
"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/p/3105882?_fcid=1"
},
"request_parameters": {
"type": "product",
"ebay_domain": "ebay.com",
"gtin": "194348114747"
},
"redirected": true,
"redirected_link": "https://www.ebay.com/p/2255028484",
"redirected_epid": "2255028484"
}
```
Countdown API returns the following properties for Product requests that have been redirected:
| *`Property`* | *`Type`* | *`Description`* |
| ------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| *`redirected`* | *`boolean`* | A boolean set to `true` when the requested EPID has resulted in Ebay redirecting to another, similar EPID due to the request EPID no longer being avaialble. |
| *`redirected_link`* | *`string`* | A URL to the product listing page of the EPID that has been redirected to. |
| *`redirected_epid`* | *`string`* | The EPID that has been redirected to. |
***
**Next Steps**
[Product Parameters](https://docs.trajectdata.com/countdownapi/ebay-product-data-api/parameters/product)