API di eBay
Cerca su eBay schede prodotto attive o vendute, inventari dei venditori e feedback degli acquirenti per confrontare i prezzi degli articoli.
Quando confronti i prezzi, tieni separate le schede prodotto attive da quelle vendute e verifica cosa rappresenta un record di tipo best offer.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su ebay e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 5 funzionalità
- Da $0.96 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di eBay: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Operatività nelle ultime 24 ore |
|---|---|---|---|
Ricercasearch | Trova schede eBay per una keyword. | Normale | |
Storestore | Estrai le schede degli articoli dal negozio di un venditore eBay tramite il suo username seller esatto, con prezzo, condizioni, spedizione e immagine per ciascun articolo. | Normale | |
Recensionireviews | Leggi i feedback degli acquirenti per una scheda eBay. | Normale | |
Schede prodotto vendutesold | Monitora le vendite completate su eBay per una keyword in una finestra retroattiva espressa in giorni. | Normale | |
Dettagli del prodottoproduct_detail | Leggi per intero una scheda eBay dal suo link o dall'ID numerico dell'oggetto: prezzo, condizioni, disponibilità, tipo di inserzione, flag proposta d'acquisto, spedizione e resi, osservatori, marca e codici di catalogo, percorso della categoria, tutte le immagini, oltre al punteggio di feedback e alla percentuale di feedback positivi del venditore. | $0.96 per 1.000 richieste | Temporaneamente non disponibile |
Cosa accetta ogni azione di API di eBay?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Trova schede eBay per una | keyword | condition, country, domain, max_price, min_price, sold_only | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform | |
storeStore Estrai le schede degli articoli dal negozio di un venditore eBay tramite il suo username | seller | country, domain, store, url, username | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform | |
reviewsRecensioni Leggi i feedback degli acquirenti per una scheda eBay. Identificala con lo username | seller, item_id | country, domain, product_id, q, seller_name, url, username | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | text · rating · rating_scale · username · submitted_at · seller_reply · image_count · reviewer_feedback_score · reviewer_feedback_star · product_name · product_id · product_price · platform · image_url · images | |
soldSchede prodotto vendute Monitora le vendite completate su eBay per una | keyword | days, min_price, site, sort | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · name · sold_price · shipping_price · total_price · currency · sold_at · condition · listing_type · best_offer_accepted · category · seller_username · seller_feedback_score · seller_positive_percent · image_url · platform | |
product_detailDettagli del prodotto Leggi per intero una scheda eBay dal suo link o dall'ID numerico dell'oggetto: prezzo, condizioni, disponibilità, tipo di inserzione, flag proposta d'acquisto, spedizione e resi, osservatori, marca e codici di catalogo, percorso della categoria, tutte le immagini, oltre al punteggio di feedback e alla percentuale di feedback positivi del venditore. I campi delle aste come | url | — | — | $0.96 per 1.000 richieste | item_id · title · subtitle · url · price · currency · condition · availability · listing_type · bid_count · best_offer_enabled · ends_at · quantity_available · quantity_sold · watchers · brand · model · mpn · gtin · product_id · categories · image_url · images · item_location · shipping_price · free_shipping · returns_accepted · seller · seller_url · seller_feedback_score · seller_positive_percent · updated_at · platform |
Cosa significano i parametri search di API di eBay?
Trova schede eBay per una keyword. Ottieni prezzo richiesto, valuta, condizioni, termini di spedizione e venditore. Puoi filtrare per condizioni, dominio del sito o fascia di prezzo. sold_only mantiene le schede rilevate come vendute. Non misura il volume complessivo del mercato.
keywordObbligatorio- Termine di ricerca per le inserzioni attive nelle azioni
searcho per le inserzioni concluse/vendute nelle azionisold. Non dare per scontato che i prezzi richiesti nelle inserzioni attive corrispondano agli importi finali delle transazioni. conditionFacoltativo- Filtra i risultati di ricerca per condizione dell'articolo. Mantieni maiuscole e spazi: New, Used, Refurbished o For parts or not working. È un filtro sulla condizione dell'articolo, non sulle recensioni positive o negative.
countryFacoltativo- Input di compatibilità per domain che accetta anch'esso un dominio di un sito eBay come ebay.com, non un codice paese come US o DE. Se sono presenti entrambi, domain ha la precedenza.
domainFacoltativo- Seleziona il dominio del sito eBay, ad esempio ebay.com, ebay.de o ebay.co.uk, senza schema né percorso. Il valore predefinito è ebay.com e viene usato per costruire le pagine di search, store e reviews.
max_priceFacoltativo- Imposta un limite numerico superiore per i prezzi degli articoli in search. Usalo con min_price per definire un intervallo e non dare per scontato che spedizione o tasse siano incluse.
min_priceFacoltativo- Imposta un limite numerico inferiore per i prezzi degli articoli. Filtra i prezzi delle inserzioni attive nelle azioni
searche quelli delle inserzioni concluse/vendute nelle azionisold. La valuta è determinata dal sito marketplace di destinazione e dai dati delle inserzioni, non dall'addebito delle API. Insold, il filtro usa numeri interi e i decimali vengono arrotondati per difetto. sold_onlyFacoltativo- Opzione booleana nelle azioni
searchche, se impostata sutrue, restituisce solo le vendite concluse. Va passata come booleano JSON, non come stringa ("false").
Cosa significano i parametri store di API di eBay?
Estrai le schede degli articoli dal negozio di un venditore eBay tramite il suo username seller esatto, con prezzo, condizioni, spedizione e immagine per ciascun articolo. Ottieni solo le schede, non il saldo del venditore, la reputazione privata o l'inventario interno.
sellerObbligatorio- Lo username esatto dell'account venditore eBay, non il titolo visualizzato del negozio né il nome dell'azienda. Viene usato nelle query
storeper recuperare le inserzioni del venditore e nelle queryreviews, insieme aitem_id, per recuperare i feedback degli acquirenti. countryFacoltativo- Input di compatibilità per domain che accetta anch'esso un dominio di un sito eBay come ebay.com, non un codice paese come US o DE. Se sono presenti entrambi, domain ha la precedenza.
domainFacoltativo- Seleziona il dominio del sito eBay, ad esempio ebay.com, ebay.de o ebay.co.uk, senza schema né percorso. Il valore predefinito è ebay.com e viene usato per costruire le pagine di search, store e reviews.
storeFacoltativo- Alias di compatibilità per
sellerche rappresenta lo username dell'account venditore, non un titolo di negozio qualsiasi. L'azionestorerichiede comunque il parametro principaleseller. urlFacoltativo- Sostituisce la costruzione automatica dell'URL con una pagina diretta delle inserzioni del negozio/venditore eBay nelle azioni
storeo con una pagina di feedback/fdbk/nelle azionireviews. Fornire un URL non elimina l'obbligo dei parametriselleroitem_id. usernameFacoltativo- Alias di compatibilità per lo username dell'account
sellernelle azionistoreereviews. Il parametrosellerha la precedenza e resta obbligatorio; questo campo non rappresenta gli handle di acquirenti o autori di recensioni.
Cosa significano i parametri reviews di API di eBay?
Leggi i feedback degli acquirenti per una scheda eBay. Identificala con lo username seller e l'item_id. Ottieni valutazione, risposta del venditore, punteggio di feedback del recensore e dettagli del prodotto. Lo storico completo dei feedback non è garantito.
sellerObbligatorio- Lo username esatto dell'account venditore eBay, non il titolo visualizzato del negozio né il nome dell'azienda. Viene usato nelle query
storeper recuperare le inserzioni del venditore e nelle queryreviews, insieme aitem_id, per recuperare i feedback degli acquirenti.eBay: profili di feedback sulle transazioni — Il feedback sulle transazioni di eBay consiste in valutazioni positive, neutre o negative accompagnate da brevi commenti; il profilo di feedback di un membro è un concetto distinto dalle normali recensioni di prodotto basate su una scala a 5 stelle. · Verificato item_idObbligatorio- L'identificatore numerico dell'articolo eBay associato all'inserzione di un venditore (di solito estratto dagli URL
/itm/), usato insieme asellernelle queryreviews. Rappresenta un'inserzione specifica, non un ID prodotto generico del catalogo né l'ID di una recensione. countryFacoltativo- Input di compatibilità per domain che accetta anch'esso un dominio di un sito eBay come ebay.com, non un codice paese come US o DE. Se sono presenti entrambi, domain ha la precedenza.
domainFacoltativo- Seleziona il dominio del sito eBay, ad esempio ebay.com, ebay.de o ebay.co.uk, senza schema né percorso. Il valore predefinito è ebay.com e viene usato per costruire le pagine di search, store e reviews.
product_idFacoltativo- Alias di compatibilità per
item_idche accetta l'identificatore numerico dell'articolo eBay. Le azionireviewsrichiedono comunqueitem_id. qFacoltativo- Alias di compatibilità per
item_idche accetta l'identificatore numerico dell'articolo eBay nelle azionireviews. Non funziona come query di ricerca a testo libero; per le ricerche di prodotti usakeyword. seller_nameFacoltativo- Lo username dell'account venditore eBay.
urlFacoltativo- Sostituisce la costruzione automatica dell'URL con una pagina diretta delle inserzioni del negozio/venditore eBay nelle azioni
storeo con una pagina di feedback/fdbk/nelle azionireviews. Fornire un URL non elimina l'obbligo dei parametriselleroitem_id. usernameFacoltativo- Alias di compatibilità per lo username dell'account
sellernelle azionistoreereviews. Il parametrosellerha la precedenza e resta obbligatorio; questo campo non rappresenta gli handle di acquirenti o autori di recensioni.
Cosa significano i parametri sold di API di eBay?
Monitora le vendite completate su eBay per una keyword in una finestra retroattiva espressa in giorni. Ottieni prezzo di vendita, spedizione, prezzo totale, data di vendita, tipo di inserzione e feedback del venditore. I dati descrivono ogni inserzione chiusa. Non stimano ricavi netti né domanda futura.
keywordObbligatorio- Termine di ricerca per le inserzioni attive nelle azioni
searcho per le inserzioni concluse/vendute nelle azionisold. Non dare per scontato che i prezzi richiesti nelle inserzioni attive corrispondano agli importi finali delle transazioni. daysFacoltativo- Numero intero che indica la finestra storica in giorni per le query
sold(predefinito30). Indica un intervallo di tempo, non la durata dell'inserzione né il numero di articoli restituiti; per intervalli di giorni arbitrari non sono garantiti record completi. min_priceFacoltativo- Imposta un limite numerico inferiore per i prezzi degli articoli. Filtra i prezzi delle inserzioni attive nelle azioni
searche quelli delle inserzioni concluse/vendute nelle azionisold. La valuta è determinata dal sito marketplace di destinazione e dai dati delle inserzioni, non dall'addebito delle API. Insold, il filtro usa numeri interi e i decimali vengono arrotondati per difetto. siteFacoltativo- Specifica il dominio eBay per le query
sold(ad esempioebay.comoebay.co.uk), conebay.comcome predefinito. È distinto dal parametrodomainusato nelle azionisearch,storeoreviews; la valuta dei prezzi corrisponde ai record delle inserzioni restituiti. sortFacoltativo- Ordinamento per le azioni
sold; i valori consentiti sononewest(prima le inserzioni concluse più di recente) edistance(vicinanza). Non ordina per data di creazione originale dell'inserzione. Se omesso, ordina per conclusione più recente.Valori ammessi:distancenewest
Cosa significano i parametri product_detail di API di eBay?
Leggi per intero una scheda eBay dal suo link o dall'ID numerico dell'oggetto: prezzo, condizioni, disponibilità, tipo di inserzione, flag proposta d'acquisto, spedizione e resi, osservatori, marca e codici di catalogo, percorso della categoria, tutte le immagini, oltre al punteggio di feedback e alla percentuale di feedback positivi del venditore. I campi delle aste come bid_count ed ends_at, e codici come gtin, compaiono solo se la scheda li mostra.
urlObbligatorio- Una singola scheda prodotto eBay: il suo link, ad esempio https://www.ebay.com/itm/133576802017 (i parametri di tracciamento e la parte del titolo vengono rimossi), o solo l'ID numerico dell'elemento, che viene letto su ebay.com. I link di altri siti eBay vengono letti sul sito corrispondente. Pagine di negozi, pagine di ricerca ed elenchi vengono rifiutati prima dell'esecuzione della chiamata.
Come usare l'API di eBay
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"ebay","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di eBay
Cosa posso ottenere con l'API di eBay?
Imposta platform su ebay. Il catalogo attuale elenca ricerca, store, recensioni, schede prodotto vendute e dettagli del prodotto. Questi nomi di azione identificano oggetti o viste diversi di eBay; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di eBay?
Termine di ricerca per le inserzioni attive nelle azioni search o per le inserzioni concluse/vendute nelle azioni sold. Non dare per scontato che i prezzi richiesti nelle inserzioni attive corrispondano agli importi finali delle transazioni. Invialo come keyword all'interno di params.
Quali campi può restituire search di eBay?
Il suo schema dichiarato include item_id, title, price e price_text. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di eBay rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.