API di eBay

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.

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%

Cosa ha restituito l'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 campi in più
}
Disponibilità
99,94%
30d · 10.427 chiamate
Richieste
10.471
30 g · settimanale, ultime 12 sett.
Risposta
3,5s
mediana · 30d

Provalo

Ottieni eBay Ricerca in una sola richiesta

conditionarray
Filtra per una o più condizioni dell'articolo; omettilo per tutte le condizioni (es. ["new", "open_box"]).
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.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

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).

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

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.

  • 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.

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.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

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.

Costa da 1,20 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

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. La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

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. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 83 chiamate eBay Ricerca a 0,0012 USD ciascuna.

AnyAPI interroga la successiva delle sue 3 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/ebay.search con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.