API de Tienda de Taobao
No disponible temporalmente
Estamos restableciendo esta capacidad. Mientras tanto, las llamadas suelen fallar o no devolver resultados; las llamadas fallidas y los resultados vacíos no se cobran.
Salud de la API
- Salud 24 h
- 24 %
- Tiempo medio 24 h
- 32.25 s
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
Consulta los artículos de una tienda mediante shop, con alias compatibles: hasta 20 por solicitud, o páginas completas de unos 60 con page. Da el precio tachado, la categoría y las puntuaciones de la tienda por ficha, sin ventas ni comentarios; no expone pedidos o finanzas privadas.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a taobao y action igual a shop. Precio $5.56 por 1.000 solicitudes ($0.005556 por llamada). Las llamadas fallidas y la mayoría de los resultados vacíos no se cobran. Algunos sí; consulta las preguntas frecuentes y los parámetros de esta página. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.
Taobao Tienda enumera los productos que un vendedor de Taobao tiene a la venta, a partir de su ID numérico de usuario o del enlace de la tienda en shop. Sin page, cada solicitud devuelve como máximo 20 productos; con page puedes recorrer la tienda, normalmente 60 productos por página, hasta la página 35. Cada fila trae el título, el enlace, el precio tachado y la moneda, el ID de categoría, si el envío es gratuito y la imagen principal, junto con el nombre de la tienda, los identificadores de la tienda y del vendedor, las tres puntuaciones de la tienda y su total de productos. Lo usan equipos de comercio electrónico para ver una muestra del catálogo de un competidor o comprobar qué productos publica un revendedor de una marca.
original_price es el precio tachado que muestra el listado, no el precio de venta, y puede ser bastante mayor; para el precio de venta, pasa el producto a Taobao Detalles del producto. Las filas no incluyen ventas ni número de comentarios. shop_item_count es el total de la tienda; en las tiendas grandes, cada orden llega como máximo a unos 2060 primeros productos.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Taobao: Tienda (taobao/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 taobao y action en shop, y los parámetros dentro de params.
- Parámetros obligatorios:
- shop: ID de usuario (userId) numérico del vendedor o enlace de la tienda (shop<shopId>.taobao.com) para la acción shop. Devuelve productos en venta de ese vendedor.
- Parámetros opcionales:
- page: Número de página de la lista de productos de la tienda, de 1 a 35. Con page recibes páginas completas de la tienda en Taobao: normalmente 60 productos por página y menos en la última, y limit no tiene efecto.
- seller: Entrada de compatibilidad para el userId del vendedor. No es el apodo del vendedor. Tiene menor prioridad que shop y user_id.
- sort: Orden de los productos al paginar con page: popular, best_selling o sales, por ventas (predeterminado); new o newly_listed, por novedad; price_asc o lowest_price, por precio de menor a mayor. (valores admitidos: best_selling / highest_price / lowest_price / new / newly_listed / popular / price_asc / price_desc)
- user_id: Entrada de compatibilidad para el userId numérico del vendedor. Tiene menor prioridad que shop. No es el ID del producto.
- 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. Los valores mayores se aceptan y se ajustan al máximo. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: id, url, title, original_price (Precio original (tachado)), currency, category_id (ID de categoría), free_shipping (Si el envío es gratuito), shop_name (Nombre de la tienda), shop_id (ID de la tienda), seller_id (ID del vendedor (en shop puede faltar), image_url, shop_url (Enlace de la tienda (product_detail, sh…); 17 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- Cuerpo de solicitud de ejemplo:
{
"platform": "taobao",
"action": "shop",
"params": {
"shop": "713464357"
}
}
- Precio: $5.56 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í | shop | Identificador de la capacidad, valor fijo. |
shop | body.params | string | Sí | - | ID de usuario (userId) numérico del vendedor o enlace de la tienda (shop<shopId>.taobao.com) para la acción shop. Devuelve productos en venta de ese vendedor. Sin page, cada solicitud devuelve como máximo 20: con un limit mayor también recibes 20, con el mismo precio por llamada. Con page, recorre la tienda página a página de Taobao, normalmente 60 productos por página. No es el nombre de la tienda. Si repites la consulta de la misma tienda con el mismo sort y la misma page (o el mismo limit si no envías page) en las 12 horas siguientes, recibes los mismos datos que la primera vez, con el cobro habitual. Si la tienda no existe, la respuesta viene vacía, con empty_reason igual a shop_not_found, y se cobra como una llamada; si repites la consulta en las 24 horas siguientes, recibes el mismo resultado, con el mismo cobro. Los demás resultados vacíos no se cobran. |
page | body.params | integer | No | - | Número de página de la lista de productos de la tienda, de 1 a 35. Con page recibes páginas completas de la tienda en Taobao: normalmente 60 productos por página y menos en la última, y limit no tiene efecto. Sin page, la llamada es una consulta única de hasta 20 productos, como hasta ahora. Cada página se cobra como una llamada, al mismo precio; una página posterior a la última devuelve un resultado vacío y no se cobra, así que una página vacía indica que llegaste al final. Taobao muestra como máximo unos 2060 primeros productos por cada orden (página 35), por lo que las tiendas con más productos no se pueden leer completas; con otro sort obtienes otra parte del catálogo. Mantén el mismo sort en todas las páginas. 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. Una página suele tardar entre 10 y 45 segundos, y hasta unos 60 segundos si hay que reintentarla. A veces la página 1 trae como máximo los 20 primeros productos; en ese caso la respuesta incluye partial: true en el nivel superior y se cobra igualmente como una llamada. Mientras ocurra, de la página 2 en adelante se devuelve un 503 que no se cobra; vuelve a intentarlo más tarde para recibir la página completa. |
seller | body.params | string | No | - | Entrada de compatibilidad para el userId del vendedor. No es el apodo del vendedor. Tiene menor prioridad que shop y user_id. |
sort | body.params | string (enum) | No | - | Orden de los productos al paginar con page: popular, best_selling o sales, por ventas (predeterminado); new o newly_listed, por novedad; price_asc o lowest_price, por precio de menor a mayor; price_desc o highest_price, por precio de mayor a menor. Los órdenes por precio siguen el precio de venta, mientras que las filas traen original_price (el precio tachado), así que puede no parecer perfectamente ordenado. Sin page, sort se acepta, pero no se garantiza que tenga efecto.Valores permitidosbest_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales |
user_id | body.params | string | No | - | Entrada de compatibilidad para el userId numérico del vendedor. Tiene menor prioridad que shop. No es el ID del producto. |
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 se aceptan y se ajustan al máximo. |
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": "shop",
"params": {
"shop": "713464357"
}
}'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": "shop", "results": [ { "id": "•••", "url": "https://item.taobao.com/item.htm?id=521031921743", "title": "绿联适用苹果iPhone14/13/12Proxsmax11plus8充电线mfi认证lightning数据线平板iPad手机18/17/16/15/usb车载", "original_price": 24.88, "currency": "CNY", "category_id": "50050366", "free_shipping": false, "shop_name": "绿联数码旗舰店", "shop_id": "67095450", "seller_id": "713464357", "image_url": "https://img.alicdn.com/imgextra/bao/upload/O1CN01pO8nJU1z74sArhuWH_!!6000000006666-2-yinhe.png", "shop_url": "https://shop67095450.taobao.com", "shop_logo_url": "https://img.alicdn.com/imgextra/i2/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg", "shop_score_description": 4.8, "shop_score_service": 4.8, "shop_score_delivery": 4.9, "shop_item_count": 1299, "platform": "taobao" }, { "id": "•••", "url": "https://item.taobao.com/item.htm?id=523147854719", "title": "绿联拓展坞typec扩展USB集线器多接口HDMI网路线转换转接头适用华为苹果macbook雷电4笔记型电脑iPad平板手机18", "original_price": 79, "currency": "CNY", "category_id": "110219", "free_shipping": false, "shop_name": "绿联数码旗舰店", "shop_id": "67095450", "seller_id": "713464357", "image_url": "https://img.alicdn.com/imgextra/i2/713464357/O1CN013mRFCd1i3YRecOBA4_!!2-item_pic.png", "shop_url": "https://shop67095450.taobao.com", "shop_logo_url": "https://img.alicdn.com/imgextra/i2/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg", "shop_score_description": 4.8, "shop_score_service": 4.8, "shop_score_delivery": 4.9, "shop_item_count": 1299, "platform": "taobao" } ], "count": 20, "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). |
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. |
currency | Código de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda. |
category_id | ID de categoría. |
free_shipping | Si el envío es gratuito. |
shop_name | Nombre de la tienda. |
shop_id | ID de la tienda. |
seller_id | ID del vendedor (en shop puede faltar; en product_detail, algunas fuentes no lo devuelven). |
image_url | Enlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls. |
shop_url | Enlace de la tienda (product_detail, shop). |
shop_logo_url | Enlace del logotipo de la tienda (product_detail, shop; en shop puede faltar). |
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. |
shop_item_count | Productos a la venta en la tienda (product_detail, search, shop). |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Preguntas frecuentes
#¿Qué valor va en shop?
#El ID numérico de usuario del vendedor en Taobao, una cadena de dígitos como 713464357, o el enlace de la tienda con la forma shop<shopId>.taobao.com. El nombre de la tienda y los ID de producto no identifican a un vendedor en esta capacidad. user_id y seller son nombres alternativos de la misma entrada; si envías varios, prevalece shop y después user_id. Si la tienda no existe, el resultado viene vacío y se cobra como una llamada.
¿Cuántos productos puedo obtener? ¿Se pueden ordenar o paginar?
#Sin page, como máximo 20 por solicitud: un limit mayor se acepta y también devuelve 20, con el mismo precio por llamada, y sort se acepta, pero no se garantiza que tenga efecto. Con page (de 1 a 35) recibes páginas completas de la tienda en Taobao, normalmente 60 productos cada una; cada página se cobra como una llamada y sort se aplica. Mantén el mismo sort en todas las páginas. Una página vacía indica que llegaste al final y no se cobra. Cada orden llega como máximo a unos 2060 primeros productos, así que en tiendas más grandes otro sort devuelve otra parte del catálogo; elimina duplicados por id al combinar.
¿Cómo consigo el precio de venta y todos los datos de un producto de la lista?
#Pasa el id de la fila, que es el ID numérico del producto, o su url a Taobao Detalles del producto para ver precios, variantes, precios con cupón e imágenes de la descripción, o a Taobao Reseñas para leer las opiniones de los compradores. Ambas capacidades aceptan las dos formas: el ID numérico o el enlace de la página en Taobao o Tmall.
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. Normalmente sin cargo; consulta las preguntas frecuentes y los parámetros.