API de plataforma de EveryData
API de AliExpress
Investiga productos de AliExpress desde la búsqueda hasta la ficha, variantes, reseñas y distribución de estrellas. La URL del artículo conserva el contexto de mercado para las acciones de detalle.
Precio, descuento, pedidos mostrados y stock son señales distintas. Las variantes pueden tener importes y disponibilidad propios, y una distribución agregada de ratings no sustituye el texto de las reseñas.
- Endpoint
- POST /api/v1/social
- Funciones
- 6
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de AliExpress 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 productos en AliExpress Localiza productos de AliExpress con | keyword | min_price, min_rating, sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 200` 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 | product_id · title · url · price · original_price · currency · discount · rating · rating_scale · orders_count · review_count · image_url · ships_from · seller_name · category · is_top_rated · free_shipping · platform |
profileConsultar una ficha de AliExpress Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | product_id · title · url · price · price_max · original_price · currency · rating · rating_scale · review_count · variant_count · brand · category_id · category_path · ships_from · seller_country · store_id · store_name · store_url · store_rating · store_sales · store_opened_at · image_url · platform |
variantsEnumerar variantes y SKU Usa la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | product_id · title · url · variant_count · platform · sku_id · name · properties · color_hex · image_url · price · original_price · currency · stock · available |
reviewsLeer reseñas del producto Recoge reseñas del producto indicado por | url | sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 200` 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 | review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · platform |
ratingsRevisar la distribución de valoraciones Resume la distribución de estrellas y las tasas positiva, neutral y negativa de la ficha indicada por | url | sort | Entrega síncrona | — | $1.39 por 1.000 solicitudes | average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · platform · count · rate |
product_detailObtener el detalle regional del producto Consulta una ficha por | url | country, currency | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · platform |
¿Qué acepta cada acción de AliExpress?
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 AliExpress search?
Localiza productos de AliExpress con keyword y permite filtrar precio, valoración u orden. Compara price, original_price, descuento, pedidos y vendedor dentro de la ficha observada; no calcula demanda ni margen comercial.
keywordObligatorio- Término de búsqueda de productos en AliExpress, como «wireless earbuds». Se usa para buscar listas de productos, no es un ID de vendedor. Los detalles del producto, sus variantes y las reseñas se localizan mediante el enlace del producto.
min_priceOpcional- Precio mínimo para la búsqueda de productos. Es un valor numérico que se usa para excluir artículos por debajo de este importe. No es un porcentaje de descuento ni el presupuesto para solicitudes a la API. La moneda del precio se basa en los resultados de la búsqueda.
min_ratingOpcional- Puntuación mínima de estrellas para la búsqueda de productos, en un rango de 0 a 5 (p. ej., 4.5). No es el número de reseñas ni el porcentaje de valoraciones positivas, y no filtra la puntuación de estrellas de reseñas individuales.
sortOpcional- Elige uno de los valores permitidos listados en esta API. Para
search:relevancees el orden general por defecto,popularprioriza el volumen de pedidos,price_asc/price_descordenan por precio ascendente / descendente ytop_ratedprioriza la puntuación; es compatible con los valores antiguosdefault/orders/rating. Parareviews/ratings:relevancees el orden por defecto ynewestmuestra las reseñas más recientes, no la fecha de publicación del producto.
¿Qué significan los parámetros de AliExpress profile?
Abre la url de un producto y reúne título, precios, moneda, valoración, pedidos, tienda y disponibilidad visibles. Es una ficha de artículo, no el perfil personal del comprador ni un inventario garantizado.
urlObligatorio- Enlace del producto de AliExpress. Se recomienda usar el formato
https://www.aliexpress.com/item/<ID_producto>.html. La acciónprofiledevuelve los datos del producto (no el perfil del usuario),variantsconsulta las variantes del producto yreviews/ratingsobtiene las reseñas o el resumen de puntuaciones.product_detailtambién acepta el ID numérico del producto.
¿Qué significan los parámetros de AliExpress variants?
Usa la url del producto para enumerar variantes y SKU con propiedades, color, imagen y precio cuando se publican. Una combinación ausente no debe interpretarse como agotada ni como la lista completa de existencias.
urlObligatorio- Enlace del producto de AliExpress. Se recomienda usar el formato
https://www.aliexpress.com/item/<ID_producto>.html. La acciónprofiledevuelve los datos del producto (no el perfil del usuario),variantsconsulta las variantes del producto yreviews/ratingsobtiene las reseñas o el resumen de puntuaciones.product_detailtambién acepta el ID numérico del producto.AliExpress: atributos de producto y atributos de SKULa documentación oficial separa los atributos generales de un producto de las combinaciones de SKU, como color o talla. La referencia explica la terminología; no promete que se devuelvan todas las combinaciones ni habilita publicación de productos.Consultada
¿Qué significan los parámetros de AliExpress reviews?
Recoge reseñas del producto indicado por url y admite el sort declarado. Distingue país, variante, utilidad y logística de cada opinión; no responde al autor ni prueba que toda compra esté verificada.
urlObligatorio- Enlace del producto de AliExpress. Se recomienda usar el formato
https://www.aliexpress.com/item/<ID_producto>.html. La acciónprofiledevuelve los datos del producto (no el perfil del usuario),variantsconsulta las variantes del producto yreviews/ratingsobtiene las reseñas o el resumen de puntuaciones.product_detailtambién acepta el ID numérico del producto. sortOpcional- Elige uno de los valores permitidos listados en esta API. Para
search:relevancees el orden general por defecto,popularprioriza el volumen de pedidos,price_asc/price_descordenan por precio ascendente / descendente ytop_ratedprioriza la puntuación; es compatible con los valores antiguosdefault/orders/rating. Parareviews/ratings:relevancees el orden por defecto ynewestmuestra las reseñas más recientes, no la fecha de publicación del producto.Valores permitidos:newestrelevance
¿Qué significan los parámetros de AliExpress ratings?
Resume la distribución de estrellas y las tasas positiva, neutral y negativa de la ficha indicada por url. sort solo pertenece al contrato compatible y no convierte este agregado en una lista de reseñas individuales.
urlObligatorio- Enlace del producto de AliExpress. Se recomienda usar el formato
https://www.aliexpress.com/item/<ID_producto>.html. La acciónprofiledevuelve los datos del producto (no el perfil del usuario),variantsconsulta las variantes del producto yreviews/ratingsobtiene las reseñas o el resumen de puntuaciones.product_detailtambién acepta el ID numérico del producto. sortOpcional- Elige uno de los valores permitidos listados en esta API. Para
search:relevancees el orden general por defecto,popularprioriza el volumen de pedidos,price_asc/price_descordenan por precio ascendente / descendente ytop_ratedprioriza la puntuación; es compatible con los valores antiguosdefault/orders/rating. Parareviews/ratings:relevancees el orden por defecto ynewestmuestra las reseñas más recientes, no la fecha de publicación del producto.Valores permitidos:newestrelevance
¿Qué significan los parámetros de AliExpress product_detail?
Consulta una ficha por url, con country y currency opcionales para el contexto regional. Devuelve precio, descuento, ventas mostradas, valoración y señales de stock; no realiza el pedido ni promete entrega.
urlObligatorio- Enlace del producto de AliExpress. Se recomienda usar el formato
https://www.aliexpress.com/item/<ID_producto>.html. La acciónprofiledevuelve los datos del producto (no el perfil del usuario),variantsconsulta las variantes del producto yreviews/ratingsobtiene las reseñas o el resumen de puntuaciones.product_detailtambién acepta el ID numérico del producto. countryOpcional- Código de país o región para la consulta de
product_detail, comoUS. El valor por defecto esUSy se convierte a mayúsculas. Selecciona la región de consulta del producto, pero no modifica el país de tu cuenta ni la dirección real de envío del pedido. currencyOpcional- Moneda para mostrar el precio del producto en
product_detail, comoUSD. El valor por defecto esUSDy se convierte a mayúsculas. No afecta a la moneda de facturación de las llamadas a esta API.
Cómo usar la API de AliExpress
- 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":"aliexpress","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de AliExpress
¿Cómo llamo a la API de AliExpress?
Envía POST /api/v1/social con platform igual a aliexpress, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de AliExpress?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye product_id, title, price y original_price. 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 AliExpress?
La documentación oficial separa los atributos generales de un producto de las combinaciones de SKU, como color o talla. La referencia explica la terminología; no promete que se devuelvan todas las combinaciones ni habilita publicación de productos.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; variants requiere url; consulta las demás acciones en la lista de funciones.