API de Tienda de JD.com
Lee las filas de producto de una tienda de JD.com por shop_id: item_id, title, price, currency, image_url y available, con el shop_id, el shop_name y la shop_url de la tienda en cada fila, con facturación por tramos según las filas devueltas, $0.02881 por tramo.
limittiene un máximo de 60; pagina conpageopage_token.item_idpasa tal cual aproduct_detail,product_priceyskus.- 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": "shop", "params": { "shop_id": "1000004259" } }2Respuesta JSON
{ "results": [ { "item_id": "100386940168", "title": "HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表", "price": 2688, "currency": "CNY" }, … ], "count": 24 }3Filas
item_id title price currency 100386940168 HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表 2688 CNY 100343412080 华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘 7599 CNY 4CSV
jd-shop-sample.csv item_id,url,title,price,currency,shop_id,shop_name,shop_url,image_url,available,platform
shop_id y sale una página de productos de esa tienda; cada fila de results es un producto, y se muestra como tabla de campos y se puede descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para 1000004259, obtenida el 7 de noviembre de 2026, 14:47 (UTC), que devolvió 24 filas. En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.
| item_id | url | title | price | currency | shop_id | shop_name | shop_url | image_url | available | platform |
|---|---|---|---|---|---|---|---|---|---|---|
| 100386940168 | https://item.jd.com/100386940168.html | HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表 | 2688 | CNY | 1000004259 | 华为京东自营旗舰店 | https://mall.jd.com/index-1000004259.html | https://img14.360buyimg.com/n0/jfs/t1/550965/17/7947/140219/6ae2b424F7cc9d94c/00835a05a09af40b.jpg | null | jd |
| 100343412080 | https://item.jd.com/100343412080.html | 华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘 | 7599 | CNY | 1000004259 | 华为京东自营旗舰店 | https://mall.jd.com/index-1000004259.html | https://img14.360buyimg.com/n0/jfs/t1/537470/34/12588/89809/6acef399F2a2483a1/00835a05a01f9084.jpg | null | jd |
Casos de uso
Vigilar los precios de un competidor
Lee la misma tienda cada cierto tiempo y compara
priceporitem_id.Armar el catálogo de una tienda
Guarda
item_id,titleeimage_urlcomo lista que sirva de tabla base para investigar productos.Auditar revendedores autorizados
Una marca lee las filas de producto de cada revendedor para ver si
titleypricecoinciden con lo acordado.Ver el rango de precios de una tienda
Usa los valores de
pricede las filas que leas para ver cómo se reparten los precios de la tienda.
Límites y detalles a tener en cuenta
shop_ides obligatorio: un ID numérico de tienda de JD, o https://mall.jd.com/index-<número>.html sin parámetros de consulta ni fragmento. No es un ID de producto.- Fija el tamaño de página con
limit, hasta 60. Cada página se factura por tramos según las filas que devuelve, se devuelven los tramos de las filas que no llegan y una página vacía no se cobra. - Hay dos formas de paginar: empezar en la página 1 y devolver
next_page_tokental cual comopage_token, o saltar a la página N conpage. Si envías los dos, mandapage_token. - Los productos que se pueden leer tienen un tope de profundidad fijo. La última página no trae
next_page_tokenypagination.stop_reasonvaledepth_limit, así que el número de filas devueltas no es el total de productos de la tienda. - A partir de la página 2, los productos salen de una lista guardada que tiene como máximo una hora. Si saltas con
page, las páginas pueden repetir o saltarse algún producto, así que elimina duplicados poritem_id. availableesnullcuando la página no da estado; el motivo por el que un producto concreto está agotado se lee conproduct_price.
Precios
La facturación es por tramos según los productos que devuelve la página: cada tramo cuenta como una llamada de $0.02881. Se devuelven los tramos de las filas que no llegan y una página vacía no se cobra. Saltar a la página N con page se cobra como las páginas anteriores completas más la página N, igual que llegar paginando una a una. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $288.06 |
| 100,000 | $2,880.56 |
| 1,000,000 | $28,805.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": "shop",
"params": {
"shop_id": "1000004259"
}
}'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 shop, 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: Tienda (jd/shop).
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 shop, y los parámetros dentro de params.
- Parámetros obligatorios:
- shop_id: Identifica la tienda de la acción shop. Envía una cadena de dígitos o la URL antigua canónica https://mall.jd.com/index-<dígitos>.html sin query ni fragment.
- Parámetros opcionales:
- page: Número de página de los productos de la tienda, un entero; omítelo o envía 1 para la primera página. Va de 1 a 168 ÷ limit, redondeado hacia arriba: 1–7 con el limit predeterminado 24, 1–3 con limit 60.
- 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: Número máximo de filas que devuelve esta llamada, un entero de 1 a 60. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 24)
- Devuelve una lista de registros. Campos principales de cada registro: item_id (ID numérico del producto en JD), url, title, price, currency, shop_id (ID numérico de la tienda en JD), shop_name (Nombre público de la tienda), shop_url (Página pública de la tienda en JD), image_url (URL de imagen: en search, product_detai…), available (Indica si el artículo se podía comprar…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "jd",
"action": "shop",
"params": {
"shop_id": "1000004259"
}
}
- Precio: $28.81 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í | shop | Identificador de la capacidad, valor fijo. |
shop_id | body.params | string | Sí | - | Identifica la tienda de la acción shop. Envía una cadena de dígitos o la URL antigua canónica https://mall.jd.com/index-<dígitos>.html sin query ni fragment; se rechazan otros hosts y este selector no acepta el item_id de un producto. |
page | body.params | integer | No | - | Número de página de los productos de la tienda, un entero; omítelo o envía 1 para la primera página. Va de 1 a 168 ÷ limit, redondeado hacia arriba: 1–7 con el limit predeterminado 24, 1–3 con limit 60. Con page, el tamaño de página es el limit de esta solicitud (1–60). Cada página se cobra al precio de la página 1, por tramos según las filas de esa página únicamente, una llamada por cada 24 filas: con limit 24, una página es 1 llamada; con limit 60, una página de 60 filas son 3 llamadas y la última página (filas 121–168, 48 filas) son 2. Pedir page N directamente cobra N páginas, igual que paginar desde la página 1 hasta la página N (las N − 1 páginas anteriores como páginas completas, más la propia página N): limit 24 con page 5 son 5 llamadas, y limit 60 con page 3 son 3 + 3 + 2 = 8 llamadas. Los bloques de filas de la página N que no llegaron se reembolsan, y si la página N está vacía (por ejemplo, la lista no es tan larga), la solicitud no se cobra. Un page fuera de rango, 0, negativo, decimal, una cadena como "2" o un booleano se rechaza con 422 antes del cobro. Una llamada síncrona llega hasta la página más profunda, la fila 168; no hace falta "mode": "async". La página más profunda (página 7 con limit 24) no tiene next_page_token y pagination.stop_reason es depth_limit; una lista que simplemente es más corta termina con end_of_list. La página 1 se obtiene de nuevo en cada solicitud. Desde la página 2, las filas se cortan en orden de una única lista completa guardada (hasta 168 filas), y cuando pides por primera vez la página 2 o posteriores esa lista tiene como máximo una hora. Una página pedida con page se corta de esa lista según su posición original (la página N son las limit filas a partir de la fila (N − 1) × limit + 1); no sabe cómo era la página 1 que recibiste antes, así que entre una página 1 obtenida aparte y esta, o entre páginas pedidas antes y después de una hora en punto, pueden repetirse o faltar unos pocos productos: elimina duplicados por item_id al combinarlas. Para leer toda la lista sin repeticiones, empieza en la página 1 y sigue next_page_token. pagination.page es el número de esta página, y si pagination.has_more es true hay una página siguiente: pide page + 1 o devuelve next_page_token como page_token. Si envías page y page_token a la vez, manda page_token. Una página pedida con page también devuelve un next_page_token; la llamada siguiente puede usarlo con o sin page. |
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. Todas las páginas mantienen el tamaño del limit de la solicitud que devolvió el token, y cambiar limit después no tiene efecto. También puedes prescindir del token y pedir un número de página con page; si envías ambos, manda page_token. El token dura 24 horas y solo sirve para la misma tienda y la misma cuenta; con otra tienda se rechaza con 422 y no se cobra. Cada página se cobra al precio de la página 1, por tramos según las filas de esa página únicamente, una llamada por cada 24 filas: con limit 24, cada página es 1 llamada, así que paginar hasta la página 5 son 5 llamadas; con limit 60, una página de 60 filas son 3 llamadas y la última página (filas 121–168, 48 filas) son 2. Los bloques de filas que no llegaron se reembolsan y una página vacía (por ejemplo, más allá del final de una lista corta) no se cobra. La paginación llega hasta la fila 168 (7 páginas con limit 24), y una llamada síncrona llega hasta ahí: no hace falta "mode": "async". La página que contiene la fila 168 no tiene next_page_token y pagination.stop_reason es depth_limit; una lista que simplemente es más corta termina con end_of_list. La página 1 se obtiene de nuevo en cada solicitud. Desde la página 2, las filas se cortan en orden de una única lista completa guardada (hasta 168 filas), y cuando pides por primera vez la página 2 o posteriores esa lista tiene como máximo una hora. Si paginas desde la página 1 con page_token, todas las páginas siguientes se cortan de esa misma lista: los productos que ya se dieron en la página 1 no vuelven a aparecer y no se salta ninguno entre medias, así que no hay repeticiones entre páginas. Paginar despacio no cambia nada: la cadena de tokens sigue usando la lista que tenía cuando llegó por primera vez a la página 2. pagination.page es el número de esta página, y si pagination.has_more es true hay una página siguiente: devuelve next_page_token como page_token. Una página pedida con page también devuelve un next_page_token; la llamada siguiente puede usarlo con o sin page. |
limit | body.params | integer (1–60) | No | 24 | Número máximo de filas que devuelve esta llamada, un entero de 1 a 60. 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": "shop", "results": [ { "item_id": "100386940168", "url": "https://item.jd.com/100386940168.html", "title": "HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表", "price": 2688, "currency": "CNY", "shop_id": "1000004259", "shop_name": "华为京东自营旗舰店", "shop_url": "https://mall.jd.com/index-1000004259.html", "image_url": "https://img14.360buyimg.com/n0/jfs/t1/550965/17/7947/140219/6ae2b424F7cc9d94c/00835a05a09af40b.jpg", "platform": "jd" }, { "item_id": "100343412080", "url": "https://item.jd.com/100343412080.html", "title": "华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘", "price": 7599, "currency": "CNY", "shop_id": "1000004259", "shop_name": "华为京东自营旗舰店", "shop_url": "https://mall.jd.com/index-1000004259.html", "image_url": "https://img14.360buyimg.com/n0/jfs/t1/537470/34/12588/89809/6acef399F2a2483a1/00835a05a01f9084.jpg", "platform": "jd" } ], "next_page_token": …, "pagination": { … }, "count": 24, "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. |
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
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. |
shop_id | ID numérico de la tienda en JD. |
shop_name | Nombre público de la tienda. |
shop_url | Página pública de la tienda en JD. |
image_url | URL de imagen: en search, product_detail, shop y skus es la imagen principal (portada) del producto; en description_images es la imagen de descripción de esa fila (la imagen https a tamaño original en el servidor de imágenes de JD). |
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. |
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 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.
Comprobado el 2026-09-11
Preguntas frecuentes
¿Qué campos devuelve la API de tienda de JD?
Cada fila es un producto: item_id, url, title, price, currency, image_url y available, con el shop_id, el shop_name y la shop_url de la tienda.
¿Cómo se cobra una página de productos de tienda?
Por las filas que devuelve la página, en tramos: cada tramo es una llamada de $0.02881, o $28.81 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. - 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.