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.

  • limit tiene un máximo de 60; pagina con page o page_token.
  • item_id pasa tal cual a product_detail, product_price y skus.
  • 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": "shop",
      "params": {
        "shop_id": "1000004259"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "item_id": "100386940168",
          "title": "HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表",
          "price": 2688,
          "currency": "CNY"
        },
        …
      ],
      "count": 24
    }
  3. 3Filas

    item_idtitlepricecurrency
    100386940168HUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表2688CNY
    100343412080华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘7599CNY
  4. 4CSV

    jd-shop-sample.csv item_id,url,title,price,currency,shop_id,shop_name,shop_url,image_url,available,platform

Entra una solicitud con 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_idurltitlepricecurrencyshop_idshop_nameshop_urlimage_urlavailableplatform
100386940168https://item.jd.com/100386940168.htmlHUAWEIWATCH GT7Pro碳晶黑46mm钛合金&纳米微晶陶瓷户外进阶运动21天超长续航华为智能手表2688CNY1000004259华为京东自营旗舰店https://mall.jd.com/index-1000004259.htmlhttps://img14.360buyimg.com/n0/jfs/t1/550965/17/7947/140219/6ae2b424F7cc9d94c/00835a05a09af40b.jpgnulljd
100343412080https://item.jd.com/100343412080.html华为MateBook 14 鸿蒙版笔记本电脑 国家补贴 2.8K OLED触控屏 鸿蒙AI 24GB 1TB原野绿 圆键盘7599CNY1000004259华为京东自营旗舰店https://mall.jd.com/index-1000004259.htmlhttps://img14.360buyimg.com/n0/jfs/t1/537470/34/12588/89809/6acef399F2a2483a1/00835a05a01f9084.jpgnulljd

Casos de uso

  • Vigilar los precios de un competidor

    Lee la misma tienda cada cierto tiempo y compara price por item_id.

  • Armar el catálogo de una tienda

    Guarda item_id, title e image_url como 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 title y price coinciden con lo acordado.

  • Ver el rango de precios de una tienda

    Usa los valores de price de las filas que leas para ver cómo se reparten los precios de la tienda.

Límites y detalles a tener en cuenta

  • shop_id es 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_token tal cual como page_token, o saltar a la página N con page. Si envías los dos, manda page_token.
  • Los productos que se pueden leer tienen un tope de profundidad fijo. La última página no trae next_page_token y pagination.stop_reason vale depth_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 por item_id.
  • available es null cuando la página no da estado; el motivo por el que un producto concreto está agotado se lee con product_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.

LlamadasCosto
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

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

POST

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

#
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íshopIdentificador de la capacidad, valor fijo.
shop_idbody.paramsstringSí-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.
pagebody.paramsintegerNo-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_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. 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.
limitbody.paramsinteger (1–60)No24Nú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

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

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.
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
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.
shop_idID numérico de la tienda en JD.
shop_nameNombre público de la tienda.
shop_urlPágina pública de la tienda en JD.
image_urlURL 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).
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.
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 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.

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

Google Analytics solo si aceptas. Privacidad