API de Reseñas de JD.com

Lee las reseñas públicas de un producto de JD.com por item_id, con text, review_append, rating, rating_scale, posted_at, color, size y useful_count en cada fila, por $8 por cada 1000 llamadas.

  • Cada página trae hasta 10 reseñas; sigue next_page_token para leer más.
  • images trae los enlaces de las fotos de una reseña.
  • Cada página cuenta como una llamada. Las llamadas fallidas y los resultados vacíos no se cobran.

Salud de la API

Salud 24 h
27 %
Tiempo medio 24 h
42.84 s
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Casi sin servicio

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

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

    {
      "results": [
        {
          "author_name": "j•••℡",
          "item_id": "100012043978",
          "text": "物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试",
          "rating": 5
        },
        …
      ],
      "count": 10
    }
  3. 3Filas

    author_nameitem_idtextrating
    j•••℡100012043978物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试5
    陈•••7100012043978东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验5
  4. 4CSV

    jd-reviews-sample.csv 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,next_page_token

Entra una solicitud con item_id y sale una página de reseñas públicas; cada fila de results es una reseña, y 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ó 10 filas; las barras grises marcan los ID de reseña, los apodos y los enlaces de avatar eliminados (••• en el CSV). En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.

iditem_idtextreview_appendratingrating_scaleposted_atcolorsizeuseful_countimagesauthor_nameauthor_avatar_urlauthor_is_plusbuy_countplatformnext_page_token
100012043978物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试null552026-11-07 14:34:451699(需预约)单瓶装0["https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/557810/23/10814/50965/6aeec685F7fa2380d/00a94387803e2e5c.jpg.dpg","https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568876/20/7224/105703/6aeec685Fb32a61e9/00a9438780d6819f.jpg.dpg"]j•••℡false11jdnull
100012043978东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验null552026-11-05 18:31:461699(需预约)单瓶装0["https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568910/26/5643/80138/6aec5b11F8b1fc87a/00a94387808839c8.jpg.dpg","https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/563156/26/7646/104649/6aec5b11Fb763e1e5/00a943878073852a.jpg.dpg"]陈•••7false3jdnull

Casos de uso

  • Clasificar quejas por causa

    Toma las reseñas con rating bajo, lee text y review_append, y agrupa las quejas.

  • Comparar opiniones por variante

    Agrupa por color y size para ver en qué se diferencian las reseñas de cada variante.

  • Revisar fotos de reseñas

    images guarda los enlaces de las fotos de los compradores, que puedes contrastar con la página del producto.

  • Ver cuándo se concentran las reseñas

    Tras leer unas páginas, cuenta las filas por posted_at para ver en qué fechas caen las reseñas nuevas.

Centro de ayuda de JD: reglas de reseñas y fotos frente a EveryInfra

Así se comparan las reglas de reseñas y fotos del Centro de ayuda de JD y reviews de EveryInfra en reseñas de seguimiento, en cómo se muestran los apodos y en qué reseñas se muestran.

AspectoCentro de ayuda de JD: reglas de reseñas y fotosEveryInfra
Reseña de seguimientoUn cliente puede publicar una primera reseña con fotos dentro de los 60 días siguientes a completarse el pedido, valorar el servicio dentro de 90 días y añadir una reseña de seguimiento dentro de 180 días (salvo algunas categorías especiales).review_append guarda el texto de seguimiento que añadió el comprador; llega aparte de text, la primera reseña.
Cómo se muestran los apodosPara proteger la privacidad, el módulo de reseñas de la página del producto muestra los apodos de usuario con asteriscos en lugar de algunos caracteres.author_name llega tal como lo muestra la página de JD; JD puede haber enmascarado una parte.
Qué reseñas se muestranJD revisa el contenido de las reseñas y las fotos, y solo el contenido que cumple las reglas y pasa la revisión se muestra a los demás usuarios.reviews lee las reseñas que se muestran públicamente en la página del producto. Una página es solo una parte, no el conjunto completo de reseñas del producto.

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 es un aviso de reglas para compradores, no un documento de interfaz para leer reseñas. Fuentes oficiales: Reglas de reseñas y fotos (Centro de ayuda de JD)

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.
  • Solo puedes avanzar con next_page_token, página a página; las reseñas de JD no se pueden leer por número de página. Una respuesta sin next_page_token (pagination.has_more es false) es el final.
  • Con limit por debajo de 10, una página puede traer menos de limit reseñas sin ser la última; solo la ausencia de next_page_token marca el final.
  • Si entran reseñas nuevas mientras paginas, dos páginas contiguas pueden compartir una o dos reseñas, así que combina por id de reseña.
  • Mira rating_scale en la misma fila antes de comparar valoraciones; es el máximo de rating.

Precios

Cada página cuenta como una llamada de $0.008, no por reseña; una página vacía no se cobra. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$80.00
100,000$800.00
1,000,000$8,000.00

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": "reviews",
  "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 reviews, 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: Reseñas (jd/reviews).

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 reviews, 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.
- Parámetros opcionales:
  - page_token: Token de paginación. Omítelo en la primera página; cuando la respuesta traiga next_page_token, devuélvelo tal cual como page_token para obtener la página siguiente, con los demás parámetros iguales (limit sí puede cambia…
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 10. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 10)
- Devuelve una lista de registros. Campos principales de cada registro: id, item_id (ID numérico del producto en JD), text, review_append (Texto de la reseña adicional (append) d…), rating, rating_scale, posted_at, color (Color (o acabado) de este SKU tal como…), size (Talla, capacidad o especificación de es…), useful_count, images, author_name (Apodo del reseñador, tal como lo muestr…); 16 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "jd",
  "action": "reviews",
  "params": {
    "item_id": "100012043978"
  }
}
- Precio: $8 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íreviewsIdentificador 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.
page_tokenbody.paramsstringNo-Token de paginación. Omítelo en la primera página; cuando la respuesta traiga next_page_token, devuélvelo tal cual como page_token para obtener la página siguiente, con los demás parámetros iguales (limit sí puede cambiar). El token dura 24 horas y solo sirve para el mismo producto y la misma cuenta; con otro producto se rechaza con 422 y no se cobra. Si no hay next_page_token (o pagination.has_more es false), llegaste al final. Cada página trae como máximo 10 reseñas y es una llamada; una página vacía no se cobra. Con un limit menor que 10, la página siguiente empieza por lo que quedó sin entregar de la anterior, así que una página puede traer menos de limit reseñas. Eso no significa que sea el final: solo lo indica la ausencia de next_page_token. Si entran reseñas nuevas mientras paginas, dos páginas seguidas pueden repetir una o dos, así que elimina duplicados por el id de la reseña al combinarlas. Las reseñas de JD no permiten saltar a un número de página; avanza página a página con next_page_token.
limitbody.paramsinteger (1–10)No10Número máximo de filas que devuelve esta llamada, un entero de 1 a 10. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro.

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); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "jd",  "action": "reviews",  "results": [    {      "id": "•••",      "item_id": "100012043978",      "text": "物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试",      "rating": 5,      "posted_at": "2026-11-07 14:34:45",      "color": "1699(需预约)",      "size": "单瓶装",      "useful_count": 0,      "images": [        "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/557810/23/10814/50965/6aeec685F7fa2380d/00a94387803e2e5c.jpg.dpg",        "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568876/20/7224/105703/6aeec685Fb32a61e9/00a9438780d6819f.jpg.dpg"      ],      "author_name": "j•••℡",      "author_avatar_url": "https://storage.360buyimg.com/•••",      "author_is_plus": false,      "buy_count": 11,      "platform": "jd",      "rating_scale": 5    },    {      "id": "•••",      "item_id": "100012043978",      "text": "东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验",      "rating": 5,      "posted_at": "2026-11-05 18:31:46",      "color": "1699(需预约)",      "size": "单瓶装",      "useful_count": 0,      "images": [        "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/568910/26/5643/80138/6aec5b11F8b1fc87a/00a94387808839c8.jpg.dpg",        "https://img30.360buyimg.com/shaidan/s300x300_jfs/t1/563156/26/7646/104649/6aec5b11Fb763e1e5/00a943878073852a.jpg.dpg"      ],      "author_name": "陈•••7",      "author_avatar_url": "https://storage.360buyimg.com/•••",      "author_is_plus": false,      "buy_count": 3,      "platform": "jd",      "rating_scale": 5    }  ],  "next_page_token": …,  "pagination": { … },  "count": 10,  "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
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
item_idID numérico del producto en JD. Desde los resultados de búsqueda puedes pasarlo directamente a detalle, reseñas o precio.
textTexto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma).
review_appendTexto de la reseña adicional (append) del comprador.
ratingValoración. La escala depende de la plataforma: rating_scale en la misma fila indica el máximo (normalmente 5; Booking, Douban, iQIYI y NAVER usan 10). Convierte con rating_scale antes de comparar entre plataformas o la comparación puede salir al revés.
rating_scaleMáximo de rating en la misma fila: 5 en escalas de cinco estrellas y 10 en escalas de diez puntos. Solo aparece si la fila tiene rating.
posted_atFecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica.
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.
useful_countConserva el significado de la plataforma
imagesLista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
author_nameApodo del reseñador, tal como lo muestra JD (JD puede tenerlo ya parcialmente enmascarado).
author_avatar_urlURL del avatar del reseñador.
author_is_plusSi el reseñador es miembro JD PLUS.
buy_countCuántas veces compró este producto el reseñador, según la página («comprado N veces»).
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
next_page_tokenToken de paginación: devuélvelo sin cambios como page_token, con los demás parámetros iguales, para obtener la página siguiente; dura 24 horas y solo sirve para el mismo producto. Todas las filas de una página llevan el mismo valor, que también aparece en el nivel superior de la respuesta. No aparece en la última página; con un limit menor que 10 una página puede traer menos de limit reseñas, así que solo su ausencia indica el final.

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

    Comprobado el 2026-09-11

  • Acuerdo 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.

    Comprobado el 2026-09-11

Preguntas frecuentes

¿Qué campos devuelve la API de reseñas de JD?

id, item_id, text, review_append, rating, rating_scale, posted_at, color, size, useful_count, images, author_name, author_avatar_url, author_is_plus y buy_count.

¿Qué significan color y size en una reseña?

Son la variante a la que pertenece la reseña: el color (o aspecto) y el tamaño, la capacidad u otro valor de ese SKU en la página de JD. Sirven para agrupar reseñas por variante.

¿Cuánto cuesta leer una página de reseñas?

Cada página cuenta como una llamada de $0.008, o $8 por 1000 llamadas, no por reseña. 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