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 un resumen agregado de valoraciones no sustituye el texto de las reseñas.
Disponibilidad de la plataforma
- Salud 24 h
- 97 %
Últimos 30 días
Funciones disponibles
Cada acción de AliExpress, 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 productos en AliExpresssearch | Localiza productos de AliExpress con keyword y permite filtrar precio, valoración u orden. | $1.39 por 1.000 solicitudesCada 50 filas cuentan como una llamada | Saludable · salud 100 % |
Consultar una ficha de AliExpressprofile | Abre la url de un producto y reúne título, precios, moneda, valoración, pedidos, tienda y disponibilidad visibles. | $1.39 por 1.000 solicitudes | Normal |
Enumerar variantes y SKUvariants | Usa la url del producto para enumerar variantes y SKU con propiedades, color, imagen y precio cuando se publican. | $1.39 por 1.000 solicitudes | Saludable · salud 97 % |
Leer reseñas del productoreviews | Recoge reseñas del producto indicado por url y admite el sort declarado. | $1.39 por 1.000 solicitudes | Normal |
Consultar el resumen de valoracionesratings | Resume la valoración de la ficha indicada por url. | $1.39 por 1.000 solicitudes | Normal |
Obtener el detalle regional del productoproduct_detail | Consulta una ficha por url, con country y currency opcionales para el contexto regional. | $1.39 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 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.
| 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 solicitudesCada 50 filas cuentan como una llamada | 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 · images · search_rank · seller_rating · seller_url · platform · tags |
profileConsultar una ficha de AliExpress Abre la | 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 · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
variantsEnumerar variantes y SKU Usa la | 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 · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
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 · is_anonymous · unhelpful_count · language · original_text · is_translated · review_labels · sku_id · platform · images |
ratingsConsultar el resumen de valoraciones Resume la valoración de la ficha indicada por | url | — | 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 |
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 · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
¿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:relevancees el orden por defecto ynewestmuestra las reseñas más recientes, no la fecha de publicación del producto.ratingsno admitesort.Valores permitidos:popularprice_ascprice_descrelevancetop_rated
¿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. countryOpcional- Código de país o región, como
US, para el queprofile,variantsyproduct_detailconsultan el producto. El valor por defecto esUSy se convierte a mayúsculas. Elige la versión regional del artículo, pero no modifica el país de tu cuenta ni la dirección real de envío de un pedido. currencyOpcional- Moneda en la que
profile,variantsyproduct_detaildevuelven los precios del artículo, comoUSD. El valor por defecto esUSDy se convierte a mayúsculas. Solo cambia los precios mostrados y no afecta a la facturación de las llamadas a esta API.
¿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 SKU — 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. · Consultada countryOpcional- Código de país o región, como
US, para el queprofile,variantsyproduct_detailconsultan el producto. El valor por defecto esUSy se convierte a mayúsculas. Elige la versión regional del artículo, pero no modifica el país de tu cuenta ni la dirección real de envío de un pedido. currencyOpcional- Moneda en la que
profile,variantsyproduct_detaildevuelven los precios del artículo, comoUSD. El valor por defecto esUSDy se convierte a mayúsculas. Solo cambia los precios mostrados y no afecta a la facturación de las llamadas a esta API.
¿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:relevancees el orden por defecto ynewestmuestra las reseñas más recientes, no la fecha de publicación del producto.ratingsno admitesort.Valores permitidos:newestrelevance
¿Qué significan los parámetros de AliExpress ratings?
Resume la valoración de la ficha indicada por url. Por ahora solo se devuelven average_star y total_reviews; el desglose por estrellas (five_star a one_star, cada uno con count y rate) y las tasas positive_rate, neutral_rate y negative_rate no están disponibles de momento y volverán a aparecer en la respuesta cuando lo estén. No es una lista de reseñas individuales; para eso se usa reviews.
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 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, como
US, para el queprofile,variantsyproduct_detailconsultan el producto. El valor por defecto esUSy se convierte a mayúsculas. Elige la versión regional del artículo, pero no modifica el país de tu cuenta ni la dirección real de envío de un pedido. currencyOpcional- Moneda en la que
profile,variantsyproduct_detaildevuelven los precios del artículo, comoUSD. El valor por defecto esUSDy se convierte a mayúsculas. Solo cambia los precios mostrados y no afecta a la 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 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":"aliexpress","action":"search","params":{"keyword":"<keyword>"}}'
Guías de AliExpress
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 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 tengan 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.
¿Las acciones de AliExpress 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.