API de plataforma de EveryData
API de 1688
Localiza productos de compra mayorista en 1688 y consulta una oferta concreta por enlace u offerId. La búsqueda separa el precio publicado, el pedido mínimo y el nombre del proveedor; el detalle añade escalas de precio y variantes cuando están disponibles.
`min_order_quantity` es una condición de compra, no el límite de resultados. Una banda de precio tampoco incluye necesariamente envío, impuestos o todas las variantes: compárala con `price_tiers`, `skus` y la unidad del anuncio.
- Endpoint
- POST /api/v1/social
- Funciones
- 2
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de 1688 por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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 · 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 · platform · name · price · min_quantity |
¿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.
¿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- Localizador de un producto en 1688. La acción
product_detailacepta una URLhttps://detail.1688.com/offer/<offerId>.html, un enlace con el parámetro de consultaofferIdo solo elofferIdnumérico. No envíes la página de inicio de la tienda ni la de resultados de búsqueda.1688: producto, variante y cantidad mínimaLa 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
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 devuelto si la acción es 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>"}}'
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 de origen contengan 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.