eBay · Browse API · Migrazione
eBay Browse API: cosa fare ora che Finding e Shopping sono spente
Le storiche API Finding e Shopping di eBay sono state decommissionate (deprecate nel 2024 e spente all'inizio del 2025). Se la tua integrazione le usava per cercare prodotti o leggere i dati di un'inserzione, ora non rispondono più. Il sostituto è la Browse API RESTful. Questa guida spiega cosa cambia e come migrare.
Cosa è stato spento e perché
Finding (ricerca per parole chiave) e Shopping (dettagli di un singolo item) erano API legacy in stile XML. eBay le ha ritirate a favore delle REST, più moderne e mantenute. La Browse API copre i casi d'uso lato acquirente: ricerca, dettaglio item e recupero per ID legacy.
La Browse API in breve
| Serve a | Metodo Browse |
|---|---|
| Cercare item per parole chiave/filtri | item_summary/search |
| Dettaglio di un item | getItem |
| Recuperare un item dal vecchio ID | getItemByLegacyId |
Autenticazione
La Browse API usa OAuth: per la ricerca pubblica è sufficiente un application access token (client credentials), senza token utente. Conserva client id e secret in modo sicuro e rinnova il token alla scadenza, applicando le stesse cautele della guida alla eBay Sell API.
Come migrare le chiamate
- Ricerca:
findItemsByKeywords(Finding) →item_summary/searchcon parametriq, filtri e paginazione; - Dettaglio:
GetSingleItem(Shopping) →getItemoppuregetItemByLegacyIdse parti dall'ID vecchio; - rimappa i campi della risposta: la struttura REST è diversa da quella XML.
Errori comuni
- continuare a chiamare gli endpoint legacy e gestire i 404/errori come transitori;
- riprodurre i campi XML uno-a-uno invece di rimappare sul modello REST;
- ignorare i rate limit della Browse API (vedi errori comuni nelle integrazioni eBay).
Conclusione
Se vedi ricerche che non tornano più risultati, la causa è quasi sempre Finding/Shopping spente: la Browse API è la strada. Per il lato venditore, il discorso è più ampio e riguarda anche la scelta tra Sell API e Trading API e la migrazione delle chiamate Trading deprecate. Riferimento: stato di deprecazione delle API eBay.