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, warranty y product_area dan el código de barras, el texto de garantía y el lugar de origen.
  • is_jd_self e is_jd_express marcan 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
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "jd",
      "action": "product_detail",
      "params": {
        "item_id": "https://item.jd.com/100012043978.html"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "upc": "•••;•••",
        "item_id": "100012043978",
        "title": "茅台飞天 53%vol 500ml 贵州茅台酒(带杯)【需预约购买】",
        "price": 1041,
        …
      }
    }
  3. 3Campos

    upcitem_idtitleprice
    •••;•••100012043978茅台飞天 53%vol 500ml 贵州茅台酒(带杯)【需预约购买】1041
  4. 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

Entra una solicitud con 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_idurltitlepriceprice_displayprice_maskedcurrencyavailableunavailable_reasonshop_idshop_nameshop_urlcategory_idcategorystockstock_statecolorsizeweightimage_urlimage_urlsis_jd_selfbrandmodeloriginal_priceupcwarrantyproduct_areais_jd_expressvariant_countvariantsplatform
100012043978https://item.jd.com/100012043978.html茅台飞天 53%vol 500ml 贵州茅台酒(带杯)【需预约购买】10411??9nullCNYfalsenull1000475228贵州茅台https://mall.jd.com/index-1000475228.html9435null156out_of_stock1759(需预约)单瓶装1.1kghttps://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•••;•••无质保贵州仁怀false9[{"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 price y original_price cada cierto tiempo; marca aparte las filas con price_masked en true y no las uses como precio exacto.

  • Completar un catálogo

    Rellena huecos con brand, model, category_id, upc y product_area, y toma todas las imágenes del producto de image_urls.

  • Encontrar productos no disponibles

    Cuando available es false, lee unavailable_reason y stock_state.

  • Ver quién vende y quién envía

    shop_name nombra la tienda, is_jd_self marca la venta directa de JD e is_jd_express indica 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.

AspectoCentro de ayuda de JD: explicación de etiquetas de precioEveryInfra
Precio en vivo de la páginaEl 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_id es 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.
  • stock es null cuando la página no lo indica, y eso no equivale a 0; available es null cuando la página no da estado de venta.
  • original_price es null cuando la página no lo proporciona y, si tiene valor, puede diferir del price promocional.
  • variants es null cuando el producto no tiene variantes o no se proporcionaron; para el precio y el stock de cada SKU, usa skus.
  • image_urls es 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 con description_images.

Precios

Pagas $0.002444 por llamada, y una llamada lee un producto. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
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

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

POST

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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSíjdIdentificador de la plataforma, valor fijo.
actionbodystringSíproduct_detailIdentificador de la capacidad, valor fijo.
item_idbody.paramsstringSí-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

#
Obtenida el 24 de octubre de 2026, 18:28 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "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.

CampoSignificado
item_idID numérico del producto en JD. Desde los resultados de búsqueda puedes pasarlo directamente a detalle, reseñas o precio.
urlEnlace al registro en la plataforma.
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
pricePrecio como número, sin símbolo de moneda; ver currency.
price_displayPrecio tal como aparece en la página de JD; puede estar enmascarado por inicio de sesión o condiciones de membresía.
price_maskedSi 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.
currencyCódigo de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda.
availableIndica 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_reasonRazón pública que muestra JD cuando un producto no está en venta.
shop_idID numérico de la tienda en JD.
shop_nameNombre público de la tienda.
shop_urlPágina pública de la tienda en JD.
category_idID de la categoría final de JD del producto (product_detail).
categoryNombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
stockCantidad en stock que JD muestra públicamente; null significa que la página no la indica, no que sea cero.
stock_stateCódigo público de estado de stock de JD.
colorColor (o acabado) de este SKU tal como aparece en la página de JD.
sizeTalla, capacidad o especificación de este SKU tal como aparece en la página de JD.
weightPeso del producto tal como figura en la página de JD (product_detail); null si la página no lo indica.
image_urlURL 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_urlsURLs 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_selfSi es un producto de operación propia de JD (JD.com retail).
brandMarca del producto.
modelNúmero de modelo del producto.
original_pricePrecio de lista (original) que muestra JD; puede diferir del precio promocional. null si la página no lo proporciona.
upcCódigo de barras del producto (UPC/EAN). null si la página no lo proporciona.
warrantyTérminos de garantía, tal como aparecen en la página.
product_areaLugar de origen.
is_jd_expressSi el producto se envía mediante JD Logistics.
variant_countNú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.
variantsLista 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.
platformIdentificador 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.

Errores

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.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de JD.com.

Google Analytics solo si aceptas. Privacidad