API de Búsqueda de Taobao

POST

Salud de la API

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

Últimas 24 horas

Últimos 30 días

Busca productos de Taobao mediante keyword, con precio, orden y opción tmall_only. Devuelve precio y origen del envío, y tienda, ventas mostradas y rating cuando están disponibles. La búsqueda por palabra clave sin filtros es la más estable y admite page, con 20 resultados por página, aunque la mayoría de sus filas no traen ventas ni tienda; con rango de precios, orden u opción tmall_only no hay paginación. No confirma stock, autenticidad ni entrega.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a taobao y action igual a search. Precio $13.5 por 1.000 solicitudes ($0.0135 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Taobao Búsqueda encuentra productos de Taobao y Tmall a partir de keyword y devuelve de cada uno el título, el precio y la moneda, las unidades vendidas, la valoración, la ubicación que indica la ficha, el nombre de la tienda, la imagen principal y el stock. Responde a qué se vende en una categoría y a qué precio, y lo usan equipos de producto, de compras y de estudios de mercado para investigar artículos, seguir los precios de la competencia o analizar una categoría.

Lee price como un número sin símbolo, con la moneda en currency, y antes de comparar rating con otras plataformas mira rating_scale en la misma fila, porque el máximo cambia de un sitio a otro. location llega tal como la muestra la plataforma, sin normalizar, y sold_count refleja las ventas que muestra la ficha.

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Taobao: Búsqueda (taobao/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 taobao y action en search, y los parámetros dentro de params.
- Parámetros obligatorios:
  - keyword: Palabra clave de producto de Taobao o Tmall para search. No es una consulta exacta por nombre de tienda.
- Parámetros opcionales:
  - max_price: Importe máximo para la búsqueda de productos. Se usa junto con min_price. No debe interpretarse como un límite de existencias (SKU). Los decimales pueden redondearse hacia arriba a un número entero.
  - min_price: Importe mínimo para la búsqueda de productos. No se refiere a la puntuación de las valoraciones ni al coste de esta API. No se aplica a shop, product_detail, reviews ni questions.
  - page: Número de página de la búsqueda de productos, de 1 a 50, con 20 resultados por página. Si no lo envías, recibes la página 1; cada página se cobra como una llamada.
  - sort: Para buscar productos, usa relevance (predeterminado), popular o price_desc. Las búsquedas predeterminadas o por relevancia admiten hasta 20 resultados; popular y price_desc, hasta 10 y sin paginación. (valores admitidos: popular / price_desc / relevance)
  - tmall_only: En la búsqueda de productos, el booleano true limita los resultados a Tmall y permite como máximo 10, sin paginación. Envía únicamente un booleano JSON, no strings como "false".
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 20. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: id, url, title, price (Precio como número, sin símbolo de mone…), currency, price_basis (Cómo se obtuvo price (solo aparece cuan…), sold_count (Unidades vendidas), rating, rating_scale, location (Lugar desde el que se envía), shop_name (Nombre de la tienda), image_url; 42 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "taobao",
  "action": "search",
  "params": {
    "keyword": "便携咖啡秤"
  }
}
- Precio: $13.5 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ítaobaoIdentificador de la plataforma, valor fijo.
actionbodystringSísearchIdentificador de la capacidad, valor fijo.
keywordbody.paramsstringSí-Palabra clave de producto de Taobao o Tmall para search. No es una consulta exacta por nombre de tienda.
max_pricebody.paramsnumberNo-Importe máximo para la búsqueda de productos. Se usa junto con min_price. No debe interpretarse como un límite de existencias (SKU). Los decimales pueden redondearse hacia arriba a un número entero. Las búsquedas con rango de precios no admiten paginación.
min_pricebody.paramsnumberNo-Importe mínimo para la búsqueda de productos. No se refiere a la puntuación de las valoraciones ni al coste de esta API. No se aplica a shop, product_detail, reviews ni questions. Los decimales pueden redondearse hacia abajo a un número entero. Las búsquedas con rango de precios no admiten paginación.
pagebody.paramsintegerNo-Número de página de la búsqueda de productos, de 1 a 50, con 20 resultados por página. Si no lo envías, recibes la página 1; cada página se cobra como una llamada. Solo las búsquedas por palabra clave sin filtros admiten paginación (sin min_price, max_price ni tmall_only, y con sort omitido o en relevance). Son la forma más estable de buscar, aunque la mayoría de las filas no incluyen ventas ni nombre de tienda. Una página mayor que 1 combinada con cualquiera de esos filtros se rechaza antes del cobro: quita esos filtros para paginar. limit solo indica cuántos resultados de esa página recibes, así que mantenlo en 20 al paginar. El orden se actualiza en tiempo real, por lo que dos páginas seguidas pueden repetir algún producto; elimina duplicados por id al combinarlas.
sortbody.paramsstring (enum)No-Para buscar productos, usa relevance (predeterminado), popular o price_desc. Las búsquedas predeterminadas o por relevancia admiten hasta 20 resultados; popular y price_desc, hasta 10 y sin paginación. Los límites superiores se rechazan antes del cobro y price_asc no está disponible. reviews y questions no aceptan sort. En shop, sort solo se aplica al paginar con page; consulta los parámetros de shop.Valores permitidospopularprice_descrelevance
tmall_onlybody.paramsbooleanNo-En la búsqueda de productos, el booleano true limita los resultados a Tmall y permite como máximo 10, sin paginación. Envía únicamente un booleano JSON, no strings como "false"; los límites superiores se rechazan antes del cobro.
limitbody.paramsinteger (1–20)No20Número máximo de filas que devuelve esta llamada, un entero de 1 a 20. 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.

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": "taobao",
  "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.

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": "taobao",  "action": "search",  "results": [    {      "id": "•••",      "url": "https://item.taobao.com/item.htm?id=1036557039587",      "title": "手冲电子称豆盘咖啡称重展示盘咖啡豆粉秤豆碟茶叶茶则茶器便携",      "price": 59.8,      "currency": "CNY",      "location": "浙江 杭州",      "shop_name": "好货严选工厂",      "image_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i2/2206584264218/O1CN01sCMEZhb10YE1chua_!!2206584264218-0-C2M.jpg",      "stock": 438,      "shop_id": "2206584264218",      "sold_text": "1000+",      "original_price": 59.8,      "discount_type": "特价秒杀",      "seller_credit_level": 20,      "seller_positive_rate": 100,      "shop_score_description": 4.74,      "shop_score_service": 4.8,      "shop_score_delivery": 4.82,      "subtitle": "",      "search_rank": 1,      "images": [        "https://img.alicdn.com/imgextra/i4/3937219703/O1CN01VRbcrW2LY2B5R9Jq9_!!3937219703-0-C2M.jpg",        "https://img.alicdn.com/imgextra/i3/3937219703/O1CN01Bs0puN2LY2B58j8Nm_!!3937219703-0-C2M.jpg",        "https://img.alicdn.com/imgextra/i4/3937219703/O1CN010vTDpb2LY2B5NXjqG_!!3937219703-0-C2M.jpg"      ],      "discount_rate": 100,      "spu_id": "8995243647",      "platform": "taobao"    },    {      "id": "•••",      "url": "https://item.taobao.com/item.htm?id=803310769271",      "title": "Bincoo咖啡电子秤意式专用咖啡豆称重智能手冲迷你便携秤咖啡器具",      "price": 88,      "currency": "CNY",      "shop_name": "bincoo旗舰店",      "image_url": "https://g.search1.alicdn.com/img/bao/uploaded/i4/i3/4249388314/O1CN013agzRw2BHrr0rcgBA_!!0-item_pic.jpg",      "stock": 1267,      "shop_id": "4249388314",      "sold_text": "1000+",      "original_price": 128,      "discount_type": "优惠价",      "seller_credit_level": 16,      "seller_positive_rate": 100,      "shop_score_description": 4.9,      "shop_score_service": 4.92,      "shop_score_delivery": 4.93,      "subtitle": "",      "search_rank": 2,      "images": [        "https://img.alicdn.com/imgextra/i1/4249388314/O1CN01ZKqJQV2BHrqxP8GFJ_!!4249388314.jpg",        "https://img.alicdn.com/imgextra/i2/4249388314/O1CN01tX38az2BHrqz5tjuQ_!!4249388314.jpg",        "https://img.alicdn.com/imgextra/i1/4249388314/O1CN01Jddc8c2BHrqyzT1fk_!!4249388314.jpg"      ],      "discount_rate": 68.75,      "spu_id": "7410827142",      "platform": "taobao"    }  ],  "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.
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; consulta currency. En product_detail, los precios (incluido el price de cada fila de skus) son o bien el precio en CNY que muestra la página de Taobao, o bien un precio en CNY convertido desde dólares estadounidenses, que puede quedar alrededor de un 1–4 % por encima o por debajo del precio de la página; manda el precio de la página. En search, el precio de cada fila puede ser el precio actual de la página, el precio de lista tachado o un precio promocional. price_basis indica de qué tipo es.
currencyCódigo de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda.
price_basisCómo se obtuvo price (solo aparece cuando hay precio). En product_detail: page es el precio en CNY que muestra la página de Taobao; converted es un precio en CNY convertido desde dólares estadounidenses y puede quedar alrededor de un 1–4 % por encima o por debajo del precio de la página de Taobao. En search (uno por fila): page es el precio actual que muestra la página de Taobao; list es el precio de lista tachado, que supera el precio de venta real cuando el producto tiene descuento, a veces el doble; promotion es un precio promocional de afiliados de Taobao y suele quedar muy por debajo del precio de la página. currency es CNY en todos los casos, y distintas llamadas para el mismo producto pueden diferir.
sold_countUnidades vendidas. En product_detail solo lo devuelve una parte de las llamadas, y esa proporción cambia de un día a otro.
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.
locationLugar desde el que se envía. Si el vendedor tiene varios almacenes, distintas llamadas para el mismo producto pueden mostrar lugares de envío diferentes.
shop_nameNombre de la tienda.
image_urlEnlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
stockUnidades en stock. Si el vendedor tiene varios almacenes, distintas llamadas para el mismo producto pueden devolver un stock diferente (y otro lugar de envío). En product_detail, cuando la fuente no da el stock del producto completo, es la suma del stock de los SKU.
shop_idID de la tienda.
sold_textCifra de ventas tal como se muestra (search), por ejemplo 100 000+; las cifras con + o en decenas de miles son redondeos, no ventas exactas.
original_pricePrecio original (tachado). En product_detail viene vacío en la mayoría de las llamadas. En shop es el único precio: el tachado que muestra el listado, no el de venta, y puede ser bastante mayor; para el precio de venta usa product_detail.
coupon_pricePrecio con cupón: más bajo que price cuando hay un cupón; no aparece en caso contrario. En product_detail solo lo devuelve una parte de las llamadas (esa proporción cambia de un día a otro), así que su ausencia no siempre significa que no haya cupón.
discount_typeTipo de descuento o campaña con su texto original (por ejemplo, oferta relámpago).
is_tmallSi la tienda es de Tmall y no una tienda normal de Taobao; las dos tienen requisitos de acceso y garantías para el comprador distintos. En product_detail, algunas fuentes no lo devuelven.
brandMarca.
category_idID de categoría.
seller_credit_levelNivel de crédito del vendedor (número; cuanto mayor, mejor).
seller_positive_ratePorcentaje de valoraciones positivas del vendedor (search): 100 equivale a 100 %.
shop_score_descriptionPuntuación de la tienda por fidelidad a la descripción, en escala de 5.
shop_score_servicePuntuación de la tienda por atención, en escala de 5.
shop_score_deliveryPuntuación de la tienda por envío, en escala de 5.
subtitleSubtítulo del producto (search), una frase corta de venta.
search_rankPosición en este resultado de búsqueda (search), empezando en 1; al paginar sigue contando, así que la página 3 empieza en 41.
free_shippingSi el envío es gratuito.
selling_pointsEtiquetas de puntos de venta.
review_tagsEtiquetas de reseñas, cada una con tag (texto) y count (veces mencionada; puede faltar).
imagesEnlaces de imágenes: fotos del producto en product_detail y fotos del comprador en reviews (no aparece si la reseña no tiene).
discount_rateConserva el significado de la plataforma
spu_idConserva el significado de la plataforma
category_pathRuta de categorías (migas de pan).
review_countNúmero de reseñas, en capacidades de productos y negocios. null significa no publicado, no 0.
latest_reviewConserva el significado de la plataforma
seller_typeCódigo del tipo de vendedor (product_detail).
shop_opened_atFecha de apertura de la tienda con su texto original (product_detail).
shop_age_yearsConserva el significado de la plataforma
shop_item_countProductos a la venta en la tienda (product_detail, search, shop).
shop_score_vs_industryConserva el significado de la plataforma
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Preguntas frecuentes

#

¿Puedo paginar para obtener más resultados?

#

Sí, con page: páginas de la 1 a la 50, con 20 resultados cada una, y cada página se cobra como una llamada; sin page recibes la primera. Solo se pagina en búsquedas por palabra clave sin filtros: sin min_price, max_price ni tmall_only, y con sort omitido o en relevance. Es la forma más estable de buscar, aunque la mayoría de las filas no traen ventas ni nombre de tienda. Con rango de precios o sort=popular puede haber ventas, pero llegan como mucho 10 o 20 resultados y sin paginación, así que un page mayor que 1 se rechaza antes de cobrar. El orden cambia en tiempo real: si dos páginas repiten algún producto, elimina duplicados por id.

¿Qué órdenes admite sort?

#

relevance, el orden predeterminado, popular y price_desc, que muestra primero los productos más caros; de momento no existe un orden de más barato a más caro. Al ordenar por popularidad o por precio, cada llamada devuelve como mucho 10 resultados y no admite paginación; para obtener más, haz una búsqueda por palabra clave sin sort y pagina con page.

¿Puedo buscar solo productos de Tmall?

#

Sí: pon tmall_only en el booleano true; el valor predeterminado es false. Debe ser un booleano real, porque la cadena 'false' se rechaza antes de cobrar nada, y con el filtro activado cada llamada devuelve como mucho 10 resultados.

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

Google Analytics solo si aceptas. Privacidad