API de Búsqueda de Taobao
Salud de la API
- Salud 24 h
- 99 %
- Tiempo medio 24 h
- 9.47 s
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Ú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
#| 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í | taobao | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | search | Identificador de la capacidad, valor fijo. |
keyword | body.params | string | Sí | - | Palabra clave de producto de Taobao o Tmall para search. No es una consulta exacta por nombre de tienda. |
max_price | body.params | number | No | - | 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_price | body.params | number | No | - | 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. |
page | body.params | integer | No | - | 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. |
sort | body.params | string (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_only | body.params | boolean | No | - | 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. |
limit | body.params | integer (1–20) | No | 20 | 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. Los valores mayores devuelven 422 antes de cualquier cobro. |
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": "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
#{ "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.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
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; 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. |
currency | Código de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda. |
price_basis | Có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_count | Unidades vendidas. En product_detail solo lo devuelve una parte de las llamadas, y esa proporción cambia de un día a otro. |
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. |
location | Lugar 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_name | Nombre de la tienda. |
image_url | Enlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls. |
stock | Unidades 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_id | ID de la tienda. |
sold_text | Cifra 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_price | Precio 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_price | Precio 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_type | Tipo de descuento o campaña con su texto original (por ejemplo, oferta relámpago). |
is_tmall | Si 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. |
brand | Marca. |
category_id | ID de categoría. |
seller_credit_level | Nivel de crédito del vendedor (número; cuanto mayor, mejor). |
seller_positive_rate | Porcentaje de valoraciones positivas del vendedor (search): 100 equivale a 100 %. |
shop_score_description | Puntuación de la tienda por fidelidad a la descripción, en escala de 5. |
shop_score_service | Puntuación de la tienda por atención, en escala de 5. |
shop_score_delivery | Puntuación de la tienda por envío, en escala de 5. |
subtitle | Subtítulo del producto (search), una frase corta de venta. |
search_rank | Posició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_shipping | Si el envío es gratuito. |
selling_points | Etiquetas de puntos de venta. |
review_tags | Etiquetas de reseñas, cada una con tag (texto) y count (veces mencionada; puede faltar). |
images | Enlaces de imágenes: fotos del producto en product_detail y fotos del comprador en reviews (no aparece si la reseña no tiene). |
discount_rate | Conserva el significado de la plataforma |
spu_id | Conserva el significado de la plataforma |
category_path | Ruta de categorías (migas de pan). |
review_count | Número de reseñas, en capacidades de productos y negocios. null significa no publicado, no 0. |
latest_review | Conserva el significado de la plataforma |
seller_type | Código del tipo de vendedor (product_detail). |
shop_opened_at | Fecha de apertura de la tienda con su texto original (product_detail). |
shop_age_years | Conserva el significado de la plataforma |
shop_item_count | Productos a la venta en la tienda (product_detail, search, shop). |
shop_score_vs_industry | Conserva el significado de la plataforma |
platform | Identificador 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.