Product

9min

Product Results
When making a request with the  type  parameter 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) 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.
Ebay Master Page
﻿
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"
      }
    }
  ]
}
{
  "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.
﻿
﻿
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 contain details of an individual listing. Individual Listing Pages can be identified by  is_master=false  in the response.
Ebay Individual Listing Page
﻿
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"
      }
    }
  ]
}
{
  "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.
﻿
link
string
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:
﻿
link
string
A link to the image.
﻿
attributes
array
Attributes Array 
The attributes array contains details of the product attributes as shown underneath the product title.
﻿
name
string
The name of the product attribute i.e. "Capacity".
﻿
value
string
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):
﻿
name
string
The name of the variant (i.e. "8 Pack"), if shown.
﻿
epid
string
The EPID of the variant, if shown.
﻿
image
string
The link to the variant's image, if shown.
﻿
price
number
The price of the variant, if shown.
﻿
currency
string
The currency of the variant, if shown.
﻿
attributes
array
An array of name value containing the variant attribute names and values, if shown.
﻿
stock_status
object
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 .  
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.
﻿
name
string
The name of the product attribute i.e. "Capacity".
﻿
value
string
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 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).
﻿
﻿
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.
Ebay Redirected Product Page
﻿
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"
}
{
  "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﻿

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

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. link string 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: link string A link to the image. attributes array Attributes Array The attributes array contains details of the product attributes as shown underneath the product title. name string The name of the product attribute i.e. "Capacity". value string 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): name string The name of the variant (i.e. "8 Pack"), if shown. epid string The EPID of the variant, if shown. image string The link to the variant's image, if shown. price number The price of the variant, if shown. currency string The currency of the variant, if shown. attributes array An array of name value containing the variant attribute names and values, if shown. stock_status object 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 . 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. name string The name of the product attribute i.e. "Capacity". value string 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 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). 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.

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.

Updated 08 Aug 2024

Did this page help you?

Reviews