API de Búsqueda de JD.com

Busca productos de JD.com por keyword y obtén item_id, title, price, currency, shop_name, is_jd_self, sold_count y good_rate de cada uno, con facturación por tramos según las filas devueltas, $0.002472 por tramo.

JD.com Búsqueda localiza productos de JD a partir de un término en keyword y devuelve de cada uno el item_id, el título y el título corto, el precio, las ventas y las reseñas tal como las muestra el listado, el porcentaje de valoraciones positivas, la tienda, si lo vende JD directamente, la etiqueta de promoción, los puntos de venta y la ruta de categorías. Responde a qué productos aparecen primero para una búsqueda en JD y quién los vende: sirve para un primer sondeo de precios, para decidir qué fichas seguir y para comparar la venta directa de JD con las tiendas de terceros.

Cada llamada devuelve como mucho cinco productos y no tiene paginación; para cubrir más terreno, lanza varias búsquedas con términos más concretos. sold_count y review_count son el texto que muestra el listado, a menudo una cifra redondeada, y no un recuento exacto, así que no los sumes como números. El item_id de cada fila pasa tal cual a JD.com Detalles del producto, JD.com Reseñas o JD.com Precio del producto.

  • Pagina con page o page_token y fija el tamaño de página con limit.
  • promotion y sell_point traen la etiqueta de promoción y el punto de venta del listado.
  • Las llamadas fallidas y los resultados vacíos no se cobran.

Salud de la API

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

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "jd",
      "action": "search",
      "params": {
        "keyword": "华为手机"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "item_id": "10237497167004",
          "title": "华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】",
          "price": 1999,
          "currency": "CNY"
        },
        …
      ],
      "count": 5
    }
  3. 3Filas

    item_idtitlepricecurrency
    10237497167004华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】1999CNY
    10230554159591华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器)2837CNY
  4. 4CSV

    jd-search-sample.csv item_id,url,title,short_title,price,currency,sold_count,review_count,good_rate,shop_id,shop_name,shop_url,is_jd_self,promotion,sell_point,category_ids,image_url,platform

Entra una solicitud con keyword y sale una página de productos; 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 华为手机, obtenida el 24 de octubre de 2026, 18:28 (UTC), que devolvió 5 filas. En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.

item_idurltitleshort_titlepricecurrencysold_countreview_countgood_rateshop_idshop_nameshop_urlis_jd_selfpromotionsell_pointcategory_idsimage_urlplatform
10237497167004https://item.jd.com/10237497167004.html华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】null1999CNYnullnullnull219104371迪旺手机专营店https://mall.jd.com/index-219104371.htmlnullnullnull["9987","653","655"]https://img14.360buyimg.com/n0/jfs/t1/547105/14/3627/77818/6ad1919eFd3fb2338/0083320320125c52.pngjd
10230554159591https://item.jd.com/10230554159591.html华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器)null2837CNYnullnullnull169276555尊享数码手机拼购店https://mall.jd.com/index-169276555.htmlnullnullnull["9987","653","655"]https://img14.360buyimg.com/n0/jfs/t1/483100/15/10357/93091/6a647f40Ff1f84472/008332032085260d.jpgjd

Casos de uso

  • Primer sondeo de productos

    Busca una palabra de categoría, lee price para ver el rango de precios y shop_name para saber quién vende.

  • Vigilar los resultados de una marca

    Lee el mismo keyword cada cierto tiempo y compara la posición de cada item_id y las etiquetas de promotion.

  • Comparar reputación

    Lee good_rate junto a review_count, elige productos bien valorados y con muchas reseñas, y luego lee sus reseñas con reviews.

  • Recopilar cómo se redactan los puntos de venta

    sell_point es el punto de venta público del listado; léelo en varios productos de la competencia para ver cómo lo redactan.

Centro de ayuda de JD y JD Union (Zeus, JOS) frente a EveryInfra

Así se comparan las reglas de reseñas del Centro de ayuda de JD, JD Union y search de EveryInfra en la tasa de reseñas positivas y en qué hace falta para conectar.

AspectoCentro de ayuda de JD y JD Union (Zeus, JOS)EveryInfra
Tasa de reseñas positivasDefinición de reseña positiva: una reseña de 4 o 5 estrellas enviada por un usuario cuenta como positiva y entra en el cálculo del número de reseñas positivas y de la tasa de reseñas positivas.good_rate es el porcentaje de valoraciones positivas que publica JD; review_count es el número de reseñas tal como lo escribe el listado, que puede estar redondeado.
Acceso necesarioUn appkey creado en JD Union puede llamar a la API en la plataforma Union y también puede llamar a las interfaces de Union en la plataforma Zeus.Una clave de API de EveryInfra en la cabecera Authorization: Bearer. No necesitas cuenta de Union ni appkey, ni iniciar sesión en JD.

La documentación de JD está en chino. La tabla muestra una traducción, cotejada con las reglas de reseñas del Centro de ayuda de JD y la página de JD Union (jos.jd.com/jdunion) el 2026-11-22; las páginas no indican fecha de actualización. Las interfaces de Union son para promotores que leen productos promocionados, así que la tabla compara solo la tasa de reseñas positivas y el acceso. Fuentes oficiales: Reglas de reseñas y fotos (Centro de ayuda de JD) · JD Union

Límites y detalles a tener en cuenta

  • keyword es obligatorio; las palabras clave en chino suelen coincidir mejor con los títulos de producto de JD.
  • limit tiene un máximo de 30. Para paginar usa page (un entero; sin él, obtienes la página 1) o devuelve el next_page_token de la respuesta tal cual como page_token. Si envías los dos, manda page_token.
  • La paginación tiene un tope de profundidad fijo. En la última página alcanzable, pagination.stop_reason vale depth_limit; si la lista es simplemente corta, vale end_of_list.
  • 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. Para leer toda la lista sin repeticiones, empieza en la página 1 y sigue next_page_token.
  • sold_count y review_count son texto tal como lo muestra el listado (por ejemplo 100.000+), así que pueden estar redondeados, y sold_count puede faltar.
  • price es una instantánea del 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.

Precios

La facturación es por tramos según los productos que devuelve la página: cada tramo cuenta como una llamada de $0.002472. Se devuelve el tramo 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$24.72
100,000$247.22
1,000,000$2,472.22

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": "search",
  "params": {
    "keyword": "华为手机"
  }
}'

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 search, 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: Búsqueda (jd/search).

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 search, y los parámetros dentro de params.
- Parámetros obligatorios:
  - keyword: Texto de búsqueda de productos para la acción search de JD.com. No es un ID de artículo ni un selector de tienda, y los resultados coincidentes no representan necesariamente todo el catálogo.
- Parámetros opcionales:
  - page: Número de página de los resultados, un entero; omítelo o envía 1 para la primera página. Va de 1 a 150 ÷ limit, redondeado hacia arriba: 1–5 con limit 30, 1–30 con el limit predeterminado 5, 1–15 con limit 10.
  - 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 30. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 5)
- Devuelve una lista de registros. Campos principales de cada registro: item_id (ID numérico del producto en JD), url, title, short_title (Título corto del producto tal como lo d…), price, currency, sold_count (Cifra de ventas tal como aparece en la…), review_count (Número de reseñas tal como aparece en l…), good_rate (Porcentaje público de valoraciones posi…), 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); 17 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=jd.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "jd",
  "action": "search",
  "params": {
    "keyword": "华为手机"
  }
}
- Precio: $2.47 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ísearchIdentificador de la capacidad, valor fijo.
keywordbody.paramsstringSí-Texto de búsqueda de productos para la acción search de JD.com. No es un ID de artículo ni un selector de tienda, y los resultados coincidentes no representan necesariamente todo el catálogo.
pagebody.paramsintegerNo-Número de página de los resultados, un entero; omítelo o envía 1 para la primera página. Va de 1 a 150 ÷ limit, redondeado hacia arriba: 1–5 con limit 30, 1–30 con el limit predeterminado 5, 1–15 con limit 10. Con page, el tamaño de página es el limit de esta solicitud (1–30). 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 5 filas: con limit 30, una página de 30 filas son 6 llamadas; con limit 5, una página es 1 llamada. 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 30 con page 5 son 30 llamadas en una sola solicitud. 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 150; no hace falta "mode": "async". La página más profunda (página 5 con limit 30) 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 150 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 los mismos parámetros y la misma cuenta; con otros parámetros 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 5 filas: con limit 30, una página de 30 filas son 6 llamadas, así que paginar hasta la página 5 son 5 páginas y 30 llamadas; con limit 5, cada página es 1 llamada. 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 150 (5 páginas con limit 30), y una llamada síncrona llega hasta ahí: no hace falta "mode": "async". La página que contiene la fila 150 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 150 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–30)No5Número máximo de filas que devuelve esta llamada, un entero de 1 a 30. 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 24 de octubre de 2026, 18:28 (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": "search",  "results": [    {      "item_id": "10237497167004",      "url": "https://item.jd.com/10237497167004.html",      "title": "华为手机2026热销新机上市畅享 90 Plus 麒麟8系芯片丝滑超好用鸿蒙AI防诈6620mAh巨鲸大电池柔光护眼 星空黑【128GB】 官方标配【365天延保+蓝牙耳机+运费险】",      "price": 1999,      "currency": "CNY",      "shop_id": "219104371",      "shop_name": "迪旺手机专营店",      "shop_url": "https://mall.jd.com/index-219104371.html",      "category_ids": [        "9987",        "653",        "655"      ],      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/547105/14/3627/77818/6ad1919eFd3fb2338/0083320320125c52.png",      "platform": "jd"    },    {      "item_id": "10230554159591",      "url": "https://item.jd.com/10230554159591.html",      "title": "华为mate60pro手机智能手机鸿蒙智能AI手机麒麟芯片正品国行mate60赠手机壳 Mate60Pro【雅川青】 12GB+256GB 7天试用(送手机壳88W充电器)",      "price": 2837,      "currency": "CNY",      "shop_id": "169276555",      "shop_name": "尊享数码手机拼购店",      "shop_url": "https://mall.jd.com/index-169276555.html",      "category_ids": [        "9987",        "653",        "655"      ],      "image_url": "https://img14.360buyimg.com/n0/jfs/t1/483100/15/10357/93091/6a647f40Ff1f84472/008332032085260d.jpg",      "platform": "jd"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 5,  "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).
short_titleTítulo corto del producto tal como lo devuelve JD.
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.
sold_countCifra de ventas tal como aparece en la búsqueda (search): texto como 100 000+, no un número exacto de unidades.
review_countNúmero de reseñas tal como aparece en la búsqueda (search): texto que puede estar redondeado, no un recuento exacto.
good_ratePorcentaje público de valoraciones positivas que muestra JD.
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.
is_jd_selfSi es un producto de operación propia de JD (JD.com retail).
promotionEtiqueta promocional de la lista de productos.
sell_pointPuntos de venta públicos de la lista de productos.
category_idsRuta de IDs de categoría de 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).
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 JOS y JD Union: objetos de producto y SKU ↗

    Los materiales de la plataforma abierta y del programa de afiliación autorizados de JD.com describen objetos de producto y SKU, como nombre, imagen principal, categoría, precio mostrado, logística, estado de venta directa y señales de volumen de pedidos. Esta terminología no demuestra que estén disponibles todas las páginas o campos, que el solicitante tenga acceso ni que EveryInfra implemente la interfaz oficial.

    Comprobado el 2026-09-11

Preguntas frecuentes

¿Cuántos resultados devuelve una búsqueda y cómo consigo más?

Hasta cinco por llamada, que es también el valor por defecto; limit admite de 1 a 5 y un valor mayor se rechaza antes de ejecutar la búsqueda. No hay page_token ni segunda página. Para reunir más productos de una categoría, divide la búsqueda en variantes más precisas, como marca más modelo o tipo de producto más atributo, y elimina los duplicados por item_id.

¿Cómo leo sold_count, review_count y good_rate?

sold_count y review_count llegan como el texto del listado de JD, que suele redondear las cifras grandes, así que sirven para ordenar a grandes rasgos y no para cálculos exactos. good_rate es el porcentaje público de valoraciones positivas; léelo junto a review_count, porque con pocas reseñas el porcentaje oscila mucho. Para leer las reseñas en sí, pasa el item_id a JD.com Reseñas.

¿Cómo distingo la venta directa de JD de las tiendas de terceros?

Mira is_jd_self: en true, el producto lo vende JD directamente. La tienda de cada fila está en shop_name, con su shop_id y su página pública en shop_url. Al comparar precios y valoraciones, analiza cada grupo por separado en lugar de mezclarlos. Si necesitas todas las variantes de un producto con su precio, usa JD.com Todos los SKU con precio con el mismo item_id.

¿Qué campos devuelve la API de búsqueda de JD?

item_id, url, title, short_title, price, currency, sold_count, review_count, good_rate, shop_id, shop_name, shop_url, is_jd_self, promotion, sell_point, category_ids e image_url.

¿Debo convertir item_id y shop_id a números?

No. item_id, shop_id y cada elemento de category_ids son cadenas de texto; guárdalos como cadenas.

¿Cómo se cobra una página de búsqueda?

Por las filas que devuelve la página, en tramos: cada tramo es una llamada de $0.002472, o $2.47 por 1000 llamadas. Se devuelven los tramos de las filas que no llegan y una página vacía no se cobra. 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