eBay Поиск API
Ищет активные объявления eBay по ключевому слову с необязательными фильтрами по диапазону цен, состоянию товара, типу объявления и сортировке и возвращает название, цену, состояние, доставку и продавца в одном нормализованном ответе.
1,20 USD/1 тыс. запросов, оплата за запрос, без подписки.
Condition
Buying format
Price
Item location
Nintendo Switch Lite Handheld Console - Turquoise - Used
Used · 12 bids
$129.5
+$8.99 shipping
retro_games_hub (3204) 97.8%
Nintendo Switch Console (Original 2017 Model) - Neon Red/Blue
Used
$179.99
Free shipping
consoleworld_usa (9871) 98.1%
Nintendo Switch OLED Model Console - White
New
$249.99
Free shipping
game_deals_plus (41209) 99.5%
{"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}
Цены и поставщики
Цена API eBay Поиск: один API, поставщиков 3, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
не больше 0,0732 USD за запрос1 результат0,00408 USDРезультатов: 130,03864 USDРезультатов: 25Лимит 0,0732 USDВы платите за то, что вернулось. Снизьте лимит, чтобы платить меньше: ни один запрос не обойдётся дороже лимита, сколько бы ни вернулось.
Попробовать
Получите eBay Поиск одним запросом
В этом примере показано полей: 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, по одному примеру значения на поле.
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.
- 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.