API Taobao Dettagli del prodotto

Q: Come leggo i prezzi dei prodotti con più varianti?

skus elenca tutte le varianti, e ognuna può avere un proprio prezzo, prezzo originale, prezzo con coupon e scorte, mentre price è il valore a livello di prodotto. Registra i prezzi per variante quando li confronti o li monitori; spec_values aggiunge tutti i valori delle varianti, comprese le combinazioni non in vendita.

Q: I prezzi sono in yuan? C'è un valore in dollari USA?

price, original_price e coupon_price sono numeri senza simbolo di valuta, quindi leggi la valuta da currency invece di darla per scontata. price_usd è un prezzo di riferimento in dollari USA, convertito così come appare nei dati restituiti; usalo per confronti approssimativi, non come l'importo che pagherai. I prezzi in yuan nei dettagli del prodotto sono per lo più convertiti da dollari USA, quindi possono risultare circa dell'1–4% più alti o più bassi rispetto al prezzo sulla pagina di Taobao; fa fede il prezzo della pagina.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: 93%
Tempo medio nelle ultime 24 ore: 17.66 s

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

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.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su taobao e action impostato su product_detail. Prezzo $4.5 per 1.000 richieste ($0.0045 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Taobao Product details legge il record pubblico completo di un prodotto Taobao o Tmall: titolo, marca, prezzo e prezzo originale, prezzo con coupon, scorte e unità vendute, ogni SKU con il proprio prezzo e le proprie scorte, attributi del prodotto, immagine principale e immagini della descrizione estesa, oltre al negozio e alle spese di spedizione. Usala per analizzare nel dettaglio la scheda prodotto di un concorrente, monitorare prezzi e promozioni, confrontare offerte o completare un catalogo prodotti.

url accetta un ID numerico del prodotto, un link al prodotto o un testo di condivisione che contenga esattamente un link a un prodotto; i semplici codici di condivisione di Taobao e i link scaduti vengono rifiutati. Quando leggi i prezzi, tieni presente che coupon_price compare solo quando si applica un coupon e che ogni voce di skus può avere un proprio prezzo. is_tmall distingue i negozi Tmall dai normali negozi Taobao, che hanno requisiti e garanzie diversi.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Taobao Dettagli del prodotto di EveryInfra (taobao/product_detail).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su taobao e action su product_detail, e inserisci i parametri in params.
- Parametri obbligatori:
  - url: 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.
- Restituisce un oggetto. Campi principali: id, url, title, brand (Marca), price (Prezzo come numero senza simbolo di val…), original_price (Prezzo originale (barrato)), currency, price_basis (Come è stato ottenuto price (presente s…), stock (Quantità in magazzino), sold_count (Unità vendute), category_id (ID della categoria), location (Luogo di spedizione); 78 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- Esempio di corpo della richiesta:
{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}
- Prezzo: $4.5 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`platform`	body	`string`	Sì	`taobao`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`product_detail`	Identificativo della funzionalità, valore fisso.
`url`	body.params	`string`	Sì	-	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.

Esempi di codice

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

json

{  "id": "req_…",  "platform": "taobao",  "action": "product_detail",  "results": {    "id": "•••",    "url": "https://item.taobao.com/item.htm?id=744983869996",    "title": "绿联转换插头英标韩国马来西亚澳洲新加坡新西兰Switch转换器充电",    "price": 29.97,    "currency": "CNY",    "stock": 1397,    "category_id": "50003472",    "location": "廣東東莞",    "is_tmall": true,    "shop_name": "绿联数码旗舰店",    "shop_id": "67095450",    "skus": [      {        "id": "•••",        "name": "[for Outings] English to Chinese Converter|Matte Black⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",        "price": 30.17,        "stock": 200,        "image_url": "https://img.alicdn.com/bao/uploaded/i3/713464357/O1CN01QOFAISCEu2L1chua_!!713464357.jpg"      },      {        "id": "•••",        "name": "[for Outings] English to Chinese Converter|Lightweight White⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",        "price": 29.97,        "stock": 200,        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01P9gIa5t80pC1chua_!!713464357.jpg"      },      {        "id": "•••",        "name": "[for Mainland China] Chinese to English Converter|Matte Black⭐Applicable to Hong Kong Version of Ps5/Switch2/Electrical Appliances in Hong Kong and Macau, China",        "price": 30.17,        "stock": 200,        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01WLbh5e1i3YjKWsf7g_!!713464357.jpg"      }    ],    "sku_count": 8,    "main_image_url": "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",    "description_images": [      "https://img.alicdn.com/imgextra/i1/713464357/O1CN01tRpmSz1MdQI1WPZ8_!!713464357.jpg",      "https://img.alicdn.com/imgextra/i1/713464357/O1CN019muBmB1i3YpL3L8sM_!!713464357.jpg",      "https://img.alicdn.com/imgextra/i3/713464357/O1CN011J4LMz1i3Ynq3SQ1z_!!713464357.jpg"    ],    "price_usd": 5.27,    "root_category_id": "50020579",    "category_path": "首页 > 电子/电工 > 接线板/插头 > 转换插头",    "min_order_quantity": 1,    "images": [      "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01f4WmsN1i3YoKlcotr_!!713464357.jpg",      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01KQ3NjW1i3YljOLkIv_!!713464357.jpg"    ],    "category_name": "转换插头",    "description": "港版Switch转换插头 - 英标转中转换器，适用马来西亚插头与多国转换插头，具备65W快充功能。适合港版Switch 1与2使用，提供全球适用的转换解决方案。\n\n多国适用与高效快充功能 - 绿联多国转换插头支援英标、美标、德标与澳标等多种插头类型，适用全球多数国家与地区。内建65W快充技术，确保高功率需求的装置如Switch主机与笔电能快速充电，同时具备安全保护机制，避免过载与短路。\n\n多样款式与便利设计选择 - 转换插头提供多种款式选择，包含单独英转中、中转英与多合一组合。特别针对港版Switch 2使用者设计，提供适用进口电器的转换方案。轻巧便携设…",    "keywords": [      "港版Switch转换插头",      "英标转中转换器",      "适用马来西亚插头"    ],    "shop_score_description": 4.8,    "shop_score_service": 4.8,    "shop_score_delivery": 4.9,    "free_shipping": false,    "has_price_range": true,    "payment_methods": [      "蚂蚁花呗",      "信用卡支付",      "集分宝"    ],    "seller_id": "•••",    "seller_credit_level": 20,    "seller_type": "B",    "seller_type_label": "Business seller",    "selling_points": [      "港版Switch2转换插头:专为港版Switch2设计转换插头，兼容多国电压，出国携带无烦恼。",      "绿联品牌认证转换器:知名电子品牌绿联出品，通过多国安全认证，使用更安心。",      "多国插头规格适用:适用马来西亚、新加坡、英国等多国插座标准，国际旅行首选。"    ],    "shop_logo_url": "https://img.alicdn.com/imgextra//d2/82/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg",    "shop_url": "https://shop.m.taobao.com/shop/shop_index.htm?user_id=713464357",    "shop_item_count": 1330,    "shop_new_item_count": 28,    "shop_opened_at": "2011-05-30 14:37:22",    "seven_day_return": false,    "reviews": [      {        "text": "还不错，通电了装换头会有提示灯 没送收纳袋。 体积挺小巧的。 手感挺细腻的。",        "rating": 5,        "posted_at": "2026.10.17 18:07",        "sku": "颜色:【内地用】中转英转换器|轻骑白⭐港版PS5/Switch2/中国香港澳门地区电器适用",        "author_avatar_url": "https://gw.alicdn.com/•••"      }    ],    "platform": "taobao"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

Campo	Significato
`id`	ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
`url`	Link al record sulla piattaforma.
`title`	Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo).
`brand`	Marca.
`price`	Prezzo come numero senza simbolo di valuta; vedi currency. In product_detail, i prezzi (compreso il price di ogni riga di skus) sono per lo più convertiti da dollari USA e possono essere circa l'1–4% sopra o sotto il prezzo della pagina Taobao; fa fede il prezzo della pagina. In search, il price di ogni riga può essere il prezzo attuale della pagina, il prezzo di listino barrato o un prezzo promozionale. price_basis indica quale tipo hai ottenuto.
`original_price`	Prezzo originale (barrato). In shop è l'unico prezzo: il valore barrato mostrato nella scheda prodotto, non il prezzo di vendita, e può essere molto più alto; per il prezzo di vendita usa product_detail.
`currency`	Codice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta.
`price_basis`	Come è stato ottenuto price (presente solo quando c'è un prezzo). In product_detail: converted (la maggior parte delle chiamate) è un prezzo in CNY convertito da dollari USA e può essere circa l'1–4% sopra o sotto il prezzo della pagina Taobao; page è il prezzo in CNY mostrato sulla pagina Taobao. In search (uno per riga): page è il prezzo attuale mostrato sulla pagina Taobao; list è il prezzo di listino barrato, che è superiore al prezzo di vendita effettivo quando l'articolo è scontato, a volte il doppio; promotion è un prezzo promozionale di affiliazione Taobao ed è spesso molto inferiore al prezzo della pagina. currency è CNY in ogni caso, e le chiamate per lo stesso prodotto possono dare valori diversi.
`stock`	Quantità in magazzino. Per i venditori con più magazzini, le chiamate per lo stesso prodotto possono restituire disponibilità diverse (e un luogo di spedizione diverso).
`sold_count`	Unità vendute.
`category_id`	ID della categoria.
`location`	Luogo di spedizione. Per i venditori con più magazzini, le chiamate per lo stesso prodotto possono mostrare luoghi di spedizione diversi.
`is_tmall`	Indica se il negozio è uno store Tmall anziché un normale negozio Taobao; i due hanno requisiti di ammissione e garanzie per l'acquirente diversi.
`shop_name`	Nome del negozio.
`shop_id`	ID del negozio.
`shipping_fee`	Costo di spedizione.
`ems_fee`	Costo di spedizione EMS.
`express_fee`	Costo della consegna express.
`skus`	Tutte le varianti (SKU) della scheda prodotto. Ogni voce può riportare id, name, price, original_price, coupon_price, stock, props_ids e image_url; price è per lo più convertito da dollari USA (vedi price).
`sku_count`	Numero di SKU.
`spec_values`	Tabella completa dei valori delle varianti, incluse le combinazioni non in vendita; id identifica il valore e text è la sua etichetta.
`props_images`	Immagini per i valori delle varianti: id corrisponde a spec_values e props_ids, e image_url è l'immagine di quella variante.
`attributes`	Attributi del prodotto come righe {name, value}, ad esempio marca, modello e luogo di origine.
`main_image_url`	Immagine principale (la prima).
`description_images`	Immagini lunghe nell'area descrittiva, nell'ordine della pagina.
`description_html`	HTML grezzo dell'area descrittiva, composto per lo più da tag immagine.
`video_url`	Link diretto al video dell'immagine principale. Questo campo di solito è vuoto perché il video è raramente disponibile; un valore vuoto non significa che il prodotto non abbia un video.
`coupon_price`	Prezzo dopo il coupon: inferiore a price quando si applica un coupon, altrimenti assente.
`price_usd`	Prezzo di riferimento in dollari USA, ottenuto mediante la conversione usata nei dati restituiti.
`total_price`	Prezzo totale come restituito; spesso assente.
`suggestive_price`	Prezzo al dettaglio consigliato; spesso assente.
`has_discount`	Indica se si applica uno sconto.
`is_promotion`	Indica se il prodotto è in promozione.
`promo_type`	Tipo di promozione.
`is_virtual`	Indica se il prodotto è virtuale (non un bene fisico).
`brand_id`	ID della marca.
`root_category_id`	ID della categoria radice.
`category_path`	Percorso della categoria (breadcrumb).
`weight`	Peso del prodotto come restituito; spesso 0 o assente.
`size`	Dimensioni del prodotto; spesso assenti.
`favorite_count`	Numero di volte in cui il prodotto è stato aggiunto ai preferiti.
`fans_count`	Numero di follower come restituito; spesso assente.
`min_order_quantity`	Quantità minima d'ordine.
`shipping_to`	Nota sull'area di consegna; spesso assente.
`listed_at`	Data di messa in vendita (ISO 8601); il campo è assente se i dati non la riportano.
`modified_at`	Data dell'ultima modifica (ISO 8601); il campo è assente se i dati non la riportano.
`delist_at`	Data di ritiro dalla vendita (ISO 8601); il campo è assente se i dati non la riportano.
`images`	Link alle immagini: foto del prodotto in product_detail, foto dell'acquirente in reviews (assente se la recensione non ne ha).
`category_name`	Nome della categoria di ultimo livello (product_detail).
`description`	Riepilogo o descrizione, di solito più breve di text.
`keywords`	Parole chiave dalla pagina del prodotto (product_detail).
`titleOriginal`	Mantiene il significato attribuito dalla piattaforma
`has_cn_title`	Mantiene il significato attribuito dalla piattaforma
`shop_score_description`	Valutazione del negozio per la corrispondenza dell'articolo alla descrizione, su una scala a 5 punti.
`shop_score_service`	Valutazione del negozio per il servizio, su una scala a 5 punti.
`shop_score_delivery`	Valutazione del negozio per la spedizione, su una scala a 5 punti.
`free_shipping`	Indica se la spedizione è gratuita.
`promotion_price`	Prezzo promozionale (product_detail; spesso assente).
`discount_price`	Prezzo scontato (product_detail; spesso assente).
`discount_type`	Tipo di sconto o di campagna come riportato (ad esempio flash sale).
`price_note`	Nota sul prezzo come riportata (product_detail).
`has_price_range`	Indica se il prezzo è una fascia perché le varianti hanno prezzi diversi (product_detail).
`payment_methods`	Metodi di pagamento accettati (product_detail).
`seller_id`	ID del venditore (può mancare in shop).
`seller_credit_level`	Livello di credito del venditore (un numero: più alto è il valore, migliore è il livello).
`seller_type`	Codice del tipo di venditore (product_detail).
`seller_type_label`	Nome del tipo di venditore (product_detail), ad esempio Tmall o negozio aziendale.
`selling_points`	Tag dei punti di forza.
`shop_logo_url`	Link al logo del negozio (product_detail, shop; può mancare in shop).
`shop_url`	Link al negozio (product_detail, shop).
`shop_item_count`	Numero di articoli in vendita nel negozio (product_detail, search, shop).
`shop_new_item_count`	Numero di nuovi articoli nel negozio (product_detail).
`shop_opened_at`	Data di apertura del negozio, come riportata (product_detail).
`review_tags`	Tag delle recensioni, ciascuno con tag (l'etichetta) e count (quante volte è stato menzionato; può mancare).
`review_count`	Numero di recensioni, per le funzionalità relative a prodotti e attività. null significa non reso noto, non 0.
`positive_rate`	Tasso di recensioni positive del prodotto (product_detail), in percentuale; spesso assente.
`seven_day_return`	Indica se è previsto il reso senza motivazione entro sette giorni (product_detail).
`reviews`	Mantiene il significato attribuito dalla piattaforma
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

Cosa posso passare come `url`?

Un ID numerico del prodotto, un link a un prodotto Taobao o Tmall o un testo di condivisione che contenga esattamente un link a un prodotto. I link brevi di e.tb.cn e m.tb.cn sono accettati solo se rimandano in modo sicuro a una pagina prodotto. Codici di condivisione semplici, link scaduti e pagine di negozi o di ricerca vengono rifiutati.

Come leggo i prezzi dei prodotti con più varianti?

skus elenca tutte le varianti, e ognuna può avere un proprio prezzo, prezzo originale, prezzo con coupon e scorte, mentre price è il valore a livello di prodotto. Registra i prezzi per variante quando li confronti o li monitori; spec_values aggiunge tutti i valori delle varianti, comprese le combinazioni non in vendita.

I prezzi sono in yuan? C'è un valore in dollari USA?

price, original_price e coupon_price sono numeri senza simbolo di valuta, quindi leggi la valuta da currency invece di darla per scontata. price_usd è un prezzo di riferimento in dollari USA, convertito così come appare nei dati restituiti; usalo per confronti approssimativi, non come l'importo che pagherai. I prezzi in yuan nei dettagli del prodotto sono per lo più convertiti da dollari USA, quindi possono risultare circa dell'1–4% più alti o più bassi rispetto al prezzo sulla pagina di Taobao; fa fede il prezzo della pagina.

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori

Riferimenti ufficiali

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

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 il 2026-09-04