API de plataforma de EveryData
API de JD.com
JD.com separa la búsqueda de productos, la ficha individual, las reseñas públicas, el catálogo de tienda y el precio mostrado en cinco acciones. Cada acción conserva su selector y su objeto de respuesta.
Empieza con `search` y reutiliza el `item_id` devuelto en `product_detail`, `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.
- Endpoint
- POST /api/v1/social
- Funciones
- 5
- Por 1.000
- $1.39 por 1.000 solicitudes
Funciones disponibles
Compara las acciones de JD.com por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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 = 25` y `maxLimit = 25` 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 · is_jd_self · 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 · 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 |
¿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.
¿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 propias superficies, pero el contrato actual de esta acción no publica campos de identidad del autor. El resultado tampoco representa un historial completo ni concede permiso de republicación.
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
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 devuelto si la acción es 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>"}}'
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 de origen contengan 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.