Core API
...
Results
Core Requests
Product
9 min
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 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 { "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 ) 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 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 { "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 ) 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 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 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 false left unhandled content type false left unhandled content type 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 { "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 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 next steps product parameters https //docs trajectdata com/countdownapi/ebay product data api/parameters/product