API de Detalles del producto de Taobao
Salud de la API
- Salud 24 h
- 95 %
- Tiempo medio 24 h
- 7.40 s
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
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.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a taobao y action igual a product_detail. Precio $4.5 por 1.000 solicitudes ($0.0045 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 Detalles del producto lee la ficha pública completa de un producto de Taobao o Tmall: título, marca, precio y precio original, precio con cupón, stock y unidades vendidas, cada SKU con su propio precio y stock, los atributos del producto, la imagen principal y las imágenes largas de la descripción, además de la tienda y los gastos de envío. Sirve para desmontar el anuncio de un competidor, seguir precios y promociones, comparar ofertas o completar un catálogo de productos. La marca, el precio original, el precio con cupón, las unidades vendidas, los atributos, el ID de tienda y los gastos de envío solo los devuelve parte de las llamadas, así que su ausencia no siempre significa que no existan.
url acepta el ID numérico del producto, un enlace de producto o un texto compartido que contenga exactamente un enlace de producto; los códigos para compartir de Taobao sin enlace y los enlaces caducados se rechazan. Al leer precios, ten en cuenta que coupon_price solo aparece cuando hay un cupón y que cada entrada de skus puede llevar su propio precio. is_tmall distingue las tiendas de Tmall de las tiendas normales de Taobao, que tienen requisitos y garantías distintos.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Taobao: Detalles del producto (taobao/product_detail).
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 product_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
- url: Para product_detail, reviews o questions, 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.
- Devuelve un objeto. Campos principales: id, url, title, brand (Marca), price (Precio como número, sin símbolo de mone…), original_price (Precio original (tachado)), currency, price_basis (Cómo se obtuvo price (solo aparece cuan…), stock (Unidades en stock), sold_count (Unidades vendidas), category_id (ID de categoría), location (Lugar desde el que se envía); 78 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- Cuerpo de solicitud de ejemplo:
{
"platform": "taobao",
"action": "product_detail",
"params": {
"url": "https://item.taobao.com/item.htm?id=744983869996"
}
}
- Precio: $4.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í | product_detail | Identificador de la capacidad, valor fijo. |
url | body.params | string | Sí | - | Para product_detail, reviews o questions, 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 de e.tb.cn y m.tb.cn solo 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. Una llamada síncrona tarda como máximo unos 85 segundos; configura el tiempo de espera de tu cliente en al menos 95 segundos. Con product_detail, si el producto se ha retirado o no existe, la respuesta viene vacía, con empty_reason igual a item_not_found, y no se cobra. |
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": "product_detail",
"params": {
"url": "https://item.taobao.com/item.htm?id=744983869996"
}
}'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": "product_detail", "results": { "id": "•••", "url": "https://item.taobao.com/item.htm?id=744983869996", "title": "绿联转换插头英标韩国马来西亚澳洲新加坡新西兰Switch转换器充电", "price": 29.97, "currency": "CNY", "stock": 1397, "category_id": "50003472", "location": "廣東東莞", "is_tmall": true, "shop_name": "绿联数码旗舰店", "shop_id": "67095450", "skus": [ { "id": "•••", "name": "[for Outings] English to Chinese Converter|Matte Black⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China", "price": 30.17, "stock": 200, "image_url": "https://img.alicdn.com/bao/uploaded/i3/713464357/O1CN01QOFAISCEu2L1chua_!!713464357.jpg" }, { "id": "•••", "name": "[for Outings] English to Chinese Converter|Lightweight White⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China", "price": 29.97, "stock": 200, "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01P9gIa5t80pC1chua_!!713464357.jpg" }, { "id": "•••", "name": "[for Mainland China] Chinese to English Converter|Matte Black⭐Applicable to Hong Kong Version of Ps5/Switch2/Electrical Appliances in Hong Kong and Macau, China", "price": 30.17, "stock": 200, "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01WLbh5e1i3YjKWsf7g_!!713464357.jpg" } ], "sku_count": 8, "main_image_url": "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg", "description_images": [ "https://img.alicdn.com/imgextra/i1/713464357/O1CN01tRpmSz1MdQI1WPZ8_!!713464357.jpg", "https://img.alicdn.com/imgextra/i1/713464357/O1CN019muBmB1i3YpL3L8sM_!!713464357.jpg", "https://img.alicdn.com/imgextra/i3/713464357/O1CN011J4LMz1i3Ynq3SQ1z_!!713464357.jpg" ], "price_usd": 5.27, "root_category_id": "50020579", "category_path": "首页 > 电子/电工 > 接线板/插头 > 转换插头", "min_order_quantity": 1, "images": [ "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg", "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01f4WmsN1i3YoKlcotr_!!713464357.jpg", "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01KQ3NjW1i3YljOLkIv_!!713464357.jpg" ], "category_name": "转换插头", "description": "港版Switch转换插头 - 英标转中转换器,适用马来西亚插头与多国转换插头,具备65W快充功能。适合港版Switch 1与2使用,提供全球适用的转换解决方案。\n\n多国适用与高效快充功能 - 绿联多国转换插头支援英标、美标、德标与澳标等多种插头类型,适用全球多数国家与地区。内建65W快充技术,确保高功率需求的装置如Switch主机与笔电能快速充电,同时具备安全保护机制,避免过载与短路。\n\n多样款式与便利设计选择 - 转换插头提供多种款式选择,包含单独英转中、中转英与多合一组合。特别针对港版Switch 2使用者设计,提供适用进口电器的转换方案。轻巧便携设…", "keywords": [ "港版Switch转换插头", "英标转中转换器", "适用马来西亚插头" ], "shop_score_description": 4.8, "shop_score_service": 4.8, "shop_score_delivery": 4.9, "free_shipping": false, "has_price_range": true, "payment_methods": [ "蚂蚁花呗", "信用卡支付", "集分宝" ], "seller_id": "•••", "seller_credit_level": 20, "seller_type": "B", "seller_type_label": "Business seller", "selling_points": [ "港版Switch2转换插头:专为港版Switch2设计转换插头,兼容多国电压,出国携带无烦恼。", "绿联品牌认证转换器:知名电子品牌绿联出品,通过多国安全认证,使用更安心。", "多国插头规格适用:适用马来西亚、新加坡、英国等多国插座标准,国际旅行首选。" ], "shop_logo_url": "https://img.alicdn.com/imgextra//d2/82/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg", "shop_url": "https://shop.m.taobao.com/shop/shop_index.htm?user_id=713464357", "shop_item_count": 1330, "shop_new_item_count": 28, "shop_opened_at": "2011-05-30 14:37:22", "seven_day_return": false, "reviews": [ { "text": "还不错,通电了装换头会有提示灯 没送收纳袋。 体积挺小巧的。 手感挺细腻的。", "rating": 5, "posted_at": "2026.10.17 18:07", "sku": "颜色:【内地用】中转英转换器|轻骑白⭐港版PS5/Switch2/中国香港澳门地区电器适用", "author_avatar_url": "https://gw.alicdn.com/•••" } ], "platform": "taobao" }, "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). |
brand | Marca. |
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. |
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. |
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. |
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. |
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. |
category_id | ID de categoría. |
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. |
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. |
shop_name | Nombre de la tienda. |
shop_id | ID de la tienda. |
shipping_fee | Gastos de envío. En product_detail viene vacío en la mayoría de las llamadas. |
ems_fee | Gastos de envío por EMS. En product_detail viene vacío en la mayoría de las llamadas. |
express_fee | Gastos de envío exprés. En product_detail viene vacío en la mayoría de las llamadas. |
skus | Todas las variantes (SKU) del anuncio. Cada entrada puede llevar id, name, price, original_price, coupon_price, stock, props_ids e image_url; price puede ser un precio convertido (ver price). |
sku_count | Número de SKU. |
spec_values | Tabla completa de valores de variante, incluidas las combinaciones que no están a la venta; id identifica el valor y text es su etiqueta. |
props_images | Imágenes de los valores de variante: id coincide con spec_values y props_ids, e image_url es la imagen de esa variante. |
attributes | Atributos del producto en filas {name, value}, como marca, modelo y lugar de origen. |
main_image_url | Imagen principal (la primera). En el detalle de producto (product_detail), si no llegan ni esta imagen ni images, no se cobra la llamada y el resto de los datos llega igual. |
description_images | Imágenes largas del área de descripción, en el orden de la página. En product_detail viene vacío en algunas llamadas. |
description_html | HTML original del área de descripción, sobre todo etiquetas de imagen. En product_detail viene vacío en algunas llamadas. |
video_url | Enlace directo al video de la imagen principal. Este campo suele estar vacío porque casi nunca está disponible, lo que no significa que el producto no lo tenga. |
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. |
price_usd | Precio de referencia en dólares estadounidenses, según la conversión que traen los datos devueltos. En product_detail viene vacío en la mayoría de las llamadas. |
total_price | Precio total tal como se devuelve; a menudo no aparece. |
suggestive_price | Precio de venta recomendado; a menudo no aparece. |
has_discount | Si hay descuento. En product_detail viene vacío en la mayoría de las llamadas. |
is_promotion | Si el producto está en promoción. En product_detail viene vacío en la mayoría de las llamadas. |
promo_type | Tipo de promoción. |
is_virtual | Si el producto es virtual (no es un bien físico). En product_detail viene vacío en la mayoría de las llamadas. |
brand_id | ID de la marca. |
root_category_id | ID de la categoría raíz. |
category_path | Ruta de categorías (migas de pan). |
weight | Peso del producto tal como se devuelve; a menudo 0 o ausente. En product_detail viene vacío en la mayoría de las llamadas. |
size | Dimensiones del producto; a menudo no aparecen. |
favorite_count | Veces que el producto se añadió a favoritos. |
fans_count | Número de seguidores tal como se devuelve; a menudo no aparece. |
min_order_quantity | Cantidad mínima de pedido. En product_detail viene vacío en la mayoría de las llamadas. |
shipping_to | Nota sobre la zona de entrega; a menudo no aparece. |
listed_at | Fecha de publicación del anuncio (ISO 8601); el campo no aparece si los datos no la traen. |
modified_at | Fecha de la última modificación (ISO 8601); el campo no aparece si los datos no la traen. |
delist_at | Fecha de retirada del anuncio (ISO 8601); el campo no aparece si los datos no la traen. |
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). |
category_name | Nombre de la categoría final (product_detail). |
description | Resumen o descripción, normalmente más breve que text. |
keywords | Palabras clave de la página del producto (product_detail). |
titleOriginal | Conserva el significado de la plataforma |
has_cn_title | Conserva el significado de la plataforma |
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. |
free_shipping | Si el envío es gratuito. |
promotion_price | Precio promocional (product_detail; a menudo falta). |
discount_price | Precio con descuento (product_detail; a menudo falta). |
discount_type | Tipo de descuento o campaña con su texto original (por ejemplo, oferta relámpago). |
price_note | Nota de precio con su texto original (product_detail). |
has_price_range | Si el precio es un rango porque las variantes cuestan distinto (product_detail). |
payment_methods | Métodos de pago aceptados (product_detail). |
seller_id | ID del vendedor (en shop puede faltar; en product_detail, algunas fuentes no lo devuelven). |
seller_credit_level | Nivel de crédito del vendedor (número; cuanto mayor, mejor). |
seller_type | Código del tipo de vendedor (product_detail). |
seller_type_label | Nombre del tipo de vendedor (product_detail), por ejemplo Tmall o tienda de empresa. |
selling_points | Etiquetas de puntos de venta. |
shop_logo_url | Enlace del logotipo de la tienda (product_detail, shop; en shop puede faltar). |
shop_url | Enlace de la tienda (product_detail, shop). |
shop_item_count | Productos a la venta en la tienda (product_detail, search, shop). |
shop_new_item_count | Productos nuevos de la tienda (product_detail). |
shop_opened_at | Fecha de apertura de la tienda con su texto original (product_detail). |
review_tags | Etiquetas de reseñas, cada una con tag (texto) y count (veces mencionada; puede faltar). |
review_count | Número de reseñas, en capacidades de productos y negocios. null significa no publicado, no 0. |
positive_rate | Porcentaje de reseñas positivas del producto (product_detail); a menudo falta. |
seven_day_return | Si admite devolución sin motivo en siete días (product_detail). |
reviews | Conserva el significado de la plataforma |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Preguntas frecuentes
#¿Qué puedo pasar en url?
#El ID numérico del producto, un enlace de producto de Taobao o Tmall, o un texto compartido que contenga exactamente un enlace de producto. Los enlaces cortos de e.tb.cn y m.tb.cn solo se aceptan cuando llevan de forma segura a una página de producto. Los códigos sin enlace, los enlaces caducados y las páginas de tienda o de búsqueda se rechazan.
¿Cómo leo los precios de un producto con varias variantes?
#skus enumera todas las variantes y cada una puede llevar su propio precio, precio original, precio con cupón y stock, mientras que price es la cifra del producto en conjunto. Registra los precios por variante cuando compares o hagas seguimiento; spec_values añade todos los valores de variante, incluidas las combinaciones que no están a la venta.
¿Los precios están en yuanes? ¿Hay una cifra en dólares?
#price, original_price y coupon_price son números sin símbolo de moneda, así que lee la moneda en currency en lugar de suponerla. price_usd es un precio de referencia en dólares estadounidenses según la conversión que traen los datos devueltos; viene vacío en la mayoría de las llamadas y, cuando aparece, sirve para comparar a grandes rasgos, no como el importe que vas a pagar. Los precios en yuanes de la ficha de producto son o bien el precio que muestra la página de Taobao, o bien un precio convertido desde dólares estadounidenses, que puede quedar alrededor de un 1–4 % por encima o por debajo; price_basis indica cuál has recibido, y manda el precio de la página.
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.
Referencias oficiales
#Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- 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.
Comprobado el 2026-09-04