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_id de 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
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "jd",
      "action": "product_price",
      "params": {
        "item_id": "100012043978"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "item_id": "100012043978",
        "price": 1699,
        "currency": "CNY",
        "available": true,
        …
      }
    }
  3. 3Campos

    item_idpricecurrencyavailable
    1000120439781699CNYtrue
  4. 4CSV

    jd-product_price-sample.csv item_id,url,price,currency,available,unavailable_reason,platform

Entra una solicitud con 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_idurlpricecurrencyavailableunavailable_reasonplatform
100012043978https://item.jd.com/100012043978.html1699CNYtruenulljd

Casos de uso

  • Seguimiento de precios

    Lee price por item_id cada cierto tiempo y guárdalo como serie de precios.

  • Depurar una lista de productos

    Lee cada item_id de tu lista y descarta los productos con available en false.

  • Contrastar precios de búsqueda

    Compara el price de search o shop con el price que 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.

AspectoCentro de ayuda de JD: explicación de etiquetas de precioEveryInfra
Precios que no entranEl 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_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.
  • Devuelve solo el precio y el estado de venta; para el título, la tienda y el stock, usa product_detail.
  • price no lleva símbolo de moneda, así que léelo con currency; cuando price tiene valor y currency es null, no supongas una moneda.
  • unavailable_reason aparece 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.

LlamadasCosto
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

#
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_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.

POST

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

#
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_priceIdentificador 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 7 de noviembre de 2026, 14:47 (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_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.

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.
pricePrecio como número, sin símbolo de moneda; ver currency.
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.
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é 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.

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

Google Analytics solo si aceptas. Privacidad