API di Taobao
Cerca prodotti su Taobao e Tmall per ottenere specifiche, prezzi, recensioni, dettagli del negozio e domande degli utenti.
Gli URL dei prodotti devono contenere un ID numerico. I link brevi e i token promozionali non si possono leggere direttamente.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su taobao e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 5 funzionalità
- Da $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
- Operatività nelle ultime 24 ore 94%
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- 94%
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Taobao: 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.000 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Cerca schede prodotto Taobao e Tmall per parola chiave. | $13.5 per 1.000 richieste | Buono · operatività 100% |
Dettagli del prodottoproduct_detail | Ottieni il record completo di un prodotto Taobao o Tmall. | $4.5 per 1.000 richieste | Buono · operatività 93% |
Negozioshop | Elenca gli articoli che un venditore Taobao ha in vendita ora: fino a 20 per chiamata, oppure scorri il negozio 60 alla volta. | $1.39 per 1.000 richieste | Buono · operatività 97% |
Recensionireviews | Leggi le recensioni degli acquirenti di un prodotto Taobao, fino a 100 per chiamata, e scorri le pagine per ottenerne altre. | $1.39 per 1.000 richiesteOgni 20 righe valgono una chiamata | Normale |
Domandequestions | Estrai le domande e risposte degli acquirenti sulla pagina di un prodotto Taobao, con numero di risposte e data di pubblicazione di ogni domanda. | $1.39 per 1.000 richieste | Normale |
Cosa accetta ogni azione di API di Taobao?
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.000 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Cerca schede prodotto Taobao e Tmall per parola chiave. Ottieni prezzo e località di spedizione, più unità vendute, valutazione, negozio e dettagli su coupon o sconti, se disponibili. Le ricerche per sola parola chiave sono le più affidabili e supportano la paginazione con | keyword | max_price, min_price, page, sort, tmall_only | Valori del catalogo: defaultLimit=20, maxLimit=20. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $13.5 per 1.000 richieste | id · url · title · price · currency · price_basis · sold_count · rating · rating_scale · location · shop_name · image_url · stock · shop_id · sold_text · original_price · coupon_price · discount_type · is_tmall · brand · category_id · seller_credit_level · seller_positive_rate · shop_score_description · shop_score_service · shop_score_delivery · subtitle · search_rank · free_shipping · selling_points · review_tags · images · discount_rate · spu_id · category_path · review_count · latest_review · seller_type · shop_opened_at · shop_age_years · shop_item_count · shop_score_vs_industry · platform |
product_detailDettagli del prodotto Ottieni il record completo di un prodotto Taobao o Tmall. Comprende marca, prezzi, disponibilità, ogni SKU, attributi, immagini, spese di spedizione e punteggi del negozio. Passa un ID numerico del prodotto, un link al prodotto o un testo di condivisione con esattamente un link al prodotto. Codici di condivisione isolati e link scaduti vengono rifiutati. | url | — | — | $4.5 per 1.000 richieste | id · url · title · brand · price · original_price · currency · price_basis · stock · sold_count · category_id · location · is_tmall · shop_name · shop_id · shipping_fee · ems_fee · express_fee · skus · sku_count · spec_values · props_images · attributes · main_image_url · description_images · description_html · video_url · coupon_price · price_usd · total_price · suggestive_price · has_discount · is_promotion · promo_type · is_virtual · brand_id · root_category_id · category_path · weight · size · favorite_count · fans_count · min_order_quantity · shipping_to · listed_at · modified_at · delist_at · images · category_name · description · keywords · titleOriginal · has_cn_title · shop_score_description · shop_score_service · shop_score_delivery · free_shipping · promotion_price · discount_price · discount_type · price_note · has_price_range · payment_methods · seller_id · seller_credit_level · seller_type · seller_type_label · selling_points · shop_logo_url · shop_url · shop_item_count · shop_new_item_count · shop_opened_at · review_tags · review_count · positive_rate · seven_day_return · reviews · platform |
shopNegozio Elenca gli articoli che un venditore Taobao ha in vendita ora: fino a 20 per chiamata, oppure scorri il negozio 60 alla volta. Ottieni prezzo barrato, categoria, un indicatore di spedizione inclusa, immagine principale e valutazioni del negozio; le righe non riportano vendite né numero di recensioni. | shop | page, seller, sort, user_id | Valori del catalogo: defaultLimit=20, maxLimit=20. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. Un limit più alto è accettato e ridotto a 20. | $1.39 per 1.000 richieste | id · url · title · original_price · currency · category_id · free_shipping · shop_name · shop_id · seller_id · image_url · shop_url · shop_logo_url · shop_score_description · shop_score_service · shop_score_delivery · shop_item_count · platform |
reviewsRecensioni Leggi le recensioni degli acquirenti di un prodotto Taobao, fino a 100 per chiamata, e scorri le pagine per ottenerne altre. Ogni recensione include valutazione, variante acquistata, voti di utilità, foto, recensione aggiuntiva e risposta del venditore. Passa l'ID dell'articolo, un link del prodotto o un testo di condivisione con un solo link di prodotto. Il lotto potrebbe non includere tutte le recensioni. | url | page, page_token | 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. Per la pagina successiva, ripassa next_page_token come page_token con gli altri parametri invariati; ogni pagina è addebitata in base al numero di righe, una chiamata ogni 20 righe. | $1.39 per 1.000 richiesteOgni 20 righe valgono una chiamata | id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · author_avatar_url · images · review_append · platform · next_page_token · seller_reply |
questionsDomande Estrai le domande e risposte degli acquirenti sulla pagina di un prodotto Taobao, con numero di risposte e data di pubblicazione di ogni domanda. | url | — | Valori del catalogo: defaultLimit=10, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $1.39 per 1.000 richieste | id · url · text · answer_count · posted_at · answers · platform |
Cosa significano i parametri search di API di Taobao?
Cerca schede prodotto Taobao e Tmall per parola chiave. Ottieni prezzo e località di spedizione, più unità vendute, valutazione, negozio e dettagli su coupon o sconti, se disponibili. Le ricerche per sola parola chiave sono le più affidabili e supportano la paginazione con page, 20 per pagina, anche se nella maggior parte delle righe mancano unità vendute e nome del negozio. Fasce di prezzo, popular, price_desc e tmall_only non supportano la paginazione, e gli ultimi tre limitano una richiesta a 10 risultati. Disponibilità, autenticità e consegna non sono confermate.
keywordObbligatorio- Specifica il termine di ricerca dei prodotti su Taobao o Tmall per l'azione search. Non esegue una ricerca esatta per nome del negozio.
max_priceFacoltativo- Imposta il filtro sul prezzo massimo degli articoli per l'azione search, insieme a min_price. Non controlla i limiti di inventario degli SKU. I decimali possono essere arrotondati per eccesso a un numero intero. Le ricerche con un intervallo di prezzo non supportano la paginazione.
min_priceFacoltativo- Imposta il filtro sul prezzo minimo degli articoli per l'azione search. Non è un filtro sul punteggio delle recensioni né un parametro sul costo dell'API e non si applica a shop, product_detail, reviews o questions. I decimali possono essere arrotondati per difetto a un numero intero. Le ricerche con un intervallo di prezzo non supportano la paginazione.
pageFacoltativo- Numero di pagina per la ricerca prodotti, da 1 a 50, con 20 risultati per pagina. Omettilo per la pagina 1; ogni pagina viene addebitata come una chiamata. Solo le ricerche per semplice parola chiave supportano la paginazione (senza min_price, max_price o tmall_only, e con sort omesso o relevance). Sono il modo più affidabile per cercare, anche se la maggior parte delle righe non riporta dati di vendita né il nome del negozio. Una pagina superiore a 1 combinata con uno qualsiasi di questi filtri viene rifiutata prima dell'addebito, quindi rimuovi quei filtri per paginare. limit imposta solo quanti risultati di quella pagina ricevi, quindi mantienilo a 20 durante la paginazione. Le classifiche si aggiornano in tempo reale, quindi pagine adiacenti possono a volte ripetere alcuni elementi; elimina i duplicati in base a id quando unisci le pagine.
sortFacoltativo- Per la ricerca prodotti, usa relevance (predefinito), popular o price_desc. Le ricerche default e relevance consentono fino a 20 risultati; popular e price_desc fino a 10 e non possono essere paginate. Le richieste oltre il limite applicabile vengono rifiutate prima dell'addebito, e price_asc non è supportato. Le azioni reviews e questions non accettano sort. Per shop, sort si applica solo quando si pagina con page; vedi i parametri di shop.Valori ammessi:
popularprice_descrelevance tmall_onlyFacoltativo- Se impostato sul booleano true, limita la ricerca prodotti agli articoli Tmall e la richiesta a 10 risultati, senza paginazione. Passa solo un booleano JSON; stringhe come "false" e richieste oltre questo limite vengono rifiutate prima dell'addebito.
Cosa significano i parametri product_detail di API di Taobao?
Ottieni il record completo di un prodotto Taobao o Tmall. Comprende marca, prezzi, disponibilità, ogni SKU, attributi, immagini, spese di spedizione e punteggi del negozio. Passa un ID numerico del prodotto, un link al prodotto o un testo di condivisione con esattamente un link al prodotto. Codici di condivisione isolati e link scaduti vengono rifiutati.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Per product_detail, reviews o questions, usa un ID articolo numerico, un URL di prodotto Taobao/Tmall o un messaggio di condivisione che contenga esattamente un URL di prodotto. I link e.tb.cn e m.tb.cn funzionano solo quando possono essere risolti in modo sicuro in una pagina prodotto. I token composti solo da TaoPassword, i link scaduti e le pagine che non sono di prodotto vengono rifiutati. Una chiamata sincrona richiede al massimo circa 85 secondi; imposta il timeout del client ad almeno 95 secondi.Taobao: la terminologia di ID prodotto e SKU — Taobao definisce l'ID prodotto come le cifre che seguono id= in un link al prodotto, mentre uno SKU descrive una specifica combinazione di attributi, come colore e taglia. ID prodotto e SKU non vanno usati in modo intercambiabile. · Verificato
Cosa significano i parametri shop di API di Taobao?
Elenca gli articoli che un venditore Taobao ha in vendita ora: fino a 20 per chiamata, oppure scorri il negozio 60 alla volta. Ottieni prezzo barrato, categoria, un indicatore di spedizione inclusa, immagine principale e valutazioni del negozio; le righe non riportano vendite né numero di recensioni. shop accetta l'ID utente numerico del venditore o un link del negozio, non il nome del negozio.
shopObbligatorio- Indica l'userId numerico del venditore (sellerId) o un link del negozio (shop<shopId>.taobao.com) per l'azione shop. Restituisce gli articoli che quel venditore ha in vendita. Senza page, ogni richiesta restituisce al massimo 20 articoli: un limit più alto restituisce comunque 20, allo stesso prezzo per chiamata. Con page, scorre il negozio una pagina Taobao alla volta, di solito 60 articoli per pagina. Non è il nome del negozio. Le richieste ripetute per lo stesso negozio con lo stesso sort e la stessa page (o lo stesso limit se non invii page) entro 12 ore restituiscono gli stessi dati della prima e vengono addebitate come di consueto. Se il negozio non esiste, il risultato è vuoto con empty_reason shop_not_found e non viene addebitato nulla; una ripetizione entro 24 ore restituisce lo stesso risultato, anch'essa gratuita.
pageFacoltativo- Numero di pagina dell'elenco articoli del negozio, da 1 a 35. Con
pageottieni pagine intere del negozio Taobao: di solito 60 articoli per pagina e meno nell'ultima, elimitnon ha effetto. Senzapage, la chiamata è un singolo recupero di massimo 20 articoli, come prima. Ogni pagina è addebitata come una chiamata allo stesso prezzo; una pagina oltre l'ultima restituisce un risultato vuoto e non viene addebitata, quindi una pagina vuota significa che sei arrivato alla fine. Taobao elenca al massimo circa i primi 2.060 articoli per ordinamento (pagina 35), quindi i negozi con più articoli non possono essere letti per intero; un altrosortrestituisce una parte diversa del catalogo. Mantieni lo stessosortsu ogni pagina. Le classifiche si aggiornano in tempo reale, quindi pagine adiacenti possono occasionalmente ripetere alcuni articoli; deduplica peridquando unisci le pagine. Una pagina richiede di solito da 10 a 45 secondi, e fino a circa 60 secondi quando deve essere ritentata. sellerFacoltativo- Fallback di compatibilità per lo userId numerico del venditore nell'azione shop. Accetta solo ID utente numerici, non i nickname dei venditori, e ha priorità inferiore rispetto a shop e user_id.
sortFacoltativo- Ordine degli articoli quando si pagina con
page:popular,best_sellingosalesper vendite (predefinito);newonewly_listedper inserimento più recente;price_ascolowest_priceper prezzo, dal più basso al più alto;price_descohighest_priceper prezzo, dal più alto al più basso. Gli ordinamenti per prezzo seguono il prezzo di vendita, mentre le righe riportanooriginal_price(il prezzo barrato), quindi potrebbero non sembrare ordinate perfettamente. Senzapage, sort è accettato ma non è garantito che abbia effetto.Valori ammessi:best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales user_idFacoltativo- Fallback di compatibilità per lo userId numerico del venditore nell'azione shop. Ha priorità inferiore rispetto a shop e non può essere usato come ID prodotto.
Cosa significano i parametri reviews di API di Taobao?
Leggi le recensioni degli acquirenti di un prodotto Taobao, fino a 100 per chiamata, e scorri le pagine per ottenerne altre. Ogni recensione include valutazione, variante acquistata, voti di utilità, foto, recensione aggiuntiva e risposta del venditore. Passa l'ID dell'articolo, un link del prodotto o un testo di condivisione con un solo link di prodotto. Il lotto potrebbe non includere tutte le recensioni.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Per product_detail, reviews o questions, usa un ID numerico dell'articolo, l'URL di un prodotto Taobao/Tmall o un messaggio di condivisione che contenga esattamente un URL di prodotto. I link e.tb.cn e m.tb.cn funzionano solo se possono essere risolti in modo sicuro in una pagina prodotto. I token composti solo da TaoPassword, i link scaduti e le pagine che non sono di prodotto vengono rifiutati.Taobao: la terminologia di ID prodotto e SKU — Taobao definisce l'ID prodotto come le cifre che seguono id= in un link al prodotto, mentre uno SKU descrive una specifica combinazione di attributi, come colore e taglia. ID prodotto e SKU non vanno usati in modo intercambiabile. · Verificato
pageFacoltativo- Numero di pagina delle recensioni dell'articolo, da 1 a 50, dalla più recente, di solito 20 recensioni per pagina e meno nell'ultima. Con
pageottieni direttamente l'intera pagina elimitnon ha effetto; senza, la paginazione parte da pagina 1 come prima e prosegue connext_page_token. Ogni pagina viene addebitata come una chiamata; una pagina oltre l'ultima restituisce un risultato vuoto e non viene addebitata. Taobao mostra al massimo le prime 1.000 recensioni di un articolo (pagina 50), quindi le pagine oltre la 50 vengono rifiutate prima dell'addebito.pagination.has_morea true indica che c'è una pagina successiva: chiedipage+ 1, oppure ripassanext_page_tokencomepage_token. Se invii siapagesiapage_token, prevalepage_token. Se arrivano nuove recensioni mentre scorri le pagine, pagine adiacenti possono ripetere una o due recensioni, quindi elimina i duplicati in base all'iddella recensione quando unisci i risultati. page_tokenFacoltativo- Token di pagina. Omettilo per la prima pagina. Quando la risposta contiene un
next_page_token, ripassalo comepage_token, esattamente come ricevuto, per ottenere la pagina successiva, lasciando invariati gli altri parametri (limitpuò cambiare). Puoi anche fare a meno del token e chiedere un numero di pagina conpage; se li invii entrambi, prevalepage_token. Un token è valido per 24 ore e funziona solo per lo stesso prodotto e lo stesso account; un token usato con un altro prodotto viene rifiutato con 422 e non viene addebitato. L'assenza dinext_page_token(opagination.has_morea false) indica che sei arrivato alla fine. Ogni pagina restituiscelimitrecensioni (predefinito 20, fino a 100) e la pagina successiva riprende dopo l'ultima recensione restituita. Le recensioni sono ordinate dalla più recente; se arrivano nuove recensioni mentre scorri le pagine, pagine adiacenti possono ripetere una o due recensioni, quindi elimina i duplicati in base all'iddella recensione quando unisci i risultati. Ogni pagina viene addebitata a sé in base al numero di righe, una chiamata ogni 20 righe (20 righe sono una chiamata, 21–40 sono due, 100 sono cinque); le chiamate non usate perché sono arrivate meno righe vengono rimborsate e una pagina vuota non viene addebitata.
Cosa significano i parametri questions di API di Taobao?
Estrai le domande e risposte degli acquirenti sulla pagina di un prodotto Taobao, con numero di risposte e data di pubblicazione di ogni domanda. answer_count può differire dalle risposte restituite, e non è garantito che le risposte provengano dal venditore.
urlObbligatorio- Per product_detail, reviews o questions, usa un ID numerico dell'articolo, l'URL di un prodotto Taobao/Tmall o un messaggio di condivisione che contenga esattamente un URL di prodotto. I link e.tb.cn e m.tb.cn funzionano solo se possono essere risolti in modo sicuro in una pagina prodotto. I token composti solo da TaoPassword, i link scaduti e le pagine che non sono di prodotto vengono rifiutati.Taobao: la terminologia di ID prodotto e SKU — Taobao definisce l'ID prodotto come le cifre che seguono id= in un link al prodotto, mentre uno SKU descrive una specifica combinazione di attributi, come colore e taglia. ID prodotto e SKU non vanno usati in modo intercambiabile. · Verificato
Come usare l'API di Taobao
- 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":"taobao","action":"search","params":{"keyword":"<keyword>"}}'
Guide su API di Taobao
Esempi pratici e metodi basati su queste azioni. Verifica prima azioni, parametri e campi attuali in questa pagina: esempi e limiti di un articolo non sostituiscono il catalogo aggiornato.
Monetizzare lo scraping dei prezzi: come costruire un prodotto di monitoraggio dei prezzi con un abbonamento che i merchant vorranno rinnovare
Perché i merchant pagano per il monitoraggio dei prezzi e perché disdicono l'abbonamento. Analizziamo modalità di consegna dei dati sui prezzi, unità di fatturazione e accettazione dei piloti attraverso abbinamento dei prodotti, elenchi di eccezioni e flussi di approvazione dei prezzi.
Leggi l'articoloPrimi passi con l'API unificata per i dati: dal catalogo delle funzionalità al primo risultato utilizzabile
Accedi ai dati di più piattaforme con platform, action e params: leggi il catalogo delle funzionalità, completa richieste minime, gestisci task asincroni, risultati parziali e addebiti, e crea record di dati tracciabili.
Leggi l'articoloErrori delle API, restituzione dei crediti e riconciliazione: come verificare l'addebito netto di una richiesta
Separa task, tentativi di chiamata, stati di consegna ed eventi del portafoglio per gestire rifiuti prima dell'addebito, risultati vuoti e restituzioni parziali di crediti senza doppi conteggi, con esempi offline basati su interi.
Leggi l'articoloDomande sull'API di Taobao
Cosa posso ottenere con l'API di Taobao?
Imposta platform su taobao. Il catalogo attuale elenca ricerca, dettagli del prodotto, negozio, recensioni e domande. Questi nomi di azione identificano oggetti o viste diversi di Taobao; non sono modalità di ricerca intercambiabili.
Taobao ha un'API ufficiale?
Taobao Open Platform è rivolta a fornitori di software, partner di servizi e brand che sviluppano strumenti per i commercianti di Taobao e Tmall. I dati del negozio, come prodotti e ordini, si leggono con un access token che il venditore concede autorizzando l'app, mentre le app rivolte agli acquirenti hanno invece accesso alle API per i prodotti del programma di affiliazione di Taobao (Taobaoke).
Fonti ufficiali: Taobao Open Platform: introduzione · Taobao Open Platform: guida all'integrazione · Verificato
Mi serve un account sviluppatore o una chiave API di Taobao?
No. Le richieste passano da EveryInfra con una chiave API EveryInfra: registrati, crea una chiave nella console e inviala come Authorization: Bearer <API_KEY>. Non devi registrare un'app nel portale per sviluppatori di Taobao, richiedere l'accesso alle API di Taobao né accedere con un account Taobao; le azioni restituiscono solo dati pubblici di Taobao.
Quanto costa l'API di Taobao per 1.000 richieste?
Da $1.39 per 1.000 richieste, a seconda dell'azione; il prezzo di ogni azione è indicato nella tabella di questa pagina e nel catalogo pubblico. Non c'è alcun abbonamento: ricarichi un saldo in USD e paghi per chiamata, e le chiamate non riuscite e i risultati vuoti non vengono addebitati.
Quale input avvia la richiesta search di Taobao?
Specifica il termine di ricerca dei prodotti su Taobao o Tmall per l'azione search. Non esegue una ricerca esatta per nome del negozio. Invialo come keyword all'interno di params.
Quali campi può restituire search di Taobao?
Il suo schema dichiarato include title, price, currency e price_basis. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Taobao 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.