API JD.com Tutti gli SKU con prezzi

POST

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
Buono

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

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìjdIdentificativo della piattaforma, valore fisso.
actionbodystringSìskusIdentificativo della funzionalità, valore fisso.
item_idbody.paramsstringSì-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.
limitbody.paramsinteger (1–100)No100Numero 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

#
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": "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

#
Acquisita il October 24, 2026 at 18:28 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "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.

CampoSignificato
item_idID numerico del prodotto su JD. Dai risultati di ricerca puoi passarlo direttamente alle chiamate per i dettagli, le recensioni o il prezzo.
urlLink al record sulla piattaforma.
product_idID 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_requestedIndica se questa riga è lo SKU indicato nella richiesta (skus); gli altri SKU del prodotto sono false.
titleTitolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo).
propertiesAttributi 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).
colorColore (o finitura) di questo SKU come mostrato sulla pagina di JD.
sizeTaglia, capacità o specifica di questo SKU come mostrata sulla pagina di JD.
pricePrezzo come numero senza simbolo di valuta; vedi currency.
currencyCodice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta.
on_saleIndica se questo SKU è messo in vendita (skus). In vendita non significa disponibile in magazzino: per questo leggi in_stock e stock_state.
in_stockIndica se questo SKU può essere ordinato con consegna immediata (skus). Gli SKU in preordine e su prenotazione sono false; vedi stock_state.
stock_stateCodice pubblico dello stato delle scorte di JD.
stockQuantità in magazzino mostrata pubblicamente da JD; null significa che la pagina non la indicava, non zero.
purchase_limitQuantità massima per acquirente; null significa che la pagina non indica alcun limite (skus).
delivery_promisePromessa 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_presaleIndica se il prodotto è in prevendita (skus).
is_government_subsidyIndica 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_subsidyIndica 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_saleIndica se questo SKU è in flash sale (skus); null significa che il contrassegno non è stato ottenuto questa volta.
promo_tagsEtichette promozionali che JD mostra per questo SKU, nella formulazione di JD (skus); null se non ce ne sono o se non sono state ottenute.
upcCodice a barre del prodotto (UPC/EAN). null se la pagina non lo indica.
brandMarca del prodotto.
image_urlURL 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_idID numerico del negozio su JD.
shop_nameNome pubblico del negozio.
is_jd_selfIndica se si tratta di un prodotto a gestione diretta di JD (retail di JD.com).
variant_countNumero 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.
platformIdentificativo 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.

Errori

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

Le nostre statistiche di visita interne sono sempre attive. Google Analytics viene caricato solo se scegli «Consenti analisi». Informativa sulla privacy