API JD.com Tutti gli SKU con prezzi
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 100%
- Tempo medio nelle ultime 24 ore
- 19.01 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Elenca tutti gli SKU di un prodotto JD.com partendo da uno qualsiasi dei suoi SKU in item_id. Ottieni una riga per colore, taglia o capacità, con prezzo, disponibilità e limite di acquisto. La prima riga è lo SKU che hai inviato. price è il prezzo che vede un acquirente non connesso prima dei coupon al checkout.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su jd e action impostato su skus. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Ogni riga richiesta conta come una chiamata: limit determina l'addebito in anticipo e gli addebiti per le righe non restituite vengono rimborsati. Solo sincrona: tutti i dati restituiti (ogni target di un batch o ogni SKU di un prodotto) vengono recuperati nell'ambito di questa chiamata; "mode": "async" restituisce un errore 422 prima di qualsiasi addebito.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint JD.com Tutti gli SKU con prezzi di EveryInfra (jd/skus).
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 jd e action su skus, e inserisci i parametri in params.
- Parametri obbligatori:
- item_id: Identifica un prodotto JD.com per skus tramite uno qualsiasi dei suoi SKU. Passa la stringa di cifre, un link a un prodotto JD (https://item.jd.com/<digits>.html, https://item.m.jd.com/product/<digits>.html o una pagina…
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 100)
- Restituisce un elenco di record. Campi principali di ogni record: item_id (ID numerico del prodotto su JD), url, product_id (ID del gruppo di prodotto JD condiviso…), is_requested (Indica se questa riga è lo SKU indicato…), title, properties (Attributi di vendita di questo SKU come…), color (Colore (o finitura) di questo SKU come…), size (Taglia, capacità o specifica di questo…), price, currency, on_sale (Indica se questo SKU è messo in vendita…), in_stock (Indica se questo SKU può essere ordinat…); 28 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- Esempio di corpo della richiesta:
{
"platform": "jd",
"action": "skus",
"params": {
"item_id": "https://item.m.jd.com/product/10232789210191.html"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Questo endpoint funziona solo in modo sincrono; non aggiungere "mode": "async" al corpo.
- 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ì | jd | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | skus | Identificativo della funzionalità, valore fisso. |
item_id | body.params | string | Sì | - | Identifica un prodotto JD.com per skus tramite uno qualsiasi dei suoi SKU. Passa la stringa di cifre, un link a un prodotto JD (https://item.jd.com/<digits>.html, https://item.m.jd.com/product/<digits>.html o una pagina wqitem.jd.com aperta in WeChat) oppure un testo condiviso che contenga esattamente uno di questi link; i parametri di tracciamento nel link non contano. I link brevi come 3.cn o u.jd.com non sono accettati: aprili prima in un browser e copia il link della pagina del prodotto. |
limit | body.params | integer (1–100) | No | 100 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "jd",
"action": "skus",
"params": {
"item_id": "https://item.m.jd.com/product/10232789210191.html"
}
}'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
#{ "id": "req_…", "platform": "jd", "action": "skus", "results": [ { "item_id": "10232789210191", "url": "https://item.jd.com/10232789210191.html", "product_id": "10035827040758", "is_requested": true, "title": "HUAWEI Pura X View 华为阔直屏手机 沉浸阔直板 超轻薄长续航 亚麻灰 12GB+512GB", "properties": { "外观": "亚麻灰", "存储容量": "12GB+512GB" }, "color": "亚麻灰", "size": "12GB+512GB", "price": 6999, "currency": "CNY", "on_sale": true, "in_stock": false, "stock_state": "pre_order", "stock": 6, "purchase_limit": 2, "delivery_promise": "预计11月23日前发货", "is_presale": false, "is_government_subsidy": false, "upc": "•••", "brand": "华为", "image_url": "https://img14.360buyimg.com/n0/jfs/t1/536837/15/12542/70661/6ad028daF0fe35216/00835a05a00b835a.jpg", "shop_id": "16374386", "shop_name": "华为官方旗舰店", "is_jd_self": false, "variant_count": 12, "platform": "jd" }, { "item_id": "10232789210185", "url": "https://item.jd.com/10232789210185.html", "product_id": "10035827040758", "is_requested": false, "title": "HUAWEI Pura X View 华为阔直屏手机 沉浸阔直板 超轻薄长续航 零度白 12GB+512GB", "properties": { "外观": "零度白", "存储容量": "12GB+512GB" }, "color": "零度白", "size": "12GB+512GB", "price": 6999, "currency": "CNY", "on_sale": true, "in_stock": false, "stock_state": "pre_order", "stock": 6, "purchase_limit": 2, "delivery_promise": "预计11月23日前发货", "is_presale": false, "is_government_subsidy": false, "upc": "•••", "brand": "华为", "image_url": "https://img14.360buyimg.com/n0/jfs/t1/547139/32/2822/66014/6ad028e0F5afed3f9/00835a05a054f860.jpg", "shop_id": "16374386", "shop_name": "华为官方旗舰店", "is_jd_self": false, "variant_count": 12, "platform": "jd" } ], "count": 12, "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 |
|---|---|
item_id | ID numerico del prodotto su JD. Dai risultati di ricerca puoi passarlo direttamente alle chiamate per i dettagli, le recensioni o il prezzo. |
url | Link al record sulla piattaforma. |
product_id | ID del gruppo di prodotto JD condiviso da tutti gli SKU del prodotto (skus). Non è uno SKU: non passarlo come item_id alle chiamate di dettaglio, recensioni o prezzo. |
is_requested | Indica se questa riga è lo SKU indicato nella richiesta (skus); gli altri SKU del prodotto sono false. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
properties | Attributi di vendita di questo SKU come nome attributo → valore, nella formulazione di JD, di solito in cinese (ad esempio il colore e la capacità di archiviazione di quello SKU) (skus). |
color | Colore (o finitura) di questo SKU come mostrato sulla pagina di JD. |
size | Taglia, capacità o specifica di questo SKU come mostrata sulla pagina di JD. |
price | Prezzo come numero senza simbolo di valuta; vedi currency. |
currency | Codice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta. |
on_sale | Indica se questo SKU è messo in vendita (skus). In vendita non significa disponibile in magazzino: per questo leggi in_stock e stock_state. |
in_stock | Indica se questo SKU può essere ordinato con consegna immediata (skus). Gli SKU in preordine e su prenotazione sono false; vedi stock_state. |
stock_state | Codice pubblico dello stato delle scorte di JD. |
stock | Quantità in magazzino mostrata pubblicamente da JD; null significa che la pagina non la indicava, non zero. |
purchase_limit | Quantità massima per acquirente; null significa che la pagina non indica alcun limite (skus). |
delivery_promise | Promessa di consegna o spedizione come la formula JD, ad esempio una data di spedizione prevista (skus); è riferita alla regione predefinita di JD, perché la pagina viene letta senza accesso, e può variare in base alla regione. |
is_presale | Indica se il prodotto è in prevendita (skus). |
is_government_subsidy | Indica se JD contrassegna questo SKU come idoneo a un sussidio del governo nazionale (skus); il contrassegno da solo non indica se il sussidio è già stato detratto da price. null significa che il contrassegno non è stato ottenuto questa volta. |
is_billion_subsidy | Indica se JD contrassegna questo SKU come parte del suo programma Billion Subsidy (skus); null significa che il contrassegno non è stato ottenuto questa volta. |
is_flash_sale | Indica se questo SKU è in flash sale (skus); null significa che il contrassegno non è stato ottenuto questa volta. |
promo_tags | Etichette promozionali che JD mostra per questo SKU, nella formulazione di JD (skus); null se non ce ne sono o se non sono state ottenute. |
upc | Codice a barre del prodotto (UPC/EAN). null se la pagina non lo indica. |
brand | Marca del prodotto. |
image_url | URL dell'immagine: in search, product_detail, shop e skus è l'immagine principale (copertina) del prodotto; in description_images è l'immagine descrittiva di quella riga (l'immagine HTTPS a dimensione piena sul server di hosting delle immagini di JD). |
shop_id | ID numerico del negozio su JD. |
shop_name | Nome pubblico del negozio. |
is_jd_self | Indica se si tratta di un prodotto a gestione diretta di JD (retail di JD.com). |
variant_count | Numero di varianti (SKU). null se non ce ne sono o se non viene indicato. Ogni riga skus riporta lo stesso valore: se è superiore al numero di righe restituite, limit ha troncato l'elenco oppure alcuni SKU non sono stati recuperati questa volta. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
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.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- JD.com: etichette di prezzo visualizzate e prezzi d'acquisto condizionati ↗
JD.com distingue un'etichetta visualizzata in tempo reale dai prezzi finali degli articoli e dalle agevolazioni per membri, nuovi utenti, regioni o destinatari specifici, e avverte che alcune informazioni di confronto possono essere in ritardo o incomplete. Considera il prezzo restituito come l'istantanea visibile al momento della richiesta, non come un prezzo di transazione personale, un importo di regolamento o una garanzia di precisione assoluta.
Verificato il 2026-09-11