API de Precio del producto de JD.com
Lee el price actual de un producto de JD.com por item_id, junto con currency, available y, cuando no se puede comprar, unavailable_reason, por $5.56 por cada 1000 llamadas.
- Devuelve solo el precio y el estado de venta, no la ficha del producto.
- Una llamada lee un producto, lo que encaja con consultar precios por
item_idde forma periódica. - 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_price", "params": { "item_id": "100012043978" } }2Respuesta JSON
{ "results": { "item_id": "100012043978", "price": 1699, "currency": "CNY", "available": true, … } }3Campos
item_id price currency available 100012043978 1699 CNY true 4CSV
jd-product_price-sample.csv item_id,url,price,currency,available,unavailable_reason,platform
item_id y sale un objeto JSON con solo el precio y el estado de venta, que se muestra como tabla de campos y se puede descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para 100012043978, obtenida el 7 de noviembre de 2026, 14:47 (UTC), que devolvió un objeto. En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.
| item_id | url | price | currency | available | unavailable_reason | platform |
|---|---|---|---|---|---|---|
| 100012043978 | https://item.jd.com/100012043978.html | 1699 | CNY | true | null | jd |
Casos de uso
Seguimiento de precios
Lee
priceporitem_idcada cierto tiempo y guárdalo como serie de precios.Depurar una lista de productos
Lee cada
item_idde tu lista y descarta los productos conavailableenfalse.Contrastar precios de búsqueda
Compara el
pricedesearchoshopcon elpriceque lees aquí.
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_price de EveryInfra en qué precios de estatus del comprador deja fuera el precio de la página.
| Aspecto | Centro de ayuda de JD: explicación de etiquetas de precio | EveryInfra |
|---|---|---|
| Precios que no entran | 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 el precio visible en el momento de la captura; puede no incluir ofertas de miembro, de usuario nuevo, regionales o de cupones dirigidos, ni las que se aplican al pagar. |
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 precios. 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.- Devuelve solo el precio y el estado de venta; para el título, la tienda y el stock, usa
product_detail. priceno lleva símbolo de moneda, así que léelo concurrency; cuandopricetiene valor ycurrencyesnull, no supongas una moneda.unavailable_reasonaparece solo cuando el producto no se puede comprar, y es el motivo que JD muestra públicamente.
Precios
Pagas $0.005556 por llamada, y una llamada lee un producto. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $55.56 |
| 100,000 | $555.56 |
| 1,000,000 | $5,555.56 |
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_price",
"params": {
"item_id": "100012043978"
}
}'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_price, 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: Precio del producto (jd/product_price).
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_price, 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, price, currency, available (Indica si el artículo se podía comprar…), unavailable_reason (Razón pública que muestra JD cuando un…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "jd",
"action": "product_price",
"params": {
"item_id": "100012043978"
}
}
- Precio: $5.56 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_price | 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_price", "results": { "item_id": "100012043978", "url": "https://item.jd.com/100012043978.html", "price": 1699, "currency": "CNY", "available": true, "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. |
price | Precio como número, sin símbolo de moneda; ver currency. |
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. |
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é campos devuelve la API de precio de producto de JD?
item_id, url, price, currency y available, y además unavailable_reason cuando el producto no se puede comprar.
¿Están aquí price_display y price_masked?
No. Para ver si JD enmascara el precio de un producto, usa product_detail.
¿Cuánto cuesta leer un precio?
Cuesta $0.005556 por llamada, o $5.56 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. - Detalles del producto
product_detail$2.44 por cada 1000 llamadasConsulta un producto de JD.com medianteitem_id, ya sea una cadena de dígitos o el enlace antiguo canónico sin query ni fragment. - 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. - 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.