eBay Ricerca API
Cerca inserzioni eBay attive per parola chiave con filtri facoltativi per fascia di prezzo, condizione dell'articolo, tipo di inserzione e ordinamento e ottieni titolo, prezzo, condizione, spedizione e venditore in un'unica risposta normalizzata.
1,20 USD/1k richieste, paghi a richiesta, nessun abbonamento.
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 campi in più}
Prezzi e provider
Prezzi dell'API eBay Ricerca: una sola API, 3 provider intercambiabili
Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.
con tetto di 0,0732 USD a richiesta1 risultato0,00408 USD13 risultati0,03864 USD25 risultatitetto di 0,0732 USDPaghi per ciò che torna indietro. Abbassa il limite per pagare meno - e nessuna singola richiesta può costare più del tetto, per quanto torni indietro.
Provalo
Ottieni eBay Ricerca in una sola richiesta
Questo esempio mostra 16 campi su 17. Vedi tutti i campi
{
"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
}
]
}
}Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.
Riferimento
Una richiesta, una sola forma di risposta.
Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.
Ultima verifica 2026-11-21 · disponibilità e latenza misurate su 30d
Corpo della richiesta
JSON, inviato a questo endpoint.
- querystring
nintendo switch
Parole chiave di ricerca, es. "nintendo switch" o "vintage levis 501".
- conditionarray
Filtra per una o più condizioni dell'articolo; omettilo per tutte le condizioni (es. ["new", "open_box"]).
- limitinteger
3
Numero massimo di risultati da restituire (da 1 a 25, predefinito 25).
- listingTypeenum
Limita a un formato di inserzione; omettilo o usa all per entrambi (es. buy_it_now solo per il prezzo fisso).
- maxPriceinteger
Prezzo massimo facoltativo dell'articolo in USD.
- minPriceinteger
Prezzo minimo facoltativo dell'articolo in USD.
- requireFieldsarray
Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `sellerName`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un'inserzione che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.
- sortenum
price_low
Ordinamento dei risultati; omettilo per il Best Match di eBay (es. price_low ordina prima per prezzo più basso più spedizione).
Risposta
JSON, un valore di esempio per campo.
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.
- listingTypestringpuò richiedere
Auction
Auction, FixedPrice, etc. Null when the serving source does not publish the listing format.
- pricenumber
129.5
Listing price.
- sellerFeedbackCountnumberpuò richiedere
3204
Seller's lifetime feedback count, or null when the serving source does not publish it.
- sellerFeedbackPercentnumberpuò richiedere
97.8
Seller positive-feedback percentage, or null when the serving source does not publish it.
- sellerNamestringpuò richiedere
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.
FAQ
Sull'API eBay Ricerca
L'API eBay Ricerca di AnyAPI restituisce dati eBay come JSON normalizzato da una sola chiamata POST a /v1/run/ebay.search. Cerca inserzioni eBay attive per parola chiave con filtri facoltativi per fascia di prezzo, condizione dell'articolo, tipo di inserzione e ordinamento e ottieni titolo, prezzo, condizione, spedizione e venditore in un'unica risposta normalizzata. AnyAPI instrada ogni richiesta su 3 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 1,20 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 99,9% delle chiamate eBay Ricerca tramite AnyAPI è riuscito, con un tempo di risposta mediano di 3,5 secondi su 10.427 chiamate misurate.