API de JD.com
JD.com separa la búsqueda de productos, la ficha individual, todos los SKU de un producto con su precio y su stock, las imágenes de la sección de descripción de un producto, las reseñas públicas, el catálogo de tienda y el precio mostrado en siete acciones. Cada acción conserva su selector y su objeto de respuesta.
Empieza con search y reutiliza el item_id devuelto en product_detail, skus, description_images, reviews o product_price. La acción shop usa un identificador de tienda independiente. El precio mostrado y la disponibilidad son lecturas puntuales, no condiciones personales de compra o liquidación.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de JD.com, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar productos en JD.comsearch | Busca productos de JD.com mediante keyword y conserva el item_id de cada resultado para las consultas de un solo producto. | $1.39 por 1.000 solicitudes | Normal |
Consultar una ficha de productoproduct_detail | Consulta un producto de JD.com mediante item_id, ya sea una cadena de dígitos o el enlace antiguo canónico sin query ni fragment. | $1.39 por 1.000 solicitudes | Normal |
Leer reseñas de un productoreviews | Lee las reseñas públicas visibles de un item_id. | $1.39 por 1.000 solicitudes | No disponible temporalmente |
Listar el catálogo de una tiendashop | Consulta el catálogo visible de una tienda mediante shop, con una cadena de dígitos o el enlace antiguo canónico de mall.jd.com sin query ni fragment. | $1.39 por 1.000 solicitudes | No disponible temporalmente |
Consultar el precio de un productoproduct_price | Consulta el precio mostrado para un solo item_id como una lectura puntual. | $1.39 por 1.000 solicitudes | No disponible temporalmente |
Listar todos los SKU de un producto con su precioskus | Devuelve todos los SKU del producto de JD.com que indica item_id, una fila por SKU: primero el que enviaste (is_requested es true) y después los demás colores, tallas o capacidades que JD muestra para él. | $1.39 por 1.000 solicitudesCada fila cuenta como una llamada | Normal |
Obtener las imágenes de la descripción de un productodescription_images | Devuelve las imágenes de la sección de descripción del producto de JD.com que indica item_id, una fila por imagen de arriba abajo: position empieza en 1, image_url es la imagen a tamaño original en el servidor de imágenes de JD y cada fila lleva el total en image_count. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de JD.com?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar productos en JD.com Busca productos de JD.com mediante | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 5 y maxLimit = 5 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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_detailConsultar una ficha de producto Consulta un producto de JD.com mediante | item_id | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | 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 |
reviewsLeer reseñas de un producto Lee las reseñas públicas visibles de un | item_id | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 10 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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 |
shopListar el catálogo de una tienda Consulta el catálogo visible de una tienda mediante | shop_id | — | Entrega síncrona | El catálogo declara defaultLimit = 24 y maxLimit = 24 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | item_id · url · title · price · currency · shop_id · shop_name · shop_url · image_url · available · platform |
product_priceConsultar el precio de un producto Consulta el precio mostrado para un solo | item_id | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | item_id · url · price · currency · available · unavailable_reason · platform |
skusListar todos los SKU de un producto con su precio Devuelve todos los SKU del producto de JD.com que indica | item_id | — | Entrega síncrona | El catálogo declara defaultLimit = 100 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudesCada fila cuenta como una llamada | 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_imagesObtener las imágenes de la descripción de un producto Devuelve las imágenes de la sección de descripción del producto de JD.com que indica | item_id | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | item_id · position · image_url · image_count · platform |
¿Qué significan los parámetros de JD.com search?
Busca productos de JD.com mediante keyword y conserva el item_id de cada resultado para las consultas de un solo producto. El orden y la cobertura corresponden a la respuesta observada, no a un catálogo completo ni a un ranking permanente.
keywordObligatorio- Texto de búsqueda de productos para la acción
searchde JD.com. No es un ID de artículo ni un selector de tienda, y los resultados coincidentes no representan necesariamente todo el catálogo.JD.com JOS y JD Union: objetos de producto y SKU — Los materiales de la plataforma abierta y del programa de afiliación autorizados de JD.com describen objetos de producto y SKU, como nombre, imagen principal, categoría, precio mostrado, logística, estado de venta directa y señales de volumen de pedidos. Esta terminología no demuestra que estén disponibles todas las páginas o campos, que el solicitante tenga acceso ni que EveryInfra implemente la interfaz oficial. · Consultada
¿Qué significan los parámetros de JD.com product_detail?
Consulta un producto de JD.com mediante item_id, ya sea una cadena de dígitos o el enlace antiguo canónico sin query ni fragment. La ficha observada no garantiza inventario, condiciones de entrega ni que cualquier URL de JD.com sea válida.
item_idObligatorio- Identifica un producto de JD.com para
product_detail,reviewsoproduct_price. Envía la cadena de dígitos devuelta porsearcho la URL antigua canónicahttps://item.jd.com/<dígitos>.htmlsin query ni fragment; se rechazan las URL arbitrarias, opacas o de otro host.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. · Consultada
¿Qué significan los parámetros de JD.com reviews?
Lee las reseñas públicas visibles de un item_id. Las reglas de JD.com describen reseñas posteriores, imágenes, respuestas, moderación, contenido plegado y apodos ocultos en sus interfaces; cada reseña incluye el apodo del autor tal como lo muestra JD.com (puede estar enmascarado en parte), su foto de perfil, si es miembro PLUS y cuántas veces compró, en author_name, author_avatar_url, author_is_plus y buy_count. El resultado no representa un historial completo ni permite republicar el contenido.
item_idObligatorio- Identifica un producto de JD.com para
product_detail,reviewsoproduct_price. Envía la cadena de dígitos devuelta porsearcho la URL antigua canónicahttps://item.jd.com/<dígitos>.htmlsin query ni fragment; se rechazan las URL arbitrarias, opacas o de otro host.JD.com: reglas de reseñas y contenido con imágenes — JD.com distingue reseñas, reseñas posteriores, imágenes, respuestas, moderación, contenido plegado y apodos ocultos. La visibilidad pública puede depender de las reglas de revisión y privacidad; por eso, el conjunto devuelto no representa un historial completo ni concede permiso para redistribuir contenido de los autores. · ConsultadaAcuerdo de servicio de JD.com (vigente desde el 20 de enero de 2026): reseñas públicas y límites de acceso — El acuerdo vigente indica que la información de las reseñas es pública y que JD.com puede utilizarla conforme al propio acuerdo. También señala que los datos personales, por regla general, no se revelan a terceros sin permiso y prohíbe sustraer información personal o vulnerar derechos legítimos. Esta fuente solo respalda límites de acceso y autorización; no concede a EveryInfra ni a quien llama derechos para redistribuir, entrenar modelos o reutilizar comercialmente textos, imágenes o información de usuarios. · Consultada
¿Qué significan los parámetros de JD.com shop?
Consulta el catálogo visible de una tienda mediante shop, con una cadena de dígitos o el enlace antiguo canónico de mall.jd.com sin query ni fragment. Este selector no es un item_id y los resultados no prueban el inventario total de la tienda.
shop_idObligatorio- Identifica la tienda de la acción
shop. Envía una cadena de dígitos o la URL antigua canónicahttps://mall.jd.com/index-<dígitos>.htmlsin query ni fragment; se rechazan otros hosts y este selector no acepta elitem_idde un producto.JD.com JSSDK: destinos distintos para SKU y tienda — La documentación de redirección de JD.com usa `skuId` para el destino de detalle de un producto y `shopId` para el destino de una tienda. Esto respalda mantener separados ambos identificadores; no demuestra permisos para recopilar páginas, formatos de URL admitidos, catálogos completos de tienda ni el comportamiento de las solicitudes de EveryInfra. · Consultada
¿Qué significan los parámetros de JD.com product_price?
Consulta el precio mostrado para un solo item_id como una lectura puntual. No equivale al precio personal de compra, a ventajas de membresía, al importe liquidado ni a una garantía de exactitud absoluta.
item_idObligatorio- Identifica un producto de JD.com para
product_detail,reviewsoproduct_price. Envía la cadena de dígitos devuelta porsearcho la URL antigua canónicahttps://item.jd.com/<dígitos>.htmlsin query ni fragment; se rechazan las URL arbitrarias, opacas o de otro host.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. · Consultada
¿Qué significan los parámetros de JD.com skus?
Devuelve todos los SKU del producto de JD.com que indica item_id, una fila por SKU: primero el que enviaste (is_requested es true) y después los demás colores, tallas o capacidades que JD muestra para él. Cada fila trae sus propios properties, price, on_sale, in_stock, stock_state y stock. price es el precio de JD que ve un comprador sin iniciar sesión y no incluye los cupones que se aplican al pagar, así que no es el precio final con cupón. Cada SKU devuelto cuenta como una llamada: limit (de 1 a 100, 100 por defecto) fija el cobro por adelantado y los SKU que no vuelven se reembolsan. Esta acción solo funciona en modo síncrono.
item_idObligatorio- Identifica un producto de JD.com para
skusa través de cualquiera de sus SKU. Envía la cadena de dígitos, un enlace de producto de JD (https://item.jd.com/<dígitos>.html,https://item.m.jd.com/product/<dígitos>.htmlo una páginawqitem.jd.comabierta dentro de WeChat) o un texto compartido que contenga exactamente uno de esos enlaces; los parámetros de seguimiento del enlace no importan. No se aceptan enlaces cortos como3.cnou.jd.com: ábrelos antes en el navegador y copia el enlace de la página del producto.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. · Consultada
¿Qué significan los parámetros de JD.com description_images?
Devuelve las imágenes de la sección de descripción del producto de JD.com que indica item_id, una fila por imagen de arriba abajo: position empieza en 1, image_url es la imagen a tamaño original en el servidor de imágenes de JD y cada fila lleva el total en image_count. Son las imágenes largas que aparecen debajo de la galería; la galería es image_urls en product_detail, que no incluye las imágenes de descripción. item_id admite las mismas formas que en skus. Si el producto no tiene imágenes de descripción (retirado o sin descripción del vendedor), el resultado vacío no se cobra. Cada llamada se cobra una vez en el nivel estándar, al mismo precio que product_detail.
item_idObligatorio- Identifica el producto de JD.com cuyas imágenes de descripción quieres, a través de cualquiera de sus SKU. Envía la cadena de dígitos, un enlace de producto de JD (
https://item.jd.com/<dígitos>.html,https://item.m.jd.com/product/<dígitos>.htmlo una páginawqitem.jd.comabierta dentro de WeChat) o un texto compartido que contenga exactamente uno de esos enlaces; los parámetros de seguimiento del enlace no importan. No se aceptan enlaces cortos como3.cnou.jd.com: ábrelos antes en el navegador y copia el enlace de la página del producto.
Cómo usar la API de JD.com
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
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>"}}'
Guías de JD.com
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Cómo comercializar el rastreo de precios: crea un producto de supervisión que los comerciantes deseen renovar
Analiza por qué los comerciantes pagan por el seguimiento de precios y por qué cancelan la suscripción. A partir de la coincidencia de productos, las listas de excepciones operativas y la aprobación de cambios, examina las formas de entrega, las unidades de cobro y la validación de pilotos para datos de precios.
Leer el artículo →Fallos de API, devolución de cargos y conciliación: cómo verificar el cargo neto de una solicitud
Separa las tareas de negocio, los intentos de llamada, los estados de entrega y los eventos de la cartera para explicar los rechazos previos al cargo, los resultados vacíos y las devoluciones parciales de cargos sin restar dos veces una misma devolución, y verifica una única solicitud con ejemplos enteros sin conexión.
Leer el artículo →Preguntas sobre la API de JD.com
¿Cómo llamo a la API de JD.com?
Envía POST /api/v1/social con platform igual a jd, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de JD.com?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye item_id, title, short_title y price. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de JD.com?
Los materiales de la plataforma abierta y del programa de afiliación autorizados de JD.com describen objetos de producto y SKU, como nombre, imagen principal, categoría, precio mostrado, logística, estado de venta directa y señales de volumen de pedidos. Esta terminología no demuestra que estén disponibles todas las páginas o campos, que el solicitante tenga acceso ni que EveryInfra implemente la interfaz oficial.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; product_detail requiere item_id; reviews requiere item_id; consulta las demás acciones en la lista de funciones.
¿Las acciones de JD.com responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. skus solo funciona en modo síncrono: lee todo lo que devuelve (cada elemento de un lote o cada SKU de un producto) en la misma llamada y, si la solicitud lleva "mode": "async", la API responde con un 422 antes de cobrar nada. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.