API de 1688
Localiza productos mayoristas de 1688 por palabra o por una imagen y consulta una oferta concreta mediante su enlace u offerId. Cada acción conserva su propio alcance: lista de búsqueda, hasta cinco coincidencias visuales o detalle de una oferta.
image_search acepta una sola imagen pública y no amplía automáticamente cada resultado con SKU. min_order_quantity sigue siendo una condición de compra, mientras que rank solo indica el orden de coincidencia en esa respuesta.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de 1688, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar ofertas mayoristas en 1688search | Usa keyword para el producto y, si hace falta, city, min_price, max_price o sort para acotar la lista. | $1.39 por 1.000 solicitudes | Normal |
Revisar SKU y precios por cantidad de una ofertaproduct_detail | url acepta el enlace /offer/ o el offerId numérico. | $1.39 por 1.000 solicitudes | Normal |
Buscar productos de 1688 mediante una imagenimage_search | Envía una imagen HTTPS en image_url. | $5.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de 1688?
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.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar ofertas mayoristas en 1688 Usa | keyword | city, max_price, min_price, sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · text · price_min · price_max · currency · min_order_quantity · order_count · repurchase_rate · category · city · province · supplier_name · is_out_of_stock · supports_dropship · images · supplier_type · supplier_years · supplier_shop_url · supplier_composite_score · sold_count_text · service_tags · product_badges · platform |
product_detailRevisar SKU y precios por cantidad de una oferta
| url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · title · text · price_min · price_max · currency · price_tiers · min_order_quantity · stock · sold_count · category · unit · supplier_name · supplier_fans · supplier_founded_year · supplier_type · supplier_favorited_count · supports_dropship · supports_sampling · is_out_of_stock · skus · images · description_images · video_url · specs · rating · rating_scale · review_count · positive_rate · sold_display · want_buy_count · category_path · services · promotions · customization_supported · winport_url · platform |
image_searchBuscar productos de 1688 mediante una imagen Envía una imagen HTTPS en | image_url | — | Entrega síncrona | El catálogo declara defaultLimit = 5 y maxLimit = 5 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | id · url · title · price · currency · min_order_quantity · order_count · supplier_name · image_url · rank · platform |
¿Qué significan los parámetros de 1688 search?
Usa keyword para el producto y, si hace falta, city, min_price, max_price o sort para acotar la lista. Conserva price_min, price_max, currency, min_order_quantity y supplier_name; el orden y order_count no prueban ventas exactas ni una cotización final.
keywordObligatorio- Término de búsqueda de productos al por mayor en 1688, como «termo» o «caja de cartón». Se usa para
search; no es el nombre de la tienda ni elofferId. La cantidad mínima de pedido y los precios por tramos forman parte de la información del producto devuelta. cityOpcional- Filtro de texto por ciudad para la búsqueda de productos en 1688. No es la ubicación de la cuenta ni modifica la dirección del proveedor devuelta. Al especificar un producto concreto, no se puede dar por sentado que este filtro siga activo.
max_priceOpcional- Límite superior numérico para el filtro de precios de productos al por mayor. No es el límite superior de cantidad en la tarificación por tramos. Se usa con
min_pricepara limitar el rango de precios, pero no garantiza que cada SKU o tramo de cantidad esté dentro de dicho rango. min_priceOpcional- Límite inferior numérico para el filtro de precios de productos al por mayor. No es la cantidad mínima de pedido (MOQ) ni el presupuesto para llamadas a la API. Diferentes cantidades de compra pueden corresponder a diferentes precios por tramos, por lo que el precio filtrado no debe tomarse como la oferta final.
sortOpcional- Orden de búsqueda de productos:
relevancepara relevancia,popularpara los más vendidos,price_asc/price_descpara precio ascendente / descendente. Si no se envía,searchusarelevance. El orden no garantiza la devolución del volumen de ventas o el importe exacto de las transacciones.Valores permitidos:popularprice_ascprice_descrelevance
¿Qué significan los parámetros de 1688 product_detail?
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.
urlObligatorio- Para
product_detail, usa una URL de producto dedetail.1688.comom.1688.com, un texto compartido con una sola URL de producto o elofferIdnumérico. Un enlace deqr.1688.comsolo 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.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. · Consultada
¿Qué significan los parámetros de 1688 image_search?
Envía una imagen HTTPS en image_url. La respuesta contiene como máximo cinco ofertas con ID, título, precio CNY, imagen y enlace de detalle; no incluye la matriz completa de SKU, y rank no es un ranking de ventas.
image_urlObligatorio- Para
image_search, envía una sola URL HTTPS pública de una imagen de producto. La acción procesa una imagen, devuelve como máximo cinco ofertas de 1688 y no añade detalles ni SKU.Plataforma abierta de 1688: productos similares a partir de una imagen — La plataforma abierta de 1688 documenta una consulta oficial de productos similares que acepta una URL o contenido de imagen. Esta fuente solo confirma el objeto imagen-a-producto dentro de 1688; el límite de una imagen, el máximo de cinco resultados, los campos, la facturación y la implementación de EveryInfra siguen su propio contrato publicado. · Consultada
Cómo usar la API de 1688
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"alibaba1688","action":"search","params":{"keyword":"<keyword>"}}'
Guías de 1688
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Cómo comercializar el rastreo de precios: crea un producto de supervisión que los comerciantes deseen renovar
Analiza por qué los comerciantes pagan por el seguimiento de precios y por qué cancelan la suscripción. A partir de la coincidencia de productos, las listas de excepciones operativas y la aprobación de cambios, examina las formas de entrega, las unidades de cobro y la validación de pilotos para datos de precios.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Fallos de API, devolución de cargos y conciliación: cómo verificar el cargo neto de una solicitud
Separa las tareas de negocio, los intentos de llamada, los estados de entrega y los eventos de la cartera para explicar los rechazos previos al cargo, los resultados vacíos y las devoluciones parciales de cargos sin restar dos veces una misma devolución, y verifica una única solicitud con ejemplos enteros sin conexión.
Leer el artículo →Preguntas sobre la API de 1688
¿Cómo llamo a la API de 1688?
Envía POST /api/v1/social con platform igual a alibaba1688, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de 1688?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, price_min y price_max. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de 1688?
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.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; product_detail requiere url; image_search requiere image_url.
¿Las acciones de 1688 responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.