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_tokenpara leer más. imagestrae 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
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "jd", "action": "reviews", "params": { "item_id": "100012043978" } }2Respuesta JSON
{ "results": [ { "author_name": "j•••℡", "item_id": "100012043978", "text": "物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试", "rating": 5 }, … ], "count": 10 }3Filas
author_name item_id text rating j•••℡ 100012043978 物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试 5 陈•••7 100012043978 东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验 5 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
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.
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 100012043978 | 物流已经收到了,东西还是很不错的,希望下次能更好的体验双十一的活动,物流更加多多活动更加多多越来越好,希望越来越更加多的活动优惠券,而且有更多的尝试 | null | 5 | 5 | 2026-11-07 14:34:45 | 1699(需预约) | 单瓶装 | 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•••℡ | false | 11 | jd | null | ||
| 100012043978 | 东西已经收到了,物流还是很快的,希望下次能更好的体验三十活动物流更加多多活动更加多多优惠更加突出福利更加美好,更体验,希望能有更加不一样的体验 | null | 5 | 5 | 2026-11-05 18:31:46 | 1699(需预约) | 单瓶装 | 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"] | 陈•••7 | false | 3 | jd | null |
Casos de uso
Clasificar quejas por causa
Toma las reseñas con
ratingbajo, leetextyreview_append, y agrupa las quejas.Comparar opiniones por variante
Agrupa por
colorysizepara ver en qué se diferencian las reseñas de cada variante.Revisar fotos de reseñas
imagesguarda 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_atpara 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.
| Aspecto | Centro de ayuda de JD: reglas de reseñas y fotos | EveryInfra |
|---|---|---|
| Reseña de seguimiento | Un 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 apodos | Para 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 muestran | JD 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_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.- 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 sinnext_page_token(pagination.has_morees false) es el final. - Con
limitpor debajo de 10, una página puede traer menos delimitreseñas sin ser la última; solo la ausencia denext_page_tokenmarca el final. - Si entran reseñas nuevas mientras paginas, dos páginas contiguas pueden compartir una o dos reseñas, así que combina por
idde reseña. - Mira
rating_scaleen la misma fila antes de comparar valoraciones; es el máximo derating.
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.
| Llamadas | Costo |
|---|---|
| 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
#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.
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
#| 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í | reviews | 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. |
page_token | body.params | string | No | - | 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. |
limit | body.params | integer (1–10) | No | 10 | 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. Los valores mayores devuelven 422 antes de cualquier cobro. |
Ejemplo de respuesta
#{ "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.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
item_id | ID numérico del producto en JD. Desde los resultados de búsqueda puedes pasarlo directamente a detalle, reseñas o precio. |
text | Texto 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_append | Texto de la reseña adicional (append) del comprador. |
rating | Valoració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_scale | Má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_at | Fecha 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. |
color | Color (o acabado) de este SKU tal como aparece en la página de JD. |
size | Talla, capacidad o especificación de este SKU tal como aparece en la página de JD. |
useful_count | Conserva el significado de la plataforma |
images | Lista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes. |
author_name | Apodo del reseñador, tal como lo muestra JD (JD puede tenerlo ya parcialmente enmascarado). |
author_avatar_url | URL del avatar del reseñador. |
author_is_plus | Si el reseñador es miembro JD PLUS. |
buy_count | Cuántas veces compró este producto el reseñador, según la página («comprado N veces»). |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
next_page_token | Token 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.
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.
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. - 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. - Precio del producto
product_price$5.56 por cada 1000 llamadasConsulta el precio mostrado para un soloitem_idcomo una lectura puntual. - 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.