API de Detalles del producto de 1688
Salud de la API
- Salud 24 h
- 98 %
- Tiempo medio 24 h
- 29.27 s
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
url acepta el enlace /offer/ o el offerId numérico. price_tiers.min_quantity marca cada tramo de cantidad y skus contiene especificaciones; una fila incompleta no debe extrapolarse a todas las variantes ni tratarse como una orden de compra.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a alibaba1688 y action igual a product_detail. Precio $1.39 por 1.000 solicitudes ($0.001389 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.
1688 Detalles del producto lee la ficha pública completa de un producto al por mayor: rango de precios y precios escalonados, cantidad mínima de pedido y unidad de precio, stock y ventas, detalle de variantes, valoración y tasa de reseñas positivas, imágenes, y el nombre, el tipo, el año de fundación, los seguidores y los favoritos del proveedor, además de si ofrece muestras y dropshipping. Sirve para decidir si conviene comprar a ese proveedor, evaluar una compra y comparar proveedores.
url acepta un enlace de producto de 1688, un texto compartido con exactamente un enlace de producto o un offer ID numérico; las páginas de inicio de tienda y de búsqueda se rechazan. Lee los precios con price_tiers, donde el precio unitario baja a medida que sube la cantidad. positive_rate es una fracción entre 0 y 1, no un porcentaje. Las opciones, los precios y el stock de skus solo aparecen cuando la plataforma los indica, así que un valor ausente no significa que esté agotado.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra 1688: Detalles del producto (alibaba1688/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 alibaba1688 y action en product_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
- url: Para product_detail, usa una URL de producto de detail.1688.com o m.1688.com, un texto compartido con una sola URL de producto o el offerId numérico.
- Devuelve un objeto. Campos principales: id, url, title, text, price_min (Límite inferior del rango de precios), price_max (Límite superior del rango de precios), currency, price_tiers (Precios escalonados: el precio unitario…), min_order_quantity (Cantidad mínima de pedido (MOQ)), stock (Stock), sold_count (Unidades vendidas), category (Nombre de la categoría según la taxonom…); 68 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688.
- Cuerpo de solicitud de ejemplo:
{
"platform": "alibaba1688",
"action": "product_detail",
"params": {
"url": "https://detail.1688.com/offer/873514490218.html"
}
}
- Precio: $1.39 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í | alibaba1688 | 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, usa una URL de producto de detail.1688.com o m.1688.com, un texto compartido con una sola URL de producto o el offerId numérico. Un enlace de qr.1688.com solo se acepta si puede resolverse de forma segura a una ficha de producto. Se rechazan las páginas de tiendas y los resultados de búsqueda. 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; si repites la consulta del mismo producto en las 24 horas siguientes, recibes el mismo resultado, también sin cobro. |
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": "alibaba1688",
"action": "product_detail",
"params": {
"url": "https://detail.1688.com/offer/873514490218.html"
}
}'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": "alibaba1688", "action": "product_detail", "results": { "id": "•••", "url": "https://detail.1688.com/offer/873514490218.html", "title": "跨境专供Pro6蓝牙耳机真无线入耳式超长续航tws运动无线蓝牙耳机", "price_min": 7.1, "price_max": 13.8, "currency": "CNY", "min_order_quantity": 2, "stock": 7682692, "sold_count": 16813, "category": "蓝牙耳机", "unit": "条", "supplier_name": "深圳高耳基科技有限公司", "supplier_fans": "582", "supplier_type": "normal_factory", "supplier_favorited_count": 582, "supports_dropship": { "enabled": false, "consignPrice": null, "consignPriceTiers": [], "channels": [], "channelDetails": [], "protections": [], "downstreamPerformance": null, "metrics": { "orders30d": null, "orders7d": null, "pickupRate48h": null, "pickupRate24h": null, "distributorCount": null, "downstreamStoreCount": null, "publishDate": null } }, "supports_sampling": false, "is_out_of_stock": false, "skus": [ { "id": "•••", "name": "Pro6蓝牙耳机 紫色", "options": { "颜色": "Pro6蓝牙耳机 紫色" }, "price": 7.6, "original_price": 7.6, "stock": 665434, "available": true, "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ngwdIg1fNlJ87ZHWL_!!2218564053995-0-cib.jpg" }, { "id": "•••", "name": "八代蓝牙耳机简配", "options": { "颜色": "八代蓝牙耳机简配" }, "price": 9.6, "original_price": 9.6, "stock": 666024, "available": true }, { "id": "•••", "name": "Pro6蓝牙耳机 粉色", "options": { "颜色": "Pro6蓝牙耳机 粉色" }, "price": 7.6, "original_price": 7.6, "stock": 664567, "available": true, "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VHBm431fNlJGJw3Jm_!!2218564053995-0-cib.jpg" } ], "images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01RrMK531fNlLKVri2p_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN01oiS7FO1fNlJFcPVcJ_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN019hrirk1fNlJGpWQke_!!2218564053995-0-cib.jpg" ], "description_images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01xDu8VE1fNlOMt4i8Z_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN01mTmUSS1fNlONCMZWr_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN01myoX5I1fNlONcSew0_!!2218564053995-0-cib.jpg" ], "video_url": "https://cloud.video.taobao.com/play/u/2218564053995/p/2/e/6/t/1/482069395965.mp4", "specs": [ { "name": "芯片类型", "value": "中科蓝讯" }, { "name": "功能", "value": "防水,降噪,呼吸灯,超长续航,通话功能,语音控制,支持音乐,数显屏幕,电竞低延迟" }, { "name": "续航时间", "value": "0-4小时" } ], "rating": 4.7, "review_count": 20, "positive_rate": 0.95, "sold_display": "已售2.2万+件", "want_buy_count": 127, "category_path": "数码、电脑 > 手机配件 > 蓝牙耳机", "services": [ "7天无理由退货", "晚发必赔" ], "winport_url": "https://winport.1688.com/page/index.html?memberId=b2b-2218564053995870c8&_tabId_=index&upstreamSource=od&offerId=873514490218", "platform": "1688", "rating_scale": 5 }, "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). |
text | Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma). |
price_min | Límite inferior del rango de precios. |
price_max | Límite superior del rango de precios. |
currency | Código de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda. |
price_tiers | Precios escalonados: el precio unitario baja a medida que sube la cantidad del pedido. Lee cada tramo junto con su cantidad mínima. |
min_order_quantity | Cantidad mínima de pedido (MOQ). Es el primer umbral de la compra mayorista en 1688: revísalo antes que nada. |
stock | Stock. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
sold_count | Unidades vendidas. |
category | Nombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
unit | Unidad de precio (pieza, artículo, caja, etc.). |
supplier_name | Nombre del proveedor. |
supplier_fans | Número de seguidores del proveedor. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_founded_year | Año de fundación del proveedor. |
supplier_type | Modo de negocio del proveedor (p. ej. fabricante, mayorista). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_favorited_count | Veces que el proveedor se añadió a favoritos. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supports_dropship | Si el proveedor envía unidades sueltas en tu nombre (dropshipping). Es un filtro clave para vender sin tener stock. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supports_sampling | Si el proveedor ofrece muestras. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
is_out_of_stock | Si el producto está agotado. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
skus | Detalle de variantes cuando está disponible. Las opciones, el precio, el stock y la disponibilidad de cada fila solo se devuelven cuando los datos de la plataforma los indican; un valor ausente no significa que esté agotado. En los detalles del producto, estos campos de las variantes pueden venir vacíos en una llamada síncrona: weight_g, length_cm, width_cm, height_cm, volume_cm3, image_url, original_price; si los necesitas, usa una llamada asíncrona. |
images | Enlaces de las imágenes principales del producto, en el orden de la página; en product_detail algunos anuncios incluyen también imágenes de variantes (SKU), y las imágenes de la descripción van en description_images. No aparece si no hay imágenes. |
description_images | Lista de URLs de las imágenes de descripción del detalle, en el orden original del anuncio; null si el anuncio no tiene ninguna. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
video_url | URL del video del producto, cuando el anuncio tiene uno. |
specs | Tabla de especificaciones: lista de pares {name, value} (p. ej. Material: TPU). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
rating | Valoración global del producto (1-5). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
rating_scale | Máximo de rating en la misma fila: 5 en escalas de cinco estrellas y 10 en escalas de diez puntos. Solo aparece si la fila tiene rating. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
review_count | Número total de reseñas. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
positive_rate | Tasa de reseñas positivas como fracción 0-1 (0,999 = 99,9 %). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
sold_display | Ventas tal como se muestran en el texto original chino (p. ej. 100k+ vendidos); para la cifra numérica usa sold_count. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
want_buy_count | Número de compradores que marcaron el anuncio como deseado (señal de demanda). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
category_path | Ruta de categoría completa con los segmentos en el idioma de origen (chino). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
services | Etiquetas de servicio del anuncio (p. ej. devolución con envío pagado). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
promotions | Nombres de las promociones vigentes. |
customization_supported | Si el proveedor admite personalización (diseño a medida, muestreo). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
winport_url | Enlace a la tienda 1688 del proveedor. |
city | Nombre de la ciudad en el idioma de la plataforma, sin normalizar. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
province | Provincia donde está el proveedor. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_years | Años del proveedor en la plataforma 1688. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
package_dimensions | Conserva el significado de la plataforma |
coupons | Conserva el significado de la plataforma |
promotion_details | Conserva el significado de la plataforma |
service_details | Detalle de las garantías de servicio: code (código del servicio), name, description (la regla), rule_url (página de la regla). services / service_tags solo dan los nombres. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
purchase_limits | Conserva el significado de la plataforma |
mix_wholesale | Conserva el significado de la plataforma |
supports_mix | Si el anuncio admite pedidos mixtos (combinar distintos modelos para alcanzar el pedido mínimo). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
review_tags | Etiquetas de impresión de los compradores: [{tag, count}], por ejemplo «tela suave» ×2. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
refund_rate | Conserva el significado de la plataforma |
review_negative_count | Conserva el significado de la plataforma |
review_neutral_count | Conserva el significado de la plataforma |
review_with_photo_count | Número de reseñas con fotos; null significa que no se indicó, no que sea 0. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
review_with_text_count | Número de reseñas con texto; null significa que no se indicó, no que sea 0. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_stats | Perfil del proveedor (solo las claves con valor): employee_count, plant_area_sqm (superficie de la fábrica en m²), plant_type (por ejemplo, fábrica propia), equipment_count (equipos principales), product_count (productos a la venta), repeat_rate (tasa de recompra, 0-1), repeat_buyer_count_text / cross_border_buyer_count_text (compradores recurrentes y transfronterizos tal como aparecen, como 300+), response_rate (0-1), positive_review_rate (0-1), fulfillment_rate (0-1), certificate_count / certificates / management_certificates (número de certificados, nombres y certificaciones de sistemas de gestión), patent_count, oem_mode (OEM/ODM), own_brands (marcas propias tal como aparecen), brand_count, partner_brand, is_major_brand_partner (provee a grandes marcas), scale_tier (nivel de tamaño), honors. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_scores | Conserva el significado de la plataforma |
supplier_metric_tags | Conserva el significado de la plataforma |
supplier_rank | Conserva el significado de la plataforma |
supplier_industry_belt | Certificación de clúster industrial: description (por ejemplo, comerciante insignia certificado por 1688 de un clúster regional de ropa), link_url (página de la certificación). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_certification | Auditoría de fábrica o de empresa por terceros: agency (código del auditor, como sgs o tuv), report_number (número del informe tal como aparece), report_url (página del informe). En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_verification_tags | Conserva el significado de la plataforma |
supplier_inspection_report_url | Conserva el significado de la plataforma |
supplier_videos | Conserva el significado de la plataforma |
supplier_address | Dirección del proveedor tal como aparece. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_coordinates | Ubicación del proveedor: {longitude, latitude}. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
supplier_main_category | Categoría principal del proveedor. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
customization | Conserva el significado de la plataforma |
shipping | Conserva el significado de la plataforma |
unit_weight_kg | Peso de una unidad, en kilogramos. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Preguntas frecuentes
#¿Cómo leo los precios escalonados?
#price_tiers enumera el precio unitario de cada tramo de cantidad, que baja a medida que compras más. min_order_quantity es el pedido mínimo y unit, la unidad de precio. Para estimar el coste, busca el tramo en el que cae la cantidad que piensas comprar.
¿Cómo distingo una fábrica de una empresa comercializadora?
#supplier_type indica si el proveedor es fabricante o comercializador. Léelo junto con supplier_founded_year, supplier_fans y supplier_favorited_count para valorar cuánto tiempo lleva operando y cuánta atención recibe.
¿Una variante sin datos de stock está agotada?
#No necesariamente. Las opciones, los precios, el stock y la disponibilidad de skus solo se devuelven cuando la plataforma los indica, así que un hueco no significa que se haya agotado. Para el producto en conjunto, consulta is_out_of_stock. En una llamada síncrona, stock, positive_rate, supports_dropship y otros campos (categoría, reseñas, servicios, perfil del proveedor, tamaño y peso de las variantes; la lista de campos los nombra todos) pueden venir vacíos; si los necesitas, usa una llamada asíncrona.
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.
- 1688: producto, variante y cantidad mínima ↗
La documentación de 1688 distingue el identificador del producto, la variante y la cantidad de compra, y valida por separado la cantidad mínima. Se cita para aclarar esos objetos, no para atribuir a esta API funciones de pedido o compra.
Comprobado el 2026-09-04