Search

2 min

Search Results

When making a request with the type parameter set to type=search Countdown API will return search results from the Ebay domain specified in the ebay_domain parameter.

Search results are retrieved from the search results page on Ebay.

Search Results Page

An example of the JSON object returned from a Search request is shown below:

{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "f78c211030e249334f2741f37cc7f3a884392054",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "ebay_url": "https://ebay.com/sch/i.html?_nkw=memory+cards&_sacat=0"
  },
  "request_parameters": {
    "type": "search",
    "search_term": "memory cards",
    "ebay_domain": "ebay.com"
  },
  "search_information": {
    "did_you_mean": "memory memory",
    "did_you_mean_results_count": 650,
    "spelling_correction": "memory memory",
    "original_search_term": "memory cards"
  },
  "search_results": [
    {
      "position": 1,
      "title": "SanDisk Ultra 32GB 64GB 128GB 256GB Micro SD C10 SDHC SDXC Flash Memory TF Card",
      "epid": "264141604548",
      "link": "https://www.ebay.com/itm/SanDisk-Ultra-32GB-64GB-128GB-256GB-Micro-SD-C10-SDHC-SDXC-Flash-Memory-TF-Card/264141604548",
      "image": "https://i.ebayimg.com/thumbs/images/m/mkMhXPFgX1s-1XNpEI9rfJw/s-l225.webp",
      "hotness": "518+ Sold",
      "condition": "Brand New",
      "is_auction": false,
      "buy_it_now": false,
      "free_returns": false,
      "shipping_cost": 3.99,
      "ended": {
        "type": "sold",
        "date": {
          "raw": "Aug 27, 2021"
        }
      },
      "sponsored": true,
      "best_offer_accepted": true,
      "prices": [
        {
          "symbol": "$",
          "value": 7.85,
          "currency": "USD",
          "raw": "$7.85",
          "name": "low"
        },
        {
          "symbol": "$",
          "value": 28.85,
          "currency": "USD",
          "raw": "$28.85",
          "name": "high"
        }
      ],
      "price": {
        "symbol": "$",
        "value": 7.85,
        "currency": "USD",
        "raw": "$7.85",
        "name": "low"
      }
    },
    {
      "position": 2,
      "title": "SanDisk Micro SD Card 8GB 16GB 32GB Memory Class 4 Android Nintendo Cell Phone",
      "epid": "264141604548",
      "link": "https://www.ebay.com/itm/SanDisk-Ultra-32GB-64GB-128GB-256GB-Micro-SD-C10-SDHC-SDXC-Flash-Memory-TF-Card/264141604548",
      "image": "https://i.ebayimg.com/thumbs/images/m/mciB-ASxCbhbcbo9B3OwQ2w/s-l225.webp",
      "hotness": "3,025+ Sold",
      "condition": "Brand New",
      "is_auction": false,
      "buy_it_now": false,
      "free_returns": true,
      "shipping_cost": 2.5,
      "sponsored": true,
      "ended": {
        "type": "sold",
        "date": {
          "raw": "Jan 1, 2020"
        }
      },
      "prices": [
        {
          "symbol": "$",
          "value": 6.99,
          "currency": "USD",
          "raw": "$6.99",
          "name": "low"
        },
        {
          "symbol": "$",
          "value": 9.99,
          "currency": "USD",
          "raw": "$9.99",
          "name": "high"
        }
      ],
      "price": {
        "symbol": "$",
        "value": 6.99,
        "currency": "USD",
        "raw": "$6.99",
        "name": "low"
      }
    }
  ],
  "facets": [
    {
      "display_name": "Storage Capacity",
      "values": [
        {
          "name": "64 GB",
          "param_value": "facets=Storage%2520Capacity=64+GB",
          "count": 9689
        },
        {
          "name": "32 GB",
          "param_value": "facets=Storage%2520Capacity=32+GB",
          "count": 8057
        },
        {
          "name": "128 GB",
          "param_value": "facets=Storage%2520Capacity=128+GB",
          "count": 7782
        },
        {
          "name": "256 GB",
          "param_value": "facets=Storage%2520Capacity=256+GB",
          "count": 6703
        },
        {
          "name": "1TB",
          "param_value": "facets=Storage%2520Capacity=1TB",
          "count": 662
        },
        {
          "name": "512 GB",
          "param_value": "facets=Storage%2520Capacity=512+GB",
          "count": 1732
        },
        {
          "name": "16 GB",
          "param_value": "facets=Storage%2520Capacity=16+GB",
          "count": 3924
        },
        {
          "name": "8 GB",
          "param_value": "facets=Storage%2520Capacity=8+GB",
          "count": 1291
        }
      ],
      "name": "Storage%2520Capacity"
    },
    {
      "display_name": "Speed Class",
      "values": [
        {
          "name": "Class 10",
          "param_value": "facets=Speed%2520Class=Class+10",
          "count": 31047
        },
        {
          "name": "Class 4",
          "param_value": "facets=Speed%2520Class=Class+4",
          "count": 1148
        },
        {
          "name": "A1",
          "param_value": "facets=Speed%2520Class=A1",
          "count": 1490
        },
        {
          "name": "UHS Speed Class 1",
          "param_value": "facets=Speed%2520Class=UHS+Speed+Class+1",
          "count": 1782
        },
        {
          "name": "Class 1",
          "param_value": "facets=Speed%2520Class=Class+1",
          "count": 430
        },
        {
          "name": "UHS Speed Class 3",
          "param_value": "facets=Speed%2520Class=UHS+Speed+Class+3",
          "count": 297
        },
        {
          "name": "Class 2",
          "param_value": "facets=Speed%2520Class=Class+2",
          "count": 72
        },
        {
          "name": "Class 6",
          "param_value": "facets=Speed%2520Class=Class+6",
          "count": 52
        }
      ],
      "name": "Speed%2520Class"
    },
    {
      "display_name": "Brand",
      "values": [
        {
          "name": "SanDisk",
          "param_value": "facets=Brand=SanDisk",
          "count": 10116
        },
        {
          "name": "Samsung",
          "param_value": "facets=Brand=Samsung",
          "count": 3289
        },
        {
          "name": "Unbranded",
          "param_value": "facets=Brand=Unbranded",
          "count": 5558
        },
        {
          "name": "Kingston",
          "param_value": "facets=Brand=Kingston",
          "count": 3306
        },
        {
          "name": "Sony",
          "param_value": "facets=Brand=Sony",
          "count": 54
        },
        {
          "name": "Vida IT",
          "param_value": "facets=Brand=Vida+IT",
          "count": 2045
        },
        {
          "name": "PNY",
          "param_value": "facets=Brand=PNY",
          "count": 218
        },
        {
          "name": "Lexar",
          "param_value": "facets=Brand=Lexar",
          "count": 436
        }
      ],
      "name": "Brand"
    },
    {
      "display_name": "Compatible Model",
      "values": [
        {
          "name": "Universal",
          "param_value": "facets=Compatible%2520Model=Universal",
          "count": 19988
        },
        {
          "name": "For Samsung Galaxy Note8",
          "param_value": "facets=Compatible%2520Model=For+Samsung+Galaxy+Note8",
          "count": 594
        },
        {
          "name": "For Sony Xperia Z5",
          "param_value": "facets=Compatible%2520Model=For+Sony+Xperia+Z5",
          "count": 428
        },
        {
          "name": "For HTC One M8",
          "param_value": "facets=Compatible%2520Model=For+HTC+One+M8",
          "count": 426
        },
        {
          "name": "For Sony Xperia Z",
          "param_value": "facets=Compatible%2520Model=For+Sony+Xperia+Z",
          "count": 397
        },
        {
          "name": "For Samsung Galaxy Note",
          "param_value": "facets=Compatible%2520Model=For+Samsung+Galaxy+Note",
          "count": 343
        },
        {
          "name": "For Alcatel Fierce XL",
          "param_value": "facets=Compatible%2520Model=For+Alcatel+Fierce+XL",
          "count": 332
        },
        {
          "name": "For HTC One",
          "param_value": "facets=Compatible%2520Model=For+HTC+One",
          "count": 328
        }
      ],
      "name": "Compatible%2520Model"
    },
    {
      "display_name": "Format",
      "values": [
        {
          "name": "microSDXC",
          "param_value": "facets=Format=microSDXC",
          "count": 4461
        },
        {
          "name": "MicroSD",
          "param_value": "facets=Format=MicroSD",
          "count": 21155
        },
        {
          "name": "SD",
          "param_value": "facets=Format=SD",
          "count": 1141
        },
        {
          "name": "MicroSDHC",
          "param_value": "facets=Format=MicroSDHC",
          "count": 5859
        },
        {
          "name": "TF",
          "param_value": "facets=Format=TF",
          "count": 711
        },
        {
          "name": "microSDXC UHS-I",
          "param_value": "facets=Format=microSDXC+UHS-I",
          "count": 2290
        },
        {
          "name": "SDXC",
          "param_value": "facets=Format=SDXC",
          "count": 953
        },
        {
          "name": "SDHC",
          "param_value": "facets=Format=SDHC",
          "count": 851
        }
      ],
      "name": "Format"
    },
    {
      "display_name": "Features",
      "values": [
        {
          "name": "High Speed",
          "param_value": "facets=Features=High+Speed",
          "count": 30844
        },
        {
          "name": "High Capacity",
          "param_value": "facets=Features=High+Capacity",
          "count": 21407
        },
        {
          "name": "Waterproof",
          "param_value": "facets=Features=Waterproof",
          "count": 16113
        },
        {
          "name": "Wi-Fi",
          "param_value": "facets=Features=Wi-Fi",
          "count": 4209
        },
        {
          "name": "Not Specified",
          "param_value": "facets=Features=Not+Specified",
          "count": 11813
        }
      ],
      "name": "Features"
    },
    {
      "display_name": "Compatible Brand",
      "values": [
        {
          "name": "Universal",
          "param_value": "facets=Compatible%2520Brand=Universal",
          "count": 22478
        },
        {
          "name": "For Samsung",
          "param_value": "facets=Compatible%2520Brand=For+Samsung",
          "count": 5537
        },
        {
          "name": "For Sony",
          "param_value": "facets=Compatible%2520Brand=For+Sony",
          "count": 2653
        },
        {
          "name": "For LG",
          "param_value": "facets=Compatible%2520Brand=For+LG",
          "count": 2534
        },
        {
          "name": "For Huawei",
          "param_value": "facets=Compatible%2520Brand=For+Huawei",
          "count": 1913
        },
        {
          "name": "For Amazon",
          "param_value": "facets=Compatible%2520Brand=For+Amazon",
          "count": 1887
        },
        {
          "name": "For Motorola",
          "param_value": "facets=Compatible%2520Brand=For+Motorola",
          "count": 1836
        },
        {
          "name": "For Nokia",
          "param_value": "facets=Compatible%2520Brand=For+Nokia",
          "count": 1665
        }
      ],
      "name": "Compatible%2520Brand"
    },
    {
      "display_name": "Manufacturer Warranty",
      "values": [
        {
          "name": "3 Months",
          "param_value": "facets=Manufacturer%2520Warranty=3+Months",
          "count": 9601
        },
        {
          "name": "Lifetime",
          "param_value": "facets=Manufacturer%2520Warranty=Lifetime",
          "count": 2785
        },
        {
          "name": "Yes",
          "param_value": "facets=Manufacturer%2520Warranty=Yes",
          "count": 1048
        },
        {
          "name": "1 Month",
          "param_value": "facets=Manufacturer%2520Warranty=1+Month",
          "count": 986
        },
        {
          "name": "10 Years",
          "param_value": "facets=Manufacturer%2520Warranty=10+Years",
          "count": 517
        },
        {
          "name": "1 Year",
          "param_value": "facets=Manufacturer%2520Warranty=1+Year",
          "count": 364
        },
        {
          "name": "5 Years",
          "param_value": "facets=Manufacturer%2520Warranty=5+Years",
          "count": 288
        },
        {
          "name": "No",
          "param_value": "facets=Manufacturer%2520Warranty=No",
          "count": 144
        }
      ],
      "name": "Manufacturer%2520Warranty"
    },
    {
      "display_name": "Country/Region of Manufacture",
      "values": [
        {
          "name": "United States",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=United+States",
          "count": 9168
        },
        {
          "name": "China",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=China",
          "count": 2473
        },
        {
          "name": "Taiwan",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=Taiwan",
          "count": 2327
        },
        {
          "name": "Unknown",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=Unknown",
          "count": 208
        },
        {
          "name": "Malaysia",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=Malaysia",
          "count": 150
        },
        {
          "name": "Philippines",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=Philippines",
          "count": 131
        },
        {
          "name": "Korea, Republic of",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=Korea,+Republic+of",
          "count": 80
        },
        {
          "name": "Japan",
          "param_value": "facets=Country%252FRegion%2520of%2520Manufacture=Japan",
          "count": 61
        }
      ],
      "name": "Country%252FRegion%2520of%2520Manufacture"
    },
    {
      "display_name": "Condition",
      "values": []
    },
    {
      "display_name": "Price",
      "values": []
    },
    {
      "display_name": "Buying Format",
      "values": []
    },
    {
      "display_name": "Item Location",
      "values": [
        {
          "name": "Default",
          "param_value": "facets=LH_PrefLoc=Default"
        },
        {
          "name": "US Only",
          "param_value": "facets=LH_PrefLoc=US+Only"
        },
        {
          "name": "North America",
          "param_value": "facets=LH_PrefLoc=North+America"
        },
        {
          "name": "Worldwide",
          "param_value": "facets=LH_PrefLoc=Worldwide"
        }
      ],
      "name": "LH_PrefLoc"
    },
    {
      "display_name": "Shipping Options",
      "values": [
        {
          "name": "Free Shipping",
          "param_value": "facets=LH_FS=Free+Shipping"
        }
      ],
      "name": "LH_FS"
    },
    {
      "display_name": "Local Pickup",
      "values": [
        {
          "name": "Free In-store Pickup",
          "param_value": "facets=LH_BOPIS=Free+In-store+Pickup"
        },
        {
          "name": "Free Local Pickup",
          "param_value": "facets=LH_BOPIS=Free+Local+Pickup"
        },
        {
          "name": "Zip code",
          "param_value": "facets=LH_BOPIS=Zip+code"
        }
      ],
      "name": "LH_BOPIS"
    },
    {
      "display_name": "Show only",
      "values": [
        {
          "name": "Free Returns",
          "param_value": "facets=LH_FR=Free+Returns"
        },
        {
          "name": "Returns Accepted",
          "param_value": "facets=LH_FR=Returns+Accepted"
        },
        {
          "name": "Authorized Seller",
          "param_value": "facets=LH_FR=Authorized+Seller"
        },
        {
          "name": "Completed Items",
          "param_value": "facets=LH_FR=Completed+Items"
        },
        {
          "name": "Sold Items",
          "param_value": "facets=LH_FR=Sold+Items"
        },
        {
          "name": "Deals & Savings",
          "param_value": "facets=LH_FR=Deals+&+Savings"
        },
        {
          "name": "Authenticity Guarantee",
          "param_value": "facets=LH_FR=Authenticity+Guarantee"
        }
      ],
      "name": "LH_FR"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_results": "9893",
    "has_next_page": true,
    "next_page": 2
  }
}

Countdown API returns the following properties for Search requests:

Property	Type	Description
search_results	array	An array of Search Result objects, containing each of the product results shown on the Search Results page. The Search Result object has the following properties: position number The position of the result on the search results page. title string The product name. epid string The Ebay product ID (EPID) for the listing. link string The product page link. image string A link to the image of the product. hotness string The value of the 'hotness' entry shown next to the product listing. condition string The condition of the product in the listing. is_auction boolean True/false indicating whether this is an auction-format listing. buy_it_now boolean True/false indicating whether this listing offers a Buy-It-Now price. free_returns boolean True/false indicating whether this listing offers free returns. sponsored boolean True/false indicating whether this listing is sponsored (i.e. promoted). best_offer_accepted boolean Set to true when the "Best Offer accepted" text is shown next to the search result. best_offer boolean Set to true when the "Best Offer" text is shown next to the search result (different from best_offer_accepted in that just "Best Offer" is shown, not "Best Offer Accepted"). is_rewritten_result boolean Set to true when this search result appears beneath the "Results matching fewer words" banner (meaning the search result doesn't exactly match the search_term and has been suggested as an alternative). An example of the "Results matching fewer words banner is shown below. If you wish to exlude rewritten results use the allow_rewritten_results=false request parameter. item_location string The item location, if shown next to the search result. rating number The overall rating of the product, out of 5. ratings_total number The total number of customer ratings the product has received. shipping_cost number A number describing the shipping cost of the item. prices array Prices Array The prices array contains details about the products pricing, as shown underneath the product title. It is an array of price objects, the properties of which are described below: symbol string The currency symbol, i.e. $ for USD. value number The price of the Offer. currency string The currency of the Offer as a ISO 4217 currency code. raw string The raw price as displayed on the Offer listing. name string The name of the price if applicable, for example "low" and "high" in the case of a range price. If the name property is empty then this price is the only price shown against the product. ended object Ended Object An object describing how the listing ended, if shown. Typically displayed when the completed_items=true request parameter is used. The properties of the ended object are described below: type string Set to ended when the listing was shown as "Ended", set to sold when the listing was shown as "Sold". Can be used as an indicator of whether listing ended naturally, or resulted in a sale. date object An object describing the date on which the listing ended naturally or was sold. Contains a string property raw containing the raw date string of the listing end as shown next to the search result. seller_info object Seller Info Object An object with seller information retrieved from page. name string Name of ebay seller account. review_count number Total number of reviews. positive_feedback_percent number Percent of positive reviews for seller. price object A price object representing the first item in the prices array. This is normally the "main" or "lowest" (in the case of a range) price for the product and is included as a convienience to make extracting the main price easier.
facets	array	Facet Object An array containing details of any available search facets (refinements) shown on the search result page. You can use the facets returned here to refine your query by supplying facet information into the facets request parameter . Each object in the facets array contains the following properties: name string The name of the facet (can be used in the facets request parameter). display_name string The display name of the facet (i.e. the user-facing name). values array Facet Values Array The facet values array shows the values of the given facet, along with the number of products matching that facet value. name string The facet value, can be used in the facets request parameter. count number The count of the number of products that match this facet value in the current search results, if shown (omitted if not shown or zero). param_value string The example value of a subsequent requests facets parameter to filter the results to this facet value.
pagination	object	An object containing details of the current search results page and the total number of results that are available. To paginate you should specify the page number in your request's page parameter . current_page number The current page number. total_results number The total number of results available for the given search. has_next_page boolean True / false as to whether a next page of search results is available. next_page number The page number of the next page of results. Can be used in a subsequent type=search requests' page parameter to request search results from the next page.
search_information	object	An object containing details any spelling corrections or redirections applied to the search results. original_search_term string Populated with the original search term. did_you_mean string Populated with the "did you mean" spelling correction shown when a misspelled search_term is provided and Ebay has suggested a different search term but not automatically redirected to that search term. did_you_mean_results_count number The estimated number of search results from the "did you mean" suggested search term. spelling_correction string Populated with the search term Ebay automatically redirected the search results to in the case of the original search term not yielding any results.

Next Steps Search Parameters