API de Detalles del producto de 1688

POST

Salud de la API

Salud 24 h
98 %
Tiempo medio 24 h
29.27 s
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Saludable

Ú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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSíalibaba1688Identificador de la plataforma, valor fijo.
actionbodystringSíproduct_detailIdentificador de la capacidad, valor fijo.
urlbody.paramsstringSí-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

#
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

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

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlEnlace al registro en la plataforma.
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
textTexto 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_minLímite inferior del rango de precios.
price_maxLímite superior del rango de precios.
currencyCódigo de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda.
price_tiersPrecios escalonados: el precio unitario baja a medida que sube la cantidad del pedido. Lee cada tramo junto con su cantidad mínima.
min_order_quantityCantidad mínima de pedido (MOQ). Es el primer umbral de la compra mayorista en 1688: revísalo antes que nada.
stockStock. En los detalles del producto puede venir vacío en una llamada síncrona; una llamada asíncrona normalmente lo trae.
sold_countUnidades vendidas.
categoryNombre 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.
unitUnidad de precio (pieza, artículo, caja, etc.).
supplier_nameNombre del proveedor.
supplier_fansNú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_yearAño de fundación del proveedor.
supplier_typeModo 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_countVeces 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_dropshipSi 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_samplingSi 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_stockSi 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.
skusDetalle 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.
imagesEnlaces 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_imagesLista 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_urlURL del video del producto, cuando el anuncio tiene uno.
specsTabla 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.
ratingValoració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_scaleMá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_countNú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_rateTasa 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_displayVentas 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_countNú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_pathRuta 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.
servicesEtiquetas 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.
promotionsNombres de las promociones vigentes.
customization_supportedSi 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_urlEnlace a la tienda 1688 del proveedor.
cityNombre 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.
provinceProvincia 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_yearsAñ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_dimensionsConserva el significado de la plataforma
couponsConserva el significado de la plataforma
promotion_detailsConserva el significado de la plataforma
service_detailsDetalle 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_limitsConserva el significado de la plataforma
mix_wholesaleConserva el significado de la plataforma
supports_mixSi 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_tagsEtiquetas 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_rateConserva el significado de la plataforma
review_negative_countConserva el significado de la plataforma
review_neutral_countConserva el significado de la plataforma
review_with_photo_countNú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_countNú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_statsPerfil 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_scoresConserva el significado de la plataforma
supplier_metric_tagsConserva el significado de la plataforma
supplier_rankConserva el significado de la plataforma
supplier_industry_beltCertificació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_certificationAuditorí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_tagsConserva el significado de la plataforma
supplier_inspection_report_urlConserva el significado de la plataforma
supplier_videosConserva el significado de la plataforma
supplier_addressDirecció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_coordinatesUbicació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_categoryCategorí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.
customizationConserva el significado de la plataforma
shippingConserva el significado de la plataforma
unit_weight_kgPeso 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.
platformIdentificador 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.

Errores

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

Google Analytics solo si aceptas. Privacidad