Logo SearchApi

eBay Search API Documentation

GET   /api/v1/search?engine=ebay_search

The eBay Search API provides access to eBay's marketplace data, allowing you to search for products and items across multiple eBay domains. You can refine your search results using filters such as price range, buying format, and more. Additionally, you can sort the results based on various criteria, including price and distance. This API enables the integration of real-time eBay product listings into your own app or website.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    This parameter specifies your search query. It accepts any term or phrase you'd typically input in eBay search.
    This parameter is optional when the parameter category_id is present.

      The results will include only products containing all specified words, but you can refine your search by using:
    • Commas and parentheses to get products that include any of the terms (e.g., (ring,earrings,necklace)). You can have multiple sets (e.g., (blue,red)(t-shirt,trousers), which would return products that include (blue or red) and (t-shirt or trousers).
    • A minus sign to exclude terms (e.g., -wood). You can have multiple exclusions (e.g., -wood -steel).

  • Name
    category_id
    Required
    Optional
    Description

    This parameter that allows you to restrict your search to a specific eBay category. Categories are different for each eBay domain.

    Category ids can be retrieved using the API or by inspecting category links found in ebay_domain/n/all-categories. Each category link follows the pattern ebay_domain/b/category_name/category_id/.

Localization

  • Name
    ebay_domain
    Required
    Optional
    Description

    The default parameter ebay.com defines the eBay domain of the search and it's used for multiple countries, but other country-specific domains are also supported. Check the full list of supported eBay domains.

  • Name
    country
    Required
    Optional
    Description

    Since eBay does not have domains for all countries, country is a two-letter ISO 3166-1 alpha-2 country code that allows you to localize ebay.com and change the language and currency (if available). It defaults to the domain's country. Check the full list of supported eBay countries.

  • Name
    delivery_country
    Required
    Optional
    Description

    A two-letter ISO 3166-1 alpha-2 country code that allows you to set the an specific delivery country for the search. The default will be country if it's set, otherwise it will be the domain's country. Check the full list of supported eBay delivery countries.

  • Name
    postal_code
    Required
    Optional
    Description

    This parameter allows you to set the shipping postal code along with delivery_country for the search. It is not available for all delivery countries, check the full list of delivery countries that support postal codes, if not provided in those countries, eBay might automatically set a postal code.

  • Name
    distance_radius
    Required
    Optional
    Description

    A numerical value to filter results based on their distance to a given postal code. This parameter is only applicable when the parameter postal_code is also included.

  • Name
    product_origin_country
    Required
    Optional
    Description

    A two-letter ISO 3166-1 alpha-2 country code that allows you to filter products by the country they are located in and will be shipped from. Check the full list of supported eBay product origin countries.

Filters

  • Name
    price_min
    Required
    Optional
    Description

    This parameter controls the minimum price of the products returned. For instance - 10 value would return products with a minimum price of 10.

  • Name
    price_max
    Required
    Optional
    Description

    This parameter controls the maximum price of the products returned. For instance - 20.5 value would return products with a maximum price of 20.5.

  • Name
    condition
    Required
    Optional
    Description

    This parameter allows you to filter items by their condition. Multiple conditions can be applied by separating them with commas (e.g., new,used_very_good). Available conditions include:

    • new, new_opened, like_new, new_with_defects
    • pre_owned_fair, pre_owned_excellent, used_very_good, used_good, used_acceptable
    • excellent_refurbished, very_good_refurbished and good_refurbished
    • certified_refurbished, seller_refurbished
    • for_parts_or_not_working, not_specified

  • Name
    buying_format
    Required
    Optional
    Description

    This parameter allows you to filter search results by eBay's buying formats: auction, buy_it_now, best_offer.

  • Name
    filters
    Required
    Optional
    Description

    This parameter allows you to filter search results by various criteria. Multiple filters can be applied by separating them with commas (e.g., sale_items,free_shipping). Available filters include:

    Listing filters:
    • sale_items
    • deals_and_savings
    • sold_listings
    • completed_listings
    • listed_as_lots
    Item and seller filters:
    • search_description
    • authenticity_guarantee
    • authorized_seller
    • benefits_charity
    • psa_vault
    Shipping, pickup and return filters:
    • free_shipping
    • local_pickup
    • fast_arrival
    • free_returns
    • returns_accepted

  • Name
    advanced_filters
    Required
    Optional
    Description

    Advanced filters are specific to each product category, such as size and color for the Shirts category. These filters are expressed as key-value pairs separated by an equals sign (e.g., Size Type=Regular,Size=XS|S,Brand=adidas). You can apply multiple advanced filters by separating them with commas. The available advanced filters can be found via the API under the filters key.

    Some filters may be dependent on other filters. For example, the Size Type filter must be applied together with the Size filter.

  • Name
    sort_by
    Required
    Optional
    Description

    This parameter allows sorting search results by different criteria. Below is the list of available sorting options:

    • best_match Default
    • price_shipping_low_to_high, price_shipping_high_to_low
    • time_newly_listed, time_ending_soonest
    • distance_nearest
    • price_low_to_high, price_high_to_low
      (Not available for ebay.com, ebay.co.uk, ebay.com.au, ebay.de)
    • condition_new_first, condition_used_first
      (Not available for ebay.com, ebay.co.uk, ebay.com.au, ebay.ca, cafr.ebay.ca, ebay.nl, ebay.com.my, ebay.ph, ebay.com.sg)

Pagination

  • Name
    layout
    Required
    Optional
    Description

    This parameter determines the layout of the search results. The possible values are: list and grid.

  • Name
    num
    Required
    Optional
    Description

    This parameter determines the number of items per page. The possible values are: 60, 120 and 240. It defaults to 60.

  • Name
    page
    Required
    Optional
    Description

    This parameter determines the results page number. It defaults to 1.

Engine

  • Name
    engine
    Required
    Required
    Description

    This parameter defines an engine that will be used to retrieve real-time data. It must be set to ebay_search.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.org/api/v1/search?engine=ebay_search&q=cell+phone
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "ebay_search",
  "q": "cell phone"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_AEM9arelpd2kFq1woW0Nw8nB",
    "status": "Success",
    "created_at": "2025-04-30T10:23:00Z",
    "request_time_taken": 3.58,
    "parsing_time_taken": 0.1,
    "total_time_taken": 3.68,
    "request_url": "https://www.ebay.com/sch/i.html?_nkw=cell%20phone&_fcid=1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_AEM9arelpd2kFq1woW0Nw8nB.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_AEM9arelpd2kFq1woW0Nw8nB"
  },
  "search_parameters": {
    "engine": "ebay_search",
    "q": "cell phone",
    "ebay_domain": "ebay.com",
    "delivery_country": "US"
  },
  "search_information": {
    "query_displayed": "cell phone",
    "total_results": 390000,
    "sorted_by": "Sort: Best Match",
    "buying_format": "All",
    "shipping_to": "75501",
    "language": "en"
  },
  "categories": [
    {
      "name": "Cell Phones & Accessories",
      "link": "https://www.ebay.com/sch/15032/i.html?_nkw=cell+phone&_fcid=1",
      "category_id": "15032",
      "subcategories": [
        {
          "name": "Cell Phone Accessories",
          "link": "https://www.ebay.com/sch/9394/i.html?_nkw=cell+phone&_fcid=1",
          "category_id": "9394"
        },
        ...
      ]
    },
    ...
  ],
  "filters": [
    {
      "type": "Network",
      "options": [
        {
          "text": "Unlocked",
          "items": 699573,
          "link": "https://www.ebay.com/sch/i.html?_nkw=cell+phone&_fcid=1&rt=nc&Network=Unlocked&_dcat=9355"
        },
        ...
      ]
    },
    ...
  ],
  "organic_results": [
    {
      "position": 1,
      "item_id": "226713039768",
      "title": "Unlocked Apple iPhone SE 3rd Gen - Black 64GB - Crcks - 96% Batt - Pls Read",
      "link": "https://www.ebay.com/itm/226713039768?_skw=cell+phone&epid=220278114&itmmeta=01JT33HG1AHQ6TNXG2YZSAP8JT&hash=item34c9267398:g:KUkAAOSw~CtoBToW&itmprp=enc%3AAQAKAAAAwFkggFvd1GGDu0w3yXCmi1dcijzWf2XFSDxmJXZjjV35eWjrhA2pR35VMny%2BqbA95ajO3L9G0pEIYQja9PU7gjEscfE6e1%2FLjEB8YmN4KzXcFzw2Ams7YH94%2B6FMJPeglmqZrvixFniLaJ400FCpJEVw%2BP6%2Fljz%2F1mEH1i8lHR6VuzgtOxFcDokvU7MJh4IlE%2FtN0MH4YPPX2wvRS%2FtyFktCrbc3g4wmRxYblo4znhbhRzriGj074jvD0l%2F0xVGLtQ%3D%3D%7Ctkp%3ABlBMUP6AxuPQZQ",
      "seller": {
        "name": "cocosprinkles",
        "reviews": 33168,
        "positive_feedback_percent": 99.6
      },
      "condition": "Pre-Owned",
      "extensions": [
        "Apple iPhone SE (3rd Generation)",
        "64 GB",
        "Unlocked"
      ],
      "is_sponsored": true,
      "rating": 5,
      "reviews": 304,
      "reviews_link": "https://www.ebay.com/p/220278114?iid=226713039768#UserReviews",
      "buying_format": "Buy It Now",
      "is_buy_it_now": true,
      "price": "$99.99",
      "extracted_price": 99.99,
      "original_price": "$149.99",
      "extracted_original_price": 149.99,
      "discount": "33% off",
      "watching": "21 watchers",
      "extracted_watching": 21,
      "shipping": "+$7.99 delivery",
      "extracted_shipping": 7.99,
      "thumbnail": "https://i.ebayimg.com/images/g/KUkAAOSw~CtoBToW/s-l500.jpg"
    },
    {
      "position": 2,
      "item_id": "225936405756",
      "title": "Apple iPhone 8 (Great Condition) - (Unlocked, AT&T, T-Mobile, Verizon etc...)",
      "link": "https://www.ebay.com/itm/225936405756?...",
      "seller": {
        "name": "cocosprinkles",
        "reviews": 33168,
        "positive_feedback_percent": 99.6,
        "is_top_rated_plus": true
      },
      "condition": "Pre-Owned",
      "is_sponsored": true,
      "rating": 5,
      "reviews": 66,
      "reviews_link": "https://www.ebay.com/p/240531148?iid=225936405756&var=525027912182#UserReviews",
      "buying_format": "Buy It Now",
      "is_buy_it_now": true,
      "price": "$134.99 to $219.99",
      "extracted_price_range": {
        "from": 134.99,
        "to": 219.99
      },
      "is_price_range": true,
      "original_price": "$259.99",
      "extracted_original_price": 259.99,
      "deal": "Save up to 5% when you buy more",
      "discount": "15% off",
      "items_sold": "18+ sold",
      "extracted_items_sold": 18,
      "shipping": "+$6.99 delivery",
      "extracted_shipping": 6.99,
      "is_free_return": true,
      "thumbnail": "https://i.ebayimg.com/images/g/NXoAAOSwNIdmZw4e/s-l500.jpg"
    },
    ...
  ],
  "sections": [
    {
      "title": "Picked For You",
      "subtitle": "Top selling items from trusted sellers",
      "is_sponsored": true,
      "has_items": true,
      "results": [
        {
          "position": 1,
          "item_id": "225970676295",
          "title": "Apple iPhone 12, 64/128/256GB - Unlocked - Used Very Good - All colors",
          "link": "https://www.ebay.com/itm/225970676295?_skw=cell+phone&epid=12041705164&itmmeta=01JT33HG2GRQ4VAVZYHTK4Z9S1&hash=item349ce6e247:g:t4wAAOSwg4hkCgdI&itmprp=enc%3AAQAKAAAA8FkggFvd1GGDu0w3yXCmi1fg1bynDsX1cIBgH9TnLI6EoX4L27H8DleNyTkt3wKfOsMWBxZddY2YEmI%2FckfymVKBzGKpYlATSFXUaLturUlAmtcn9VvNzWD5HKCt5AswuPB266dRrF4s6J52nrF9jkIDPTRBLm653WzLfunys9NUjTWnhwZ1Ki2gc1GGzMc2RBqwUpOpJi%2BAIPc1enArUjn9xl9sbLdAontUUbv%2B6nf13SfUXrirbO%2BmGtnX%2FNT9FAsQbKJiGW3BpElnrCvmBB39WDvFW4k3zxLuT6xhf%2FGHYXeRQWklA0Um1K3cLNpzuw%3D%3D%7Ctkp%3ABFBM4IHG49Bl",
          "seller": {
            "name": "electronicdea1s",
            "reviews": 10448,
            "positive_feedback_percent": 98.1
          },
          "price": "$194.99",
          "extracted_price": 194.99,
          "items_sold": "177+ sold",
          "extracted_items_sold": 177,
          "thumbnail": "https://i.ebayimg.com/images/g/t4wAAOSwg4hkCgdI/s-l140.jpg"
        },
        ...
      ]
    },
    ...
  ],
  "related_searches": [
    {
      "query": "cell phones smartphones",
      "link": "https://www.ebay.com/sch/i.html?_nkw=cell+phones+smartphones&_sop=12"
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.ebay.com/sch/i.html?_nkw=cell+phone&_fcid=1&_pgn=2",
    "other_pages": {
      "2": "https://www.ebay.com/sch/i.html?_nkw=cell+phone&_fcid=1&_pgn=2",
      "3": "https://www.ebay.com/sch/i.html?_nkw=cell+phone&_fcid=1&_pgn=3",
      ...
    }
  }
}

Organic Results - By Query

Organic Results - By Query
GET
https://www.searchapi.org/api/v1/search?engine=ebay_search&q=shoes
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "ebay_search",
  "q": "shoes"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "position": 1,
      "item_id": "335217770415",
      "title": "NEW Nike Air Jordan 1 Chicago Lost & Found Reimagined Red White Size 10.5 Mens",
      "link": "https://www.ebay.com/itm/335217770415?_skw=...",
      "condition": "Brand New",
      "authenticity": "Authenticity Guarantee",
      "is_sponsored": true,
      "rating": 5,
      "reviews": 16,
      "reviews_link": "https://www.ebay.com/p/8058292535?iid=335217770415&var=544480037147#UserReviews",
      "buying_format": "Buy It Now",
      "is_buy_it_now": true,
      "price": "$449.99",
      "extracted_price": 449.99,
      "original_price": "$499.99",
      "extracted_original_price": 499.99,
      "discount": "10% off",
      "shipping": "+$14.95 delivery",
      "extracted_shipping": 14.95,
      "thumbnail": "https://i.ebayimg.com/images/g/CJYAAOSwmtFlqsPp/s-l500.jpg"
    },
    ...
  ]
}

Organic Results - By Category

Organic Results - By Category
GET
https://www.searchapi.org/api/v1/search?category_id=25863&engine=ebay_search
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "ebay_search",
  "category_id": "25863"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "position": 1,
      "item_id": "354755285893",
      "title": "Folding Adirondack Chair, Cedar Wood Outdoor Fire Pit Patio Seating",
      "link": "https://www.ebay.com/itm/354755285893?itmmeta=01JT356BG8CWDC20PM1R5340SX&hash=item5299101385:g:K-kAAOSwZQJkT8qz&itmprp=enc%3AAQAKAAAA4MHg7L1Zz0LA5DYYmRTS30mulhJnX5DHyOK%2BCrJi1uDJMTeBiDgzJbUqhUbmkJon2ekH%2FQ4ZeNpjMS3JGku%2FswBnRg65MpeklXqQQl5%2BbpNJGpZIj0Lf2mIgjySwBHjdW3UKqL7%2BF7%2B5JyEptJbstxVXPbJW9LefuXCVHeCmsiZA9egoSRn9I3OWr3EtlZneoFO1vLiyWAP093mRGSbFgN7xwWRN9JC%2BCp%2BAMtkpgrDFyaFtsCX1ELWq7mTM9NMr9UwZ2itbUdvOfDeYbm7h7GaOdKwyOchacmnu3zQxFDcz%7Ctkp%3ABFBMqriZ5dBl&var=624086155018",
      "condition": "Brand New",
      "is_sponsored": true,
      "price": "$63.99 to $252.99",
      "extracted_price_range": {
        "from": 63.99,
        "to": 252.99
      },
      "is_price_range": true,
      "watching": "50 watching",
      "extracted_watching": 50,
      "shipping": "Free shipping",
      "thumbnail": "https://i.ebayimg.com/thumbs/images/g/K-kAAOSwZQJkT8qz/s-l400.jpg",
      "images": [
        "https://i.ebayimg.com/images/g/TPIAAOSw8dZkT8qz/s-l225.jpg",
        "https://i.ebayimg.com/images/g/MZMAAOSwW9FkT8qz/s-l225.jpg",
        "https://i.ebayimg.com/images/g/wTsAAOSwl-1kT8qz/s-l225.jpg"
      ]
    },
    ...
  ]
}

Sections

Sections
GET
https://www.searchapi.org/api/v1/search?engine=ebay_search&q=Percy+Jackson
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "ebay_search",
  "q": "Percy Jackson"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "sections": [
    {
      "title": "Picked For You",
      "subtitle": "Top selling items from trusted sellers",
      "is_sponsored": true,
      "has_items": true,
      "results": [
        {
          "position": 1,
          "item_id": "275476834372",
          "title": "Percy Jackson and the Olympians, Book One The Lightning Thief (Percy Jack - GOOD",
          "link": "https://www.ebay.com/itm/275476834372?_skw=Percy+Jackson&epid=26038504781&itmmeta=01JT35DD0MTTZA3NNWM4V23M3E&hash=item4023b2e844:g:49sAAOSwboFjSsQl&itmprp=enc%3AAQAKAAAA8FkggFvd1GGDu0w3yXCmi1fP87XqgEvBSErKcTTh4mCB3jJK2bKVrIm5rrU6ROMjoFyXurhErcHuoukku6xpS4tAHqmTal5ItDpNQMSDdHu9JDhYmAyMbB1WKbqTq9igumtDj4Li3ioL2IZSjRH5oaLHZb1s3T7e6jIayh6usANAvhcTa3KNvs3%2B%2Fnb008fQROl1MTQMdhbqoHaQ%2Bn1oyFulZSamaFQEeM1fi9RkpDdZ12xeWqrEMcglnrg102l6zZxLZz5uhT8Csx3WPwoWOIgMpatvUSlhf95KG4EeIyQbibGWpelBWjVPPAzJPtwuWg%3D%3D%7Ctkp%3ABFBMgtG15dBl",
          "seller": {
            "name": "second.sale",
            "reviews": 4083735,
            "positive_feedback_percent": 98.4
          },
          "price": "$3.77",
          "extracted_price": 3.77,
          "deal": "Buy 3, get 1 free",
          "stock": "Almost gone",
          "thumbnail": "https://i.ebayimg.com/images/g/49sAAOSwboFjSsQl/s-l140.jpg"
        },
        {
          "position": 2,
          "item_id": "274278459855",
          "title": "The Demigod Files (A Percy Jackson and the Olympians Guide) - VERY GOOD",
          "link": "https://www.ebay.com/itm/274278459855?_skw=Percy+Jackson&epid=3038831154&itmmeta=01JT35DD0M7FAV9V0JP0HNKXK8&hash=item3fdc4529cf:g:EBoAAOSwOIBgnF9w&itmprp=enc%3AAQAKAAAA8FkggFvd1GGDu0w3yXCmi1ey6aHVaFexEDTWicpHfyfl8%2Bov0SWiMLZ6eScze2ufk9ZLjbXoUiJLd4BglMtyxQ%2BLAoegKvXN5%2FQ8qMYUN%2B4Hya4XOT9Wqlb6hnRDhpNRI6g%2F3FjN8KPelOA9K7UpK1kBbbHpN2ir88xWmKDvdqhaxHAp6Z5P89s2%2Bv5osBnSBdTxa2P0DBLGiGQVYc%2B0WZedu0BQxmkHvRKz%2FmpghMjytX1cu9CSk3WJksUdWqKX4JLnv33FGfeMDZUJ4530j8xtUQkwagIntSJi8jsAncgfOJ12EhrffdkqdpdGStQuRg%3D%3D%7Ctkp%3ABFBMgtG15dBl",
          "seller": {
            "name": "second.sale",
            "reviews": 4083735,
            "positive_feedback_percent": 98.4
          },
          "price": "$4.26",
          "extracted_price": 4.26,
          "deal": "Buy 3, get 1 free",
          "items_sold": "355 sold",
          "extracted_items_sold": 355,
          "thumbnail": "https://i.ebayimg.com/images/g/EBoAAOSwOIBgnF9w/s-l140.jpg"
        },
        ...
      ]
    },
    ...
  ]
}