API de Detalles del producto de JD.com
Lee un producto de JD.com por item_id: title, brand, model, price, original_price, available, stock_state, image_urls y variants, por $2.44 por cada 1000 llamadas.
JD.com Detalles del producto lee la ficha de un producto de JD a partir de item_id: título, marca y modelo, precio y precio original, disponibilidad y estado de stock, galería de imágenes, variantes, código de barras, lugar de origen y texto de garantía, además de la tienda, si lo vende JD directamente y si lo entrega JD Logistics. Responde a cuánto cuesta un producto, si se puede comprar y quién lo envía, y lo usan equipos de seguimiento de precios, de análisis de la competencia y de catálogo para preparar fichas técnicas y completar catálogos.
Antes de leer el precio, mira price_masked: JD oculta algunos precios tras el inicio de sesión o condiciones de membresía, y cuando vale true, price_display es el texto de la página y no un precio de venta exacto. available y unavailable_reason indican si el producto está a la venta. original_price y upc valen null cuando la página no los proporciona, y en variants null también puede significar que el producto no tiene variantes.
upc,warrantyyproduct_areadan el código de barras, el texto de garantía y el lugar de origen.is_jd_selfeis_jd_expressmarcan la venta directa de JD y la entrega con JD Logistics.- Las llamadas fallidas y los resultados vacíos no se cobran.
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "jd", "action": "product_detail", "params": { "item_id": "https://item.jd.com/100012043978.html" } }2Respuesta JSON
{ "results": { "upc": "•••;•••", "item_id": "100012043978", "title": "茅台飞天 53%vol 500ml 贵州茅台酒(带杯)【需预约购买】", "price": 1041, … } }3Campos
upc item_id title price •••;••• 100012043978 茅台飞天 53%vol 500ml 贵州茅台酒(带杯)【需预约购买】 1041 4CSV
jd-product_detail-sample.csv 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
item_id y sale un objeto JSON con campos como title, price y available, que se muestran como tabla de campos y se pueden descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para item.jd.com/100012043978.html, obtenida el 24 de octubre de 2026, 18:28 (UTC), que devolvió un objeto; las barras grises marcan el código de barras eliminado (upc; ••• en el CSV). En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 100012043978 | https://item.jd.com/100012043978.html | 茅台飞天 53%vol 500ml 贵州茅台酒(带杯)【需预约购买】 | 1041 | 1??9 | null | CNY | false | null | 1000475228 | 贵州茅台 | https://mall.jd.com/index-1000475228.html | 9435 | null | 156 | out_of_stock | 1759(需预约) | 单瓶装 | 1.1kg | https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg | ["https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg","https://img14.360buyimg.com/n1/jfs/t1/442358/22/5618/62044/6a17b873F63dd4c14/00833203206f6884.jpg","https://img14.360buyimg.com/n1/jfs/t1/538344/32/1045/88182/6aba0a86F8862dac1/00833203209ef461.jpg"] | null | 茅台 | 白酒 | 1041 | •••;••• | 无质保 | 贵州仁怀 | false | 9 | [{"sku_id":"100278756721","image_url":"https://img14.360buyimg.com/n1/jfs/t1/442358/22/5618/62044/6a17b873F63dd4c14/00833203206f6884.jpg"},{"sku_id":"100153291833","image_url":"https://img14.360buyimg.com/n1/jfs/t1/538344/32/1045/88182/6aba0a86F8862dac1/00833203209ef461.jpg"},{"sku_id":"100371797016","image_url":"https://img14.360buyimg.com/n1/jfs/t1/545564/17/1981/187886/6accddbdFb7d949e4/0083320320d24f2b.png"}] | jd |
Casos de uso
Seguimiento de precios
Lee
priceyoriginal_pricecada cierto tiempo; marca aparte las filas conprice_maskeden true y no las uses como precio exacto.Completar un catálogo
Rellena huecos con
brand,model,category_id,upcyproduct_area, y toma todas las imágenes del producto deimage_urls.Encontrar productos no disponibles
Cuando
availableesfalse, leeunavailable_reasonystock_state.Ver quién vende y quién envía
shop_namenombra la tienda,is_jd_selfmarca la venta directa de JD eis_jd_expressindica si entrega JD Logistics.
Centro de ayuda de JD: explicación de etiquetas de precio frente a EveryInfra
Así se comparan la explicación de etiquetas de precio del Centro de ayuda de JD y product_detail de EveryInfra en qué incluye el precio en vivo de la página.
| Aspecto | Centro de ayuda de JD: explicación de etiquetas de precio | EveryInfra |
|---|---|---|
| Precio en vivo de la página | El precio en vivo de la página del producto no incluye los precios ligados a un estatus especial del comprador, como los precios Plus, de estudiante, de empresa, de usuario nuevo, de Sam's, de fan o de miembro de la tienda. | price es una instantánea del precio visible en la página en el momento de la captura. Cuando JD enmascara el precio, price_masked es true y price_display es el texto que muestra la página. |
La documentación del Centro de ayuda de JD está en chino. La tabla muestra una traducción, cotejada con la página el 2026-11-22; la página no indica fecha de actualización. La página explica los precios a los compradores; no es un documento de interfaz para leer productos. Las interfaces de productos de JD Union leen productos promocionados, otro objeto, así que la tabla no las incluye. Fuentes oficiales: Explicación de las etiquetas de precio
Límites y detalles a tener en cuenta
item_ides obligatorio: un ID numérico de producto de JD, o https://item.jd.com/<número>.html sin parámetros de consulta ni fragmento. No se aceptan los enlaces opacos nuevos como /product/<opaque>.html.stockesnullcuando la página no lo indica, y eso no equivale a 0;availableesnullcuando la página no da estado de venta.original_priceesnullcuando la página no lo proporciona y, si tiene valor, puede diferir delpricepromocional.variantsesnullcuando el producto no tiene variantes o no se proporcionaron; para el precio y el stock de cada SKU, usaskus.image_urlses la galería del producto con la imagen principal; las imágenes largas de la zona de descripción no están ahí, y se leen condescription_images.
Precios
Pagas $0.002444 por llamada, y una llamada lee un producto. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $24.44 |
| 100,000 | $244.44 |
| 1,000,000 | $2,444.44 |
Los totales se calculan con el precio de lista por llamada.
Ejemplos de código
#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": "product_detail",
"params": {
"item_id": "https://item.jd.com/100012043978.html"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Referencia de API
Consulta los parámetros, los campos de respuesta, los errores y la facturación de product_detail, y copia la página o ábrela en Markdown para dársela a un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra JD.com: Detalles del producto (jd/product_detail).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en jd y action en product_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
- item_id: Identifica un producto de JD.com para product_detail, reviews o product_price. Envía la cadena de dígitos devuelta por search o la URL antigua canónica https://item.jd.com/<dígitos>.html sin query ni fragment.
- Devuelve un objeto. Campos principales: item_id (ID numérico del producto en JD), url, title, price, price_display (Precio tal como aparece en la página de…), price_masked (Si JD enmascara el precio en la página…), currency, available (Indica si el artículo se podía comprar…), unavailable_reason (Razón pública que muestra JD cuando un…), shop_id (ID numérico de la tienda en JD), shop_name (Nombre público de la tienda), shop_url (Página pública de la tienda en JD); 31 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- Cuerpo de solicitud de ejemplo:
{
"platform": "jd",
"action": "product_detail",
"params": {
"item_id": "https://item.jd.com/100012043978.html"
}
}
- Precio: $2.44 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | jd | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | product_detail | Identificador de la capacidad, valor fijo. |
item_id | body.params | string | Sí | - | Identifica un producto de JD.com para product_detail, reviews o product_price. Envía la cadena de dígitos devuelta por search o la URL antigua canónica https://item.jd.com/<dígitos>.html sin query ni fragment; se rechazan las URL arbitrarias, opacas o de otro host. |
Ejemplo de respuesta
#{ "id": "req_…", "platform": "jd", "action": "product_detail", "results": { "item_id": "100012043978", "url": "https://item.jd.com/100012043978.html", "title": "茅台飞天 53%vol 500ml 贵州茅台酒(带杯)【需预约购买】", "price": 1041, "price_display": "1??9", "currency": "CNY", "available": false, "shop_id": "1000475228", "shop_name": "贵州茅台", "shop_url": "https://mall.jd.com/index-1000475228.html", "category_id": "9435", "stock": 156, "stock_state": "out_of_stock", "color": "1759(需预约)", "size": "单瓶装", "weight": "1.1kg", "image_url": "https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg", "image_urls": [ "https://img14.360buyimg.com/n1/jfs/t1/498128/6/14354/78100/6a8678aeFd76e6a0c/008332032059c4fa.jpg", "https://img14.360buyimg.com/n1/jfs/t1/442358/22/5618/62044/6a17b873F63dd4c14/00833203206f6884.jpg", "https://img14.360buyimg.com/n1/jfs/t1/538344/32/1045/88182/6aba0a86F8862dac1/00833203209ef461.jpg" ], "brand": "茅台", "model": "白酒", "original_price": 1041, "upc": "•••;•••", "warranty": "无质保", "product_area": "贵州仁怀", "is_jd_express": false, "variant_count": 9, "variants": [ { "sku_id": "100278756721", "image_url": "https://img14.360buyimg.com/n1/jfs/t1/442358/22/5618/62044/6a17b873F63dd4c14/00833203206f6884.jpg" }, { "sku_id": "100153291833", "image_url": "https://img14.360buyimg.com/n1/jfs/t1/538344/32/1045/88182/6aba0a86F8862dac1/00833203209ef461.jpg" }, { "sku_id": "100371797016", "image_url": "https://img14.360buyimg.com/n1/jfs/t1/545564/17/1981/187886/6accddbdFb7d949e4/0083320320d24f2b.png" } ], "platform": "jd" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
item_id | ID numérico del producto en JD. Desde los resultados de búsqueda puedes pasarlo directamente a detalle, reseñas o precio. |
url | Enlace al registro en la plataforma. |
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
price | Precio como número, sin símbolo de moneda; ver currency. |
price_display | Precio tal como aparece en la página de JD; puede estar enmascarado por inicio de sesión o condiciones de membresía. |
price_masked | Si JD enmascara el precio en la página de detalle. Cuando es true, no trates price_display como el precio exacto de la transacción. |
currency | Código de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda. |
available | Indica si el artículo se podía comprar al leerlo (filas de product_detail, product_price y shop); false si está agotado, null si la página no lo indica. |
unavailable_reason | Razón pública que muestra JD cuando un producto no está en venta. |
shop_id | ID numérico de la tienda en JD. |
shop_name | Nombre público de la tienda. |
shop_url | Página pública de la tienda en JD. |
category_id | ID de la categoría final de JD del producto (product_detail). |
category | Nombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas. |
stock | Cantidad en stock que JD muestra públicamente; null significa que la página no la indica, no que sea cero. |
stock_state | Código público de estado de stock de JD. |
color | Color (o acabado) de este SKU tal como aparece en la página de JD. |
size | Talla, capacidad o especificación de este SKU tal como aparece en la página de JD. |
weight | Peso del producto tal como figura en la página de JD (product_detail); null si la página no lo indica. |
image_url | URL de imagen: en search, product_detail, shop y skus es la imagen principal (portada) del producto; en description_images es la imagen de descripción de esa fila (la imagen https a tamaño original en el servidor de imágenes de JD). |
image_urls | URLs de la galería de imágenes del producto (incluye la portada, en el orden en que aparecen en la página de JD). El image_url singular es la primera de ellas. Las imágenes largas de la sección de descripción no están aquí; se obtienen con description_images. |
is_jd_self | Si es un producto de operación propia de JD (JD.com retail). |
brand | Marca del producto. |
model | Número de modelo del producto. |
original_price | Precio de lista (original) que muestra JD; puede diferir del precio promocional. null si la página no lo proporciona. |
upc | Código de barras del producto (UPC/EAN). null si la página no lo proporciona. |
warranty | Términos de garantía, tal como aparecen en la página. |
product_area | Lugar de origen. |
is_jd_express | Si el producto se envía mediante JD Logistics. |
variant_count | Número de variantes (SKUs). null si no hay o no se proporciona. Todas las filas de skus llevan el mismo valor: si es mayor que el número de filas devueltas, limit cortó la lista o algunos SKU no se obtuvieron esta vez. |
variants | Lista de variantes. Cada entrada incluye nombre, ID de SKU, precio, stock, estado de stock e URL de imagen cuando están disponibles; null si no hay o no se proporciona. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Referencias oficiales
#Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- JD.com: etiquetas de precio y precios de compra condicionales ↗
JD.com diferencia la etiqueta mostrada en tiempo real del precio final del artículo y de ventajas para miembros, nuevos usuarios, regiones o grupos específicos, y advierte que algunos datos comparativos pueden retrasarse o faltar. El precio devuelto es la lectura visible al hacer la solicitud, no el precio personal de una transacción, el importe liquidado ni una garantía de exactitud absoluta.
Comprobado el 2026-09-11
Preguntas frecuentes
¿Qué formatos acepta item_id?
Un ID numérico de producto de JD o un enlace https://item.jd.com/<número>.html sin parámetros de consulta ni fragmento, como https://item.jd.com/100012043978.html. Los enlaces opacos más recientes bajo /product/ no se aceptan, y otras direcciones de JD.com tampoco. El item_id que devuelve JD.com Búsqueda funciona tal cual.
¿Por qué a veces el precio aparece oculto?
JD enmascara el precio de algunas fichas tras el inicio de sesión o condiciones de membresía. Cuando price_masked es true, price_display es el texto que muestra la página y no un precio de venta exacto, así que marca esas filas aparte si haces seguimiento de precios. Si solo necesitas precio y disponibilidad, JD.com Precio del producto acepta el mismo item_id.
¿Cómo sé si un producto no está disponible?
Lee available, el estado de venta actual; cuando el producto no se puede comprar, unavailable_reason recoge el motivo público que muestra JD. stock_state es el código público de estado de stock de JD y conviene guardarlo junto a los otros dos si sigues la disponibilidad a lo largo del tiempo.
¿Qué campos devuelve la API de detalles de producto de JD?
item_id, url, title, price, price_display, price_masked, currency, available, unavailable_reason, shop_id, shop_name, category_id, stock, stock_state, brand, model, original_price, upc, warranty, product_area, is_jd_express, variants y más.
¿En qué unidad está weight?
weight es el peso del producto tal como lo escribe la página de JD, por ejemplo 1.1kg; null significa que la página no lo indica.
¿Cuánto cuesta leer un producto?
Cuesta $0.002444 por llamada, o $2.44 por 1000 llamadas. Las llamadas fallidas y los resultados vacíos no se cobran.
Capacidades de JD.com relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de JD.com.
- Búsqueda
search$2.47 por cada 1000 llamadasBusca productos de JD.com mediantekeywordy conserva elitem_idde cada resultado para las consultas de un solo producto. - Reseñas
reviews$8 por cada 1000 llamadasLee las reseñas públicas visibles de unitem_id, hasta 10 por llamada, y conpage_tokenpuedes seguir con las páginas siguientes. - Tienda
shop$28.81 por cada 1000 llamadasConsulta el catálogo visible de una tienda medianteshop, con una cadena de dígitos o el enlace antiguo canónico demall.jd.comsin query ni fragment. - Precio del producto
product_price$5.56 por cada 1000 llamadasConsulta el precio mostrado para un soloitem_idcomo una lectura puntual. - Todos los SKU con precio
skus$2.44 por cada 1000 llamadasDevuelve todos los SKU del producto de JD.com que indicaitem_id, una fila por SKU: primero el que enviaste (is_requestedes true) y después los demás colores, tallas o capacidades que JD muestra para él. - Imágenes de la descripción
description_images$8 por cada 1000 llamadasDevuelve las imágenes de la sección de descripción del producto de JD.com que indicaitem_id, una fila por imagen de arriba abajo:positionempieza en 1,image_urles la imagen a tamaño original en el servidor de imágenes de JD y cada fila lleva el total enimage_count.