API de plataforma de EveryData
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 rating pueden cambiar y no constituyen inventario auditado. Reseñas y preguntas son colecciones distintas con autores y respuestas propias.
- Endpoint
- POST /api/v1/social
- Funciones
- 5
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Taobao por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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 | — | $1.39 por 1.000 solicitudes | id · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · 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 · skus · images · platform · name |
shopListar artículos de una tienda Consulta artículos de una tienda mediante | shop | max_price, min_price, seller, sort, user_id | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · title · price · currency · category · rating · rating_scale · good_rate · image_url · platform |
reviewsLeer reseñas de un producto Lee reseñas de la | url | sort | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · images · platform |
questionsConsultar preguntas y respuestas Obtiene preguntas y respuestas públicas de la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · text · answer_count · posted_at · answers · platform · author_name |
¿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.
¿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 ha confirmado si este filtro se aplica en otras acciones como
shop,product_detail,reviewsoquestions. sortOpcional- Orden de las valoraciones para
reviews:newest(por fecha) orelevance(por relevancia). La acciónshopusa un campo de orden interno diferente; el mapeo actual no lo cubre correctamente, por lo que no debes asumir que estos valores también sirven para ordenar los productos de una tienda.Valores permitidos:newestrelevance tmall_onlyOpcional- Para
search, indica si se buscan solo productos de Tmall. Es un valor booleano (trueofalse), por defectofalse. No envíes el string"false", ya que actualmente se interpreta comotrue.
¿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- Enlace del producto para
product_detail,reviewsoquestions. Debe incluir?id=<número>o&id=<número>. También puedes enviar directamente el ID numérico del producto en el campourl. Los "Tao Passwords" y los enlaces cortos no se pueden analizar directamente.Taobao: ID de producto y SKUTaobao 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. 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 ha confirmado si este filtro se aplica en otras acciones como
shop,product_detail,reviewsoquestions. sellerOpcional- Entrada de compatibilidad para el
userIddel vendedor. No es el apodo del vendedor. Tiene menor prioridad queshopyuser_id. sortOpcional- Orden de las valoraciones para
reviews:newest(por fecha) orelevance(por relevancia). La acciónshopusa un campo de orden interno diferente; el mapeo actual no lo cubre correctamente, por lo que no debes asumir que estos valores también sirven para ordenar los productos de una tienda.Valores permitidos:newestrelevance 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, con orden opcional, y devuelve variante, compra mostrada, utilidad e imágenes cuando existen. No responde ni garantiza todas las opiniones.
urlObligatorio- Enlace del producto para
product_detail,reviewsoquestions. Debe incluir?id=<número>o&id=<número>. También puedes enviar directamente el ID numérico del producto en el campourl. Los "Tao Passwords" y los enlaces cortos no se pueden analizar directamente.Taobao: ID de producto y SKUTaobao 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 sortOpcional- Orden de las valoraciones para
reviews:newest(por fecha) orelevance(por relevancia). La acciónshopusa un campo de orden interno diferente; el mapeo actual no lo cubre correctamente, por lo que no debes asumir que estos valores también sirven para ordenar los productos de una tienda.
¿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- Enlace del producto para
product_detail,reviewsoquestions. Debe incluir?id=<número>o&id=<número>. También puedes enviar directamente el ID numérico del producto en el campourl. Los "Tao Passwords" y los enlaces cortos no se pueden analizar directamente.Taobao: ID de producto y SKUTaobao 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 devuelto si la acción es 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>"}}'
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 de origen contengan 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.