API de Detalles del producto de 1688

Q: ¿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.

Q: ¿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.

POST

Salud de la API

Salud 24 h: Normal
Tiempo medio 24 h: —

Saludable / normal
Disponible
Limitada
Casi sin servicio

Normal

Ú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.

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.

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.

Prompt para IA

Pégalo en tu asistente de IA. Ya incluye los parámetros, los campos de respuesta y una solicitud de ejemplo de este endpoint, así que el asistente puede preguntarte qué necesitas y luego escribir el script.

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra 1688: Detalles del producto (alibaba1688/product_detail).

Contrato del 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; 37 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	No declarado	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.

Ejemplos de código

bash

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

Respuesta real

Obtenida el 13 de octubre de 2026, 04:57 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.

json

{
  "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.
`sold_count`	Unidades vendidas.
`category`	Nombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
`unit`	Unidad de precio (pieza, artículo, caja, etc.).
`supplier_name`	Nombre del proveedor.
`supplier_fans`	Número de seguidores del proveedor.
`supplier_founded_year`	Año de fundación del proveedor.
`supplier_type`	Modo de negocio del proveedor (p. ej. fabricante, mayorista).
`supplier_favorited_count`	Veces que el proveedor se añadió a favoritos.
`supports_dropship`	Si el proveedor envía unidades sueltas en tu nombre (dropshipping). Es un filtro clave para vender sin tener stock.
`supports_sampling`	Si el proveedor ofrece muestras.
`is_out_of_stock`	Si el producto está agotado.
`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.
`images`	Lista de enlaces de imagen en el orden en que los muestra la plataforma; 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.
`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).
`rating`	Valoración global del producto (1-5).
`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.
`review_count`	Número total de reseñas.
`positive_rate`	Tasa de reseñas positivas como fracción 0-1 (0,999 = 99,9 %).
`sold_display`	Ventas tal como se muestran en el texto original chino (p. ej. 100k+ vendidos); para la cifra numérica usa sold_count.
`want_buy_count`	Número de compradores que marcaron el anuncio como deseado (señal de demanda).
`category_path`	Ruta de categoría completa con los segmentos en el idioma de origen (chino).
`services`	Etiquetas de servicio del anuncio (p. ej. devolución con envío pagado).
`promotions`	Nombres de las promociones vigentes.
`customization_supported`	Si el proveedor admite personalización (diseño a medida, muestreo).
`winport_url`	Enlace a la tienda 1688 del proveedor.
`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.

Errores y facturación

401: Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
422: Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
402: Saldo insuficiente. Recarga primero.
429: Se alcanzó el límite de solicitudes por minuto de la cuenta (todas sus claves API cuentan juntas; antes se aplica el límite propio de una clave si es menor). Espera lo que indique Retry-After y vuelve a intentarlo; un paquete de velocidad en la consola sube el límite.
503: No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
200 vacío: La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).

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