Search

2min

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:
JSON
{
  "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
  }
}
{
  "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﻿

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.

Updated 17 Aug 2024

Did this page help you?

Autocomplete

Product