API de Taobao
Busca productos de Taobao y consulta fichas, tiendas, reseñas y preguntas públicas. La URL del artículo y el identificador de tienda conducen a objetos separados.
Ventas mostradas, stock, precio y calificación pueden cambiar y no constituyen un inventario verificado. Reseñas y preguntas son colecciones distintas con autores y respuestas propias.
Disponibilidad de la plataforma
- Salud 24 h
- 85 %
Últimos 30 días
Funciones disponibles
Cada acción de Taobao, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar productos en Taobaosearch | Busca productos de Taobao mediante keyword, con precio, orden y opción tmall_only. | $1.39 por 1.000 solicitudes | Limitada · salud 66 % |
Consultar una ficha de productoproduct_detail | Abre la url de un producto y recoge marca, precios, stock mostrado, ventas y categoría. | $1.39 por 1.000 solicitudes | Disponible · salud 86 % |
Listar artículos de una tiendashop | Consulta artículos de una tienda mediante shop, con alias compatibles y filtros de precio u orden. | $1.39 por 1.000 solicitudes | No disponible temporalmente |
Leer reseñas de un productoreviews | Lee reseñas de la url del producto y devuelve variante, compra mostrada, utilidad e imágenes cuando existen. | $1.39 por 1.000 solicitudes | Normal |
Consultar preguntas y respuestasquestions | Obtiene preguntas y respuestas públicas de la url del producto. | $1.39 por 1.000 solicitudes | No disponible temporalmente |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Taobao?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar productos en Taobao Busca productos de Taobao mediante | keyword | max_price, min_price, sort, tmall_only | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 20 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · shop_id · sold_text · original_price · coupon_price · discount_type · is_tmall · brand · category_id · seller_credit_level · seller_positive_rate · shop_score_description · shop_score_service · shop_score_delivery · subtitle · search_rank · free_shipping · selling_points · review_tags · platform |
product_detailConsultar una ficha de producto Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · title · brand · price · original_price · currency · stock · sold_count · category_id · location · is_tmall · shop_name · shop_id · shipping_fee · ems_fee · express_fee · skus · sku_count · spec_values · props_images · attributes · main_image_url · description_images · description_html · video_url · coupon_price · price_usd · total_price · suggestive_price · has_discount · is_promotion · promo_type · is_virtual · brand_id · root_category_id · category_path · weight · size · favorite_count · fans_count · min_order_quantity · shipping_to · listed_at · modified_at · delist_at · images · category_name · description · keywords · titleOriginal · has_cn_title · shop_score_description · shop_score_service · shop_score_delivery · free_shipping · promotion_price · discount_price · discount_type · price_note · has_price_range · payment_methods · seller_id · seller_credit_level · seller_type · seller_type_label · selling_points · shop_logo_url · shop_url · shop_item_count · shop_new_item_count · shop_opened_at · review_tags · review_count · positive_rate · seven_day_return · platform |
shopListar artículos de una tienda Consulta artículos de una tienda mediante | shop | seller, sort, user_id | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · price · currency · category_id · sold_count_30d · comment_count · free_shipping · shop_name · shop_id · seller_id · rating · rating_scale · image_url · platform |
reviewsLeer reseñas de un producto Lee reseñas de la | url | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · author_avatar_url · images · review_append · platform · seller_reply |
questionsConsultar preguntas y respuestas Obtiene preguntas y respuestas públicas de la | url | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · text · answer_count · posted_at · answers · platform |
¿Qué significan los parámetros de Taobao search?
Busca productos de Taobao mediante keyword, con precio, orden y opción tmall_only. Devuelve tienda, precio, ventas mostradas y rating; no confirma stock, autenticidad ni entrega.
keywordObligatorio- Palabra clave de producto de Taobao o Tmall para
search. No es una consulta exacta por nombre de tienda. max_priceOpcional- 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). min_priceOpcional- 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,reviewsniquestions. sortOpcional- Para buscar productos, usa
relevance(predeterminado),popularoprice_desc. Las búsquedas predeterminadas o por relevancia admiten hasta 20 resultados;popularyprice_desc, hasta 10. Los límites superiores se rechazan antes del cobro yprice_ascno está disponible.reviewsyquestionsno aceptansort, yshopno expone este parámetro.Valores permitidos:popularprice_descrelevance tmall_onlyOpcional- En la búsqueda de productos, el booleano
truelimita los resultados a Tmall y permite como máximo 10. Envía únicamente un booleano JSON, no strings como"false"; los límites superiores se rechazan antes del cobro.
¿Qué significan los parámetros de Taobao product_detail?
Abre la url de un producto y recoge marca, precios, stock mostrado, ventas y categoría. No realiza la compra ni promete que todas las variantes estén disponibles.
urlObligatorio- Para
product_detail,reviewsoquestions, envía el ID numérico del producto, una URL de producto de Taobao/Tmall o un texto compartido con una sola URL de producto. Los enlaces dee.tb.cnym.tb.cnsolo se aceptan si pueden resolverse de forma segura a una ficha. Se rechazan los códigos TaoPassword sin URL, los enlaces caducados y las páginas que no sean de productos.Taobao: ID de producto y SKU — Taobao explica que el ID del producto aparece tras `id=` en el enlace y que un SKU representa una combinación concreta, como color y talla. Ambos identificadores no deben confundirse ni usarse como prueba de inventario actual. · Consultada
¿Qué significan los parámetros de Taobao shop?
Consulta artículos de una tienda mediante shop, con alias compatibles y filtros de precio u orden. Conserva categoría y valoración por ficha; no expone pedidos o finanzas privadas.
shopObligatorio- ID de usuario (
userId) numérico del vendedor para la acciónshop. Devuelve los productos en venta de ese vendedor. No es el nombre ni el dominio de la tienda. sellerOpcional- Entrada de compatibilidad para el
userIddel vendedor. No es el apodo del vendedor. Tiene menor prioridad queshopyuser_id. sortOpcional- Para buscar productos, usa
relevance(predeterminado),popularoprice_desc. Las búsquedas predeterminadas o por relevancia admiten hasta 20 resultados;popularyprice_desc, hasta 10. Los límites superiores se rechazan antes del cobro yprice_ascno está disponible.reviewsyquestionsno aceptansort, yshopno expone este parámetro.Valores permitidos:best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales user_idOpcional- Entrada de compatibilidad para el
userIdnumérico del vendedor. Tiene menor prioridad queshop. No es el ID del producto.
¿Qué significan los parámetros de Taobao reviews?
Lee reseñas de la url del producto y devuelve variante, compra mostrada, utilidad e imágenes cuando existen. No responde ni garantiza todas las opiniones.
urlObligatorio- Para
product_detail,reviewsoquestions, envía el ID numérico del producto, una URL de producto de Taobao/Tmall o un texto compartido con una sola URL de producto. Los enlaces dee.tb.cnym.tb.cnsolo se aceptan si pueden resolverse de forma segura a una ficha. Se rechazan los códigos TaoPassword sin URL, los enlaces caducados y las páginas que no sean de productos.Taobao: ID de producto y SKU — Taobao explica que el ID del producto aparece tras `id=` en el enlace y que un SKU representa una combinación concreta, como color y talla. Ambos identificadores no deben confundirse ni usarse como prueba de inventario actual. · Consultada
¿Qué significan los parámetros de Taobao questions?
Obtiene preguntas y respuestas públicas de la url del producto. answer_count y el array disponible pueden diferir; no formula preguntas ni asegura que cada respuesta proceda del vendedor.
urlObligatorio- Para
product_detail,reviewsoquestions, envía el ID numérico del producto, una URL de producto de Taobao/Tmall o un texto compartido con una sola URL de producto. Los enlaces dee.tb.cnym.tb.cnsolo se aceptan si pueden resolverse de forma segura a una ficha. Se rechazan los códigos TaoPassword sin URL, los enlaces caducados y las páginas que no sean de productos.Taobao: ID de producto y SKU — Taobao explica que el ID del producto aparece tras `id=` en el enlace y que un SKU representa una combinación concreta, como color y talla. Ambos identificadores no deben confundirse ni usarse como prueba de inventario actual. · Consultada
Cómo usar la API de Taobao
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"taobao","action":"search","params":{"keyword":"<keyword>"}}'
Guías de Taobao
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Cómo comercializar el rastreo de precios: crea un producto de supervisión que los comerciantes deseen renovar
Analiza por qué los comerciantes pagan por el seguimiento de precios y por qué cancelan la suscripción. A partir de la coincidencia de productos, las listas de excepciones operativas y la aprobación de cambios, examina las formas de entrega, las unidades de cobro y la validación de pilotos para datos de precios.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Fallos de API, devolución de cargos y conciliación: cómo verificar el cargo neto de una solicitud
Separa las tareas de negocio, los intentos de llamada, los estados de entrega y los eventos de la cartera para explicar los rechazos previos al cargo, los resultados vacíos y las devoluciones parciales de cargos sin restar dos veces una misma devolución, y verifica una única solicitud con ejemplos enteros sin conexión.
Leer el artículo →Preguntas sobre la API de Taobao
¿Cómo llamo a la API de Taobao?
Envía POST /api/v1/social con platform igual a taobao, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Taobao?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, price, currency y sold_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Taobao?
Taobao explica que el ID del producto aparece tras id= en el enlace y que un SKU representa una combinación concreta, como color y talla. Ambos identificadores no deben confundirse ni usarse como prueba de inventario actual.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; product_detail requiere url; shop requiere shop; consulta las demás acciones en la lista de funciones.
¿Las acciones de Taobao responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.