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ónObligatoriosOpcionalesEntregaLímitePor 1.000Campos de respuesta
search

Buscar productos en Taobao

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.

keywordmax_price, min_price, sort, tmall_onlyEntrega síncrona$1.39 por 1.000 solicitudesid · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · platform
product_detail

Consultar una ficha de producto

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.

urlEntrega síncrona$1.39 por 1.000 solicitudesid · 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
shop

Listar artículos de una tienda

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.

shopmax_price, min_price, seller, sort, user_idEntrega síncrona$1.39 por 1.000 solicitudesid · url · title · price · currency · category · rating · rating_scale · good_rate · image_url · platform
reviews

Leer reseñas de un producto

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.

urlsortEntrega síncrona$1.39 por 1.000 solicitudesid · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · images · platform
questions

Consultar preguntas y respuestas

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.

urlEntrega síncrona$1.39 por 1.000 solicitudesid · 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, reviews o questions.
sortOpcional
Orden de las valoraciones para reviews: newest (por fecha) o relevance (por relevancia). La acción shop usa 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 (true o false), por defecto false. No envíes el string "false", ya que actualmente se interpreta como true.

¿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, reviews o questions. Debe incluir ?id=<número> o &id=<número>. También puedes enviar directamente el ID numérico del producto en el campo url. 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ón shop. 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, reviews o questions.
sellerOpcional
Entrada de compatibilidad para el userId del vendedor. No es el apodo del vendedor. Tiene menor prioridad que shop y user_id.
sortOpcional
Orden de las valoraciones para reviews: newest (por fecha) o relevance (por relevancia). La acción shop usa 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 userId numérico del vendedor. Tiene menor prioridad que shop. 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, reviews o questions. Debe incluir ?id=<número> o &id=<número>. También puedes enviar directamente el ID numérico del producto en el campo url. 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) o relevance (por relevancia). La acción shop usa 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, reviews o questions. Debe incluir ?id=<número> o &id=<número>. También puedes enviar directamente el ID numérico del producto en el campo url. 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

  1. 01Consulta el catálogo público y elige una acción de la plataforma.
  2. 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
  3. 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
  4. 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
taobao_search.sh
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.