Search

search parameters get get /request the search parameters are applicable when making a request with type=search to retrieve search results for an ebay domain the ebay domain is specified using the ebay domain parameter and the search term is specified in the search term parameter the parameters should be appended as querystring parameters to the ebay product data api get http request search results are retrieved from the search results page https //www ebay com/sch/i html? nkw=memory+cards on ebay for example, to request search results for the search term "memory cards" sorted by "high to low price", on ebay com , the request would be http https //api countdownapi com/request?api key=demo\&type=search\&ebay domain=ebay com\&search term=memory+cards\&sort by=price high to lowcurl l get https //api countdownapi com/request \\ d api key="demo" \\ d type="search" \\ d ebay domain="ebay com" \\ d search term="memory+cards" \\ d sort by="price high to low"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "search", ebay domain "ebay com", search term "memory cards", sort by "price high to low" } // make the http get request to countdown api axios get('https //api countdownapi com/request', { params }) then(response => { // print the json response from countdown api console log(json stringify(response data, 0, 2)); }) catch(error => { // catch and print the error console log(error); })import requests import json \# set up the request parameters params = { 'api key' 'demo', 'type' 'search', 'ebay domain' 'ebay com', 'search term' 'memory cards', 'sort by' 'price high to low' } \# make the http get request to countdown api api result = requests get('https //api countdownapi com/request', params) \# print the json response from countdown api print(json dumps(api result json()))\<?php \# set up the request parameters $querystring = http build query(\[ 'api key' => 'demo', 'type' => 'search', 'ebay domain' => 'ebay com', 'search term' => 'memory cards', 'sort by' => 'price high to low' ]); \# make the http get request to countdown api $ch = curl init(sprintf('%s?%s', 'https //api countdownapi com/request', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); $api result = curl exec($ch); curl close($ch); \# print the json response from countdown api echo $api result; ?> search parameters the following parameters are available for all requests made when type=search parameter required description ebay domain optional the ebay domain to retrieve search results from for a full list of supported ebay domains see supported ebay domains https //docs trajectdata com/countdownapi/ebay product data api/reference/ebay domains category id optional determines the category to filter search results to category ids can be retrieved from any ebay search url in the sacat ebay url querystring parameter search term optional a search term to use to search for ebay items listing type optional determines the type of listings to search for all search for listings of any type buy it now search for listings with a buy it now price auction search for auction format listings accepts offers search for listings marked as accepting offers sort by optional determines the sort order of search results to return valid values are best match sort search results by best match to the search term price high to low sort search results by highest to lowest price price low to high sort search results by lowest to highest price price high to low plus postage sort search results by highest to lowest price price low to high plus postage sort search results by lowest to highest price newly listed sort search results by newest listed first ending soonest sort search results by listings ending soonest condition optional determines the condition of listings to search for valid values are all do not filter on condition, return all listings new filter to just new listings used filter to just used listings open box filter to just open box listings manufacturer refurbished filter to just manufacturer refurbished listings seller refurbished filter to just seller refurbished listings parts or not working filter to just listings listed for parts or in a not working state not specified filter to just listings that do not specify a condition page optional the current page of search results to retrieve max page optional use the max page parameter to get multiple pages of results in one request the api will automatically paginate through pages and concatenate the results into one response see the pagination https //docs trajectdata com/countdownapi/ebay product data api/pagination docs for more information num optional the number of search results to request (note that it's up to ebay as to how many are actually returned) valid values are 60 , 120 , 240 url optional the ebay search results page url to retrieve search results from note if the url parameter is supplied then the sort by , search term , listing type , condition and page parameters are ignored as they should be specified in the url sold items optional determines whether to filter ebay search results to just 'sold items' valid values are true or false (default) completed items optional determines whether to filter ebay search results to just 'completed items' valid values are true or false (default) authorized sellers optional determines whether to filter ebay search results to just items offered by 'authorized sellers' valid values are true or false (default) returns accepted optional determines whether to filter ebay search results to just 'returns accepted items' valid values are true or false (default) free returns optional determines whether to filter ebay search results to just 'free returns items' valid values are true or false (default) authenticity verified optional determines whether to filter ebay search results to just 'authenticity verified items' valid values are true or false (default) deals and savings optional determines whether to filter ebay search results to just 'deals and savings items' valid values are true or false (default) sale items optional determines whether to filter ebay search results to just 'sale items' valid values are true or false (default) facets optional a free form set of search filter facets to use with the request the facet parameter should be expressed in comma seperated notation, with the name and value of the facet delimited by an equals ("=") character for example, to set the brand facet to the value sandisk and the format facet to the value microsd the value of the facets request parameter would be facets=brand=sandisk,format=microsd facet name and values are case sensitive and can be found in the ebay search url if you have a facet that takes multiple values they can be seperated with a pipe "|" character, for example to set the brand facet to the values sandisk and samsung the facets request parameter would be facets=brand=sandisk|samsung allow rewritten results optional set to false if you wish to exclude results that appear 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 defaults to true next steps search results https //docs trajectdata com/countdownapi/ebay product data api/results/search