API eBay

eBay Поиск API

Ищет активные объявления eBay по ключевому слову с необязательными фильтрами по диапазону цен, состоянию товара, типу объявления и сортировке и возвращает название, цену, состояние, доставку и продавца в одном нормализованном ответе.

1,20 USD/1 тыс. запросов, оплата за запрос, без подписки.

nintendo switch | eBay
ebay.com/sch/i.html?_nkw=nintendo+switch
Hi! Sign inor registerDaily DealsBrand OutletGift CardsHelp & ContactShip toSellWatchlistMy eBay
ebay
All Categoriesnintendo switch
Advanced
3+ results for nintendo switch

Condition

Buying format

Price

Item location

photo

Nintendo Switch Lite Handheld Console - Turquoise - Used

Used · 12 bids

$129.5

+$8.99 shipping

retro_games_hub (3204) 97.8%

photo

Nintendo Switch Console (Original 2017 Model) - Neon Red/Blue

Used

$179.99

Free shipping

consoleworld_usa (9871) 98.1%

photo

Nintendo Switch OLED Model Console - White

New

$249.99

Free shipping

game_deals_plus (41209) 99.5%

Что вернул APIitems[0]
{
"itemId": "225876341102",
"title": "Nintendo Switch Lite Handheld Console - Turquoise - Used",
"url": "https://www.ebay.com/itm/225876341102",
"price": 129.5,
"condition": "Used",
"listingType": "Auction",
"sellerName": "retro_games_hub",
"sellerFeedbackPercent": 97.8,
... ещё полей: 5
}
Доступность
99,94%
30d · Вызовов: 10 427
Запросы
10 471
30 дн. · по неделям, последние недель: 12
Ответ
3,5s
медиана · 30d

Цены и поставщики

Цена API eBay Поиск: один API, поставщиков 3, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Вы платите
12,00 USD
1,20 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (83) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите eBay Поиск одним запросом

conditionarray
Фильтр по одному или нескольким состояниям товара; не указывайте, чтобы получить все состояния (например, ["new", "open_box"]).
requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `sellerName`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в объявлении, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.

В этом примере показано полей: 16 из 17. Все поля

{
  "found": true,
  "data": {
    "items": [
      {
        "itemId": "225876341102",
        "title": "Nintendo Switch Lite Handheld Console - Turquoise - Used",
        "url": "https://www.ebay.com/itm/225876341102",
        "price": 129.5,
        "condition": "Used",
        "listingType": "Auction",
        "sellerName": "retro_games_hub",
        "sellerFeedbackPercent": 97.8,
        "shippingCost": "$8.99",
        "image": "https://i.ebayimg.com/images/g/3xkAAOSwLmhk3z4A/s-l500.jpg",
        "currency": "USD",
        "bidCount": 12,
        "sellerFeedbackCount": 3204
      },
      {
        "itemId": "205512873341",
        "title": "Nintendo Switch Console (Original 2017 Model) - Neon Red/Blue",
        "url": "https://www.ebay.com/itm/205512873341",
        "price": 179.99,
        "condition": "Used",
        "listingType": "FixedPrice",
        "sellerName": "consoleworld_usa",
        "sellerFeedbackPercent": 98.1,
        "shippingCost": "$0.00",
        "image": "https://i.ebayimg.com/images/g/7wYAAOSwXqhk3z4B/s-l500.jpg",
        "currency": "USD",
        "sellerFeedbackCount": 9871
      },
      {
        "itemId": "204521873366",
        "title": "Nintendo Switch OLED Model Console - White",
        "url": "https://www.ebay.com/itm/204521873366",
        "price": 249.99,
        "condition": "New",
        "listingType": "FixedPrice",
        "sellerName": "game_deals_plus",
        "sellerFeedbackPercent": 99.5,
        "shippingCost": "Free",
        "image": "https://i.ebayimg.com/images/g/5vNAAOSwZthk3z4C/s-l500.jpg",
        "currency": "USD",
        "sellerFeedbackCount": 41209
      }
    ]
  }
}

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-11-21 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • querystring

    nintendo switch

    Ключевые слова для поиска, например "nintendo switch" или "vintage levis 501".

  • conditionarray

    Фильтр по одному или нескольким состояниям товара; не указывайте, чтобы получить все состояния (например, ["new", "open_box"]).

  • limitinteger

    3

    Максимальное число возвращаемых результатов (от 1 до 25, по умолчанию 25).

  • listingTypeenum

    Ограничить форматом объявления; не указывайте или передайте all для обоих (например, buy_it_now только для фиксированной цены).

  • maxPriceinteger

    Необязательная максимальная цена товара в долларах США.

  • minPriceinteger

    Необязательная минимальная цена товара в долларах США.

  • requireFieldsarray

    Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `sellerName`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в объявлении, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.

  • sortenum

    price_low

    Порядок сортировки результатов; не указывайте, чтобы получить Best Match eBay (например, price_low сортирует сначала по самой низкой цене с доставкой).

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

each itemdata.items[]

Listing records: title, price, condition, shipping cost, seller info, image, and item URL. Populated whenever the provider has data for the entity.

  • bidCountinteger

    12

    Bids placed so far, for auction listings.

  • conditionstring

    Used

  • currencystring

    USD

    ISO currency code of the price (e.g. USD).

  • imagestring

    https://i.ebayimg.com/images/g/3xkAAOSwLmhk3z4A/s-l500.jpg

    Primary listing image URL. Populated whenever the provider has data for the entity.

  • itemIdstring

    225876341102

    eBay item identifier. Populated whenever the provider has data for the entity.

  • listingTypestringможет потребовать

    Auction

    Auction, FixedPrice, etc. Null when the serving source does not publish the listing format.

  • pricenumber

    129.5

    Listing price.

  • sellerFeedbackCountnumberможет потребовать

    3204

    Seller's lifetime feedback count, or null when the serving source does not publish it.

  • sellerFeedbackPercentnumberможет потребовать

    97.8

    Seller positive-feedback percentage, or null when the serving source does not publish it.

  • sellerNamestringможет потребовать

    retro_games_hub

    Seller username, or null when the serving source does not publish the seller.

  • shippingCoststring

    $8.99

    Shipping cost or free-delivery label.

  • titlestring

    Nintendo Switch Lite Handheld Console - Turquoise - Used

    Populated whenever the provider has data for the entity.

  • urlstring

    https://www.ebay.com/itm/225876341102

    Populated whenever the provider has data for the entity.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Вы получаете. Именованные типизированные поля в одном формате, какой бы источник ни ответил.

Вопросы и ответы

Об API eBay Поиск

AnyAPI eBay Поиск API возвращает данные eBay в виде нормализованного JSON одним вызовом POST к /v1/run/ebay.search. Ищет активные объявления eBay по ключевому слову с необязательными фильтрами по диапазону цен, состоянию товара, типу объявления и сортировке и возвращает название, цену, состояние, доставку и продавца в одном нормализованном ответе. AnyAPI направляет каждый запрос по источникам (их 3) и автоматически переключается, если один из них отказывает. Это стоит от 1,20 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 99,9% вызовов eBay Поиск через AnyAPI завершились успешно, медианное время ответа 3,5 с, измерено вызовов: 10 427.

Это стоит от 1,20 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Ищет активные объявления eBay по ключевому слову с необязательными фильтрами по диапазону цен, состоянию товара, типу объявления и сортировке и возвращает название, цену, состояние, доставку и продавца в одном нормализованном ответе. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 99,9% вызовов eBay Поиск через AnyAPI завершились успешно, медианное время ответа 3,5 с, измерено вызовов: 10 427. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 83 вызовов eBay Поиск по 0,0012 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 3), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/ebay.search с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.