API di JD.com
Cerca articoli su JD.com per parola chiave e ottieni dettagli dei prodotti, recensioni pubbliche, prezzi e cataloghi dei negozi.
Ottieni un singolo articolo con il suo ID numerico. Ottieni tutti gli SKU di un prodotto con skus e le immagini della descrizione con description_images. L'identificativo di un articolo e quello di un negozio non sono intercambiabili. Prezzi e disponibilità sono rilevati al momento della richiesta e non corrispondono alle condizioni personali di checkout o di pagamento.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su jd e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 7 funzionalità
- Da $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
- Operatività nelle ultime 24 ore 97%
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- 97%
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di JD.com: 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 | Operatività nelle ultime 24 ore |
|---|---|---|---|
Ricercasearch | Cerca prodotti JD.com per una frase di ricerca e ottieni fino a cinque risultati. | $2.47 per 1.000 richieste | Buono · operatività 100% |
Dettagli del prodottoproduct_detail | Ottieni il record completo di un prodotto JD.com per un item_id. | $1.39 per 1.000 richieste | Buono · operatività 100% |
Recensionireviews | Leggi fino a 10 recensioni degli acquirenti di un prodotto JD.com per chiamata e scorri le pagine per ottenerne altre. | $1.39 per 1.000 richieste | Limitato · operatività 47% |
Negozioshop | Sfoglia fino a 24 prodotti di un negozio JD.com, ognuno con ID articolo, titolo, prezzo, valuta e disponibilità. | $28.81 per 1.000 richieste | Normale |
Prezzo del prodottoproduct_price | Controlla il prezzo mostrato e la disponibilità attuali di un prodotto JD.com tramite item_id. | $1.39 per 1.000 richieste | Normale |
Tutti gli SKU con prezziskus | Elenca tutti gli SKU di un prodotto JD.com partendo da uno qualsiasi dei suoi SKU in item_id. | $1.39 per 1.000 richiesteOgni riga vale una chiamata | Buono · operatività 100% |
Immagini della descrizionedescription_images | Ottieni tutte le immagini della sezione descrizione di un prodotto JD.com, dall'alto in basso. | $1.39 per 1.000 richieste | Buono · operatività 100% |
Cosa accetta ogni azione di API di JD.com?
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 prodotti JD.com per una frase di ricerca e ottieni fino a cinque risultati. Ogni risultato include prezzo, dati su vendite e recensioni come mostrati, quota di valutazioni positive, negozio e tag promozionali. Passa l' | keyword | — | Valori del catalogo: defaultLimit=5, maxLimit=5. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $2.47 per 1.000 richieste | item_id · url · title · short_title · price · currency · sold_count · review_count · good_rate · shop_id · shop_name · shop_url · is_jd_self · promotion · sell_point · category_ids · image_url · platform |
product_detailDettagli del prodotto Ottieni il record completo di un prodotto JD.com per un | item_id | — | — | $1.39 per 1.000 richieste | item_id · url · title · price · price_display · price_masked · currency · available · unavailable_reason · shop_id · shop_name · shop_url · category_id · category · stock · stock_state · color · size · weight · image_url · image_urls · is_jd_self · brand · model · original_price · upc · warranty · product_area · is_jd_express · variant_count · variants · platform |
reviewsRecensioni Leggi fino a 10 recensioni degli acquirenti di un prodotto JD.com per chiamata e scorri le pagine per ottenerne altre. Ottieni valutazione, recensione aggiuntiva, variante acquistata, voti di utilità, foto, stato PLUS del recensore e numero di acquisti. I nickname compaiono come li mostra JD, eventualmente in parte oscurati. Il lotto non è uno storico completo e non è autorizzato per la ripubblicazione. | item_id | page_token | Valori del catalogo: defaultLimit=10, maxLimit=10. 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 è una chiamata. | $1.39 per 1.000 richieste | id · item_id · text · review_append · rating · rating_scale · posted_at · color · size · useful_count · images · author_name · author_avatar_url · author_is_plus · buy_count · platform · next_page_token |
shopNegozio Sfoglia fino a 24 prodotti di un negozio JD.com, ognuno con ID articolo, titolo, prezzo, valuta e disponibilità. Passa lo | shop_id | — | Valori del catalogo: defaultLimit=24, maxLimit=24. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $28.81 per 1.000 richieste | item_id · url · title · price · currency · shop_id · shop_name · shop_url · image_url · available · platform |
product_pricePrezzo del prodotto Controlla il prezzo mostrato e la disponibilità attuali di un prodotto JD.com tramite | item_id | — | — | $1.39 per 1.000 richieste | item_id · url · price · currency · available · unavailable_reason · platform |
skusTutti gli SKU con prezzi Elenca tutti gli SKU di un prodotto JD.com partendo da uno qualsiasi dei suoi SKU in | item_id | — | Valori del catalogo: defaultLimit=100, 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 richiesteOgni riga vale una chiamata | item_id · url · product_id · is_requested · title · properties · color · size · price · currency · on_sale · in_stock · stock_state · stock · purchase_limit · delivery_promise · is_presale · is_government_subsidy · is_billion_subsidy · is_flash_sale · promo_tags · upc · brand · image_url · shop_id · shop_name · is_jd_self · variant_count · platform |
description_imagesImmagini della descrizione Ottieni tutte le immagini della sezione descrizione di un prodotto JD.com, dall'alto in basso. Ogni link a grandezza intera è numerato con | item_id | — | — | $1.39 per 1.000 richieste | item_id · position · image_url · image_count · platform |
Cosa significano i parametri search di API di JD.com?
Cerca prodotti JD.com per una frase di ricerca e ottieni fino a cinque risultati. Ogni risultato include prezzo, dati su vendite e recensioni come mostrati, quota di valutazioni positive, negozio e tag promozionali. Passa l'item_id restituito alle azioni di dettaglio, recensioni o prezzo. Ordine e copertura riguardano una singola risposta, non l'intero catalogo.
keywordObbligatorio- Specifica la query di ricerca per
searchdi JD.com. Deve essere una frase di ricerca, non un ID articolo o un selettore di negozio, e i risultati corrispondenti non implicano una copertura completa del catalogo.JD.com JOS e JD Union: oggetti prodotto e SKU — I materiali autorizzati della piattaforma aperta e del programma di affiliazione di JD.com descrivono oggetti prodotto e SKU come nomi, immagini principali, categorie, prezzi visualizzati, logistica, stato di vendita diretta da JD e indicatori del volume degli ordini. Questa terminologia non dimostra che ogni pagina web o campo sia disponibile, che il chiamante abbia accesso o che EveryInfra implementi l'interfaccia ufficiale. · Verificato
Cosa significano i parametri product_detail di API di JD.com?
Ottieni il record completo di un prodotto JD.com per un item_id. Include marca, modello, prezzo e prezzo originale, disponibilità, varianti, codice a barre, garanzia e stato JD Logistics. Quando price_masked è true, il prezzo mostrato non è esatto. Un valore null per lo stock significa che il dato non è mostrato, non che sia pari a zero.
item_idObbligatorio- Identifica un prodotto JD.com per
product_detail,reviewsoproduct_price. Passa la stringa di cifre restituita dasearcho l'URL canonico legacyhttps://item.jd.com/<digits>.htmlsenza query né frammento; URL arbitrari, opachi o di altri host non sono accettati come identificatori equivalenti.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
Cosa significano i parametri reviews di API di JD.com?
Leggi fino a 10 recensioni degli acquirenti di un prodotto JD.com per chiamata e scorri le pagine per ottenerne altre. Ottieni valutazione, recensione aggiuntiva, variante acquistata, voti di utilità, foto, stato PLUS del recensore e numero di acquisti. I nickname compaiono come li mostra JD, eventualmente in parte oscurati. Il lotto non è uno storico completo e non è autorizzato per la ripubblicazione.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statoitem_idObbligatorio- Identifica un prodotto JD.com per
product_detail,reviewsoproduct_price. Passa la stringa di cifre restituita dasearcho l'URL canonico legacyhttps://item.jd.com/<digits>.htmlsenza query né frammento; URL arbitrari, opachi o di altri host non sono accettati come identificatori equivalenti.JD.com: regole per pubblicare recensioni e foto — JD.com distingue recensioni, recensioni aggiuntive, immagini, risposte, moderazione, contenuti collassati e nickname mascherati. La visibilità pubblica può dipendere dalle regole sulle recensioni e sulla privacy, quindi un insieme di risultati non va presentato come cronologia completa delle recensioni né come autorizzazione a ridistribuire i contenuti degli autori delle recensioni. · VerificatoAccordo di servizio per gli utenti di JD.com (in vigore dal 20 gennaio 2026): recensioni pubbliche e limiti di accesso — L'Accordo di servizio per gli utenti di JD.com stabilisce che le informazioni delle recensioni sono pubbliche e che JD.com può usarle secondo l'accordo. Stabilisce inoltre che, in generale, le informazioni personali non vengono comunicate a terzi senza autorizzazione, e vieta di sottrarre informazioni personali o di violare diritti legittimi. Questo riguarda solo i limiti di accesso e di autorizzazione; non concede a EveryInfra né ai chiamanti il diritto di ridistribuire, usare per l'addestramento o riutilizzare a fini commerciali testi, immagini o informazioni degli utenti. · Verificato 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). 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 contiene al massimo 10 recensioni ed è una chiamata; una pagina vuota non viene addebitata. Conlimitinferiore a 10, la pagina successiva restituisce prima ciò che era rimasto dalla pagina precedente, quindi una pagina può contenere meno dilimitrecensioni. Questo non significa che sei alla fine: lo indica solo l'assenza dinext_page_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. Le recensioni JD non consentono di saltare a un numero di pagina; avanza una pagina alla volta connext_page_token.
Cosa significano i parametri shop di API di JD.com?
Sfoglia fino a 24 prodotti di un negozio JD.com, ognuno con ID articolo, titolo, prezzo, valuta e disponibilità. Passa lo shop_id numerico del negozio o il suo link mall.jd.com. I risultati non rappresentano l'intero inventario del negozio.
shop_idObbligatorio- Identifica il negozio usato dall'azione
shop. Passa una stringa di cifre o l'URL canonico legacyhttps://mall.jd.com/index-<digits>.htmlsenza query né frammento; gli URL di altri host vengono rifiutati e questo selettore non accetta l'item_iddi un prodotto.JD.com JSSDK: destinazioni separate per SKU e negozio — La documentazione di JD.com sui reindirizzamenti usa `skuId` per una destinazione di dettaglio prodotto e `shopId` per una destinazione di dettaglio negozio. Questo conferma che identificatori di prodotto e di negozio vanno tenuti separati; non stabilisce diritti di raccolta delle pagine web, il parsing degli URL supportati, cataloghi completi dei negozi o il comportamento delle richieste di EveryInfra. · Verificato
Cosa significano i parametri product_price di API di JD.com?
Controlla il prezzo mostrato e la disponibilità attuali di un prodotto JD.com tramite item_id. Se il prodotto non è acquistabile, ricevi il motivo indicato. È una rilevazione in un momento preciso, non un prezzo personale al checkout, uno sconto per i membri o un importo definitivo.
item_idObbligatorio- Identifica un prodotto JD.com per
product_detail,reviewsoproduct_price. Passa la stringa di cifre restituita dasearcho l'URL canonico legacyhttps://item.jd.com/<digits>.htmlsenza query né frammento; URL arbitrari, opachi o di altri host non sono accettati come identificatori equivalenti.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
Cosa significano i parametri skus di API di JD.com?
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.
item_idObbligatorio- Identifica un prodotto JD.com per
skustramite 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>.htmlo una paginawqitem.jd.comaperta in WeChat) oppure un testo condiviso che contenga esattamente uno di questi link; i parametri di tracciamento nel link non contano. I link brevi come3.cnou.jd.comnon sono accettati: aprili prima in un browser e copia il link della pagina del prodotto.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
Cosa significano i parametri description_images di API di JD.com?
Ottieni tutte le immagini della sezione descrizione di un prodotto JD.com, dall'alto in basso. Ogni link a grandezza intera è numerato con position, e image_count contiene il totale. Passa in item_id uno SKU qualsiasi del prodotto o un link al prodotto. La galleria resta in product_detail. Un prodotto senza immagini nella descrizione restituisce un risultato vuoto che non viene addebitato.
item_idObbligatorio- Identifica il prodotto JD.com di cui vuoi le immagini descrittive 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>.htmlo una paginawqitem.jd.comaperta in WeChat) oppure un testo condiviso che contenga esattamente uno di questi link; i parametri di tracciamento nel link non contano. I link brevi come3.cnou.jd.comnon sono accettati: aprili prima in un browser e copia il link della pagina del prodotto.
Come usare l'API di JD.com
- 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":"jd","action":"search","params":{"keyword":"<keyword>"}}'
Guide su API di JD.com
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.
Primi 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'articoloMonetizzare 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'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 JD.com
Cosa posso ottenere con l'API di JD.com?
Imposta platform su jd. Il catalogo attuale elenca ricerca, dettagli del prodotto, recensioni, negozio, prezzo del prodotto e more. Questi nomi di azione identificano oggetti o viste diversi di JD.com; non sono modalità di ricerca intercambiabili.
JD.com ha un'API ufficiale?
L'open platform di JD (JOS) offre a sviluppatori e partner registrati funzionalità di logistica, marketing, cloud e login autorizzato tramite app che creano e pubblicano nel suo developer center. La promozione dei prodotti per gli affiliati passa invece dal programma separato JD Union.
Fonti ufficiali: Developer center della JD Open Platform (JOS) · JD Union · Verificato
Mi serve un account sviluppatore o una chiave API di JD.com?
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 JD.com, richiedere l'accesso alle API di JD.com né accedere con un account JD.com; le azioni restituiscono solo dati pubblici di JD.com.
Quanto costa l'API di JD.com 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 JD.com?
Specifica la query di ricerca per search di JD.com. Deve essere una frase di ricerca, non un ID articolo o un selettore di negozio, e i risultati corrispondenti non implicano una copertura completa del catalogo. Invialo come keyword all'interno di params.
Quali campi può restituire search di JD.com?
Il suo schema dichiarato include item_id, title, short_title e price. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di JD.com rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. skus runs solo in modo sincrono: legge tutto ciò che restituisce (tutti i target di un batch, o tutti gli SKU di un prodotto) nella stessa chiamata, e una richiesta con "mode": "async" riceve un 422 prima di qualsiasi addebito. 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.