API de AliExpress para España: fichas, variantes y precios en euros (JSON)

Con `"country": "ES"`, `"currency": "EUR"` y `"language": "es"`, esta API consulta AliExpress como un comprador con dirección en España y devuelve en JSON lo que enseña la ficha: título en español, precio y existencias de cada variante, desde qué país sale el paquete, coste y fecha estimada de entrega, valoraciones y número de reseñas. La API de afiliados y la de dropshipping son los programas oficiales de AliExpress para quien genera enlaces, importa productos a su tienda o tramita pedidos; esto es otra cosa: aquí no se gestiona nada, solo se lee el catálogo público. Los tres parámetros de mercado son independientes entre sí, y si no los mandas la respuesta llega pensada para Estados Unidos y en dólares.

Ejemplo que funciona

Esta funda salió en `search` con `"ship_from": "ES"`. En la ficha, el país de salida es una dimensión más de la variante («Envíos desde»): la misma versión para iPhone 15 Pro cuesta 7,49 € si sale de España, 12,89 € desde Polonia y 19,39 € desde Francia, con 15 unidades en cada caso. `price_min` solo dice cuánto cuesta la opción más barata, no desde dónde llega; si comparas precios de AliExpress en España, guarda cada variante con su valor de «Envíos desde» (el código de país está en `sku_properties[].value_details[].ships_from_code`). Ojo también al bloque `shipping`: en una consulta del 26 de octubre, para Madrid indicaba «1 days» y, a la vez, entrega el 2 de noviembre.

curl -X POST https://api.reefapi.com/aliexpress/v1/product_detail \
  -H "x-api-key: TU_CLAVE" \
  -H "content-type: application/json" \
  -d '{"product_id": "1005013082068926", "country": "ES", "currency": "EUR", "language": "es", "province": "Madrid"}'

{
  "ok": true,
  "data": {
    "product": {
      "product_id": "1005013082068926",
      "title": "Funda transparente de lujo para iPhone 16 15 11 12 13 14 Pro Max silicona TPU suave para iPhone XR XS Max 8 Plus funda trasera transparente",
      "price_min": 7.49,
      "price_max": 25.39,
      "currency": "EUR",
      "rating": 4.9,
      "review_count": 5104,
      "sold_count": null,
      "sold_text": "Este vendedor: 50.000+ ventas | Ventas totales: 50.000+",
      "total_stock": 45,
      "sku_properties": [
        {
          "name": "Envíos desde",
          "values": ["Polonia", "España", "Francia"],
          "value_details": [
            { "value_id": "203372089", "name": "Polonia", "ships_from_code": "PL", ... },
            { "value_id": "201336104", "name": "España", "ships_from_code": "ES", ... },
            { "value_id": "201336342", "name": "Francia", "ships_from_code": "FR", ... }
          ]
        },
        { "name": "Material", "values": ["For iPhone 15 Pro"], ... }
      ],
      "sku_variants": [
        {
          "sku_id": "12000060226024615",
          "props": { "Envíos desde": "España", "Material": "For iPhone 15 Pro" },
          "price": { "sale": 7.49, "sale_str": "7,49€", "currency": "EUR" },
          "stock": 15,
          "available": true
        },
        {
          "sku_id": "12000060226024617",
          "props": { "Envíos desde": "Polonia", "Material": "For iPhone 15 Pro" },
          "price": { "sale": 12.89, "sale_str": "12,89€", "currency": "EUR" },
          "stock": 15,
          "available": true
        },
        {
          "sku_id": "12000060226024616",
          "props": { "Envíos desde": "Francia", "Material": "For iPhone 15 Pro" },
          "price": { "sale": 19.39, "sale_str": "19,39€", "currency": "EUR" },
          "stock": 15,
          "available": true
        },
        {
          "sku_id": "12000060226024665",
          "props": { "Envíos desde": "Polonia", "Material": "501" },
          "price": { "sale": 25.19, "sale_str": "25,19€", "currency": "EUR" },
          "stock": 0,
          "available": false
        },
        ...
      ],
      "shipping": {
        "ship_to": "ES",
        "shipping_cost": 0.0,
        "free": true,
        "delivery_estimate": "1 days",
        "delivery_eta": "02 de NOV.",
        "ship_from": "España",
        "option_count": 3,
        "lines": ["Seguimiento no disponible", "Seguimiento del pedido disponible"]
      },
      ...
    }
  },
  "meta": { "record_count": 1, "variant_count": 81, "country": "ES", "currency": "EUR", "language_sent": "es", "province_sent": "Madrid", "cache_hit": false, "mode": "live" }
}

Límites y notas honestas

• Este servicio no lo ofrecen AliExpress ni Alibaba, ni cuenta con su aval: es un acceso independiente, sin ningún acuerdo de por medio.
• Sin `country`, `currency` y `language` se usan los valores por defecto (US, USD, en): precios en dólares y envío a Estados Unidos. Para España hay que mandar los tres en cada llamada.
• `search` no traduce: en tres búsquedas del 26 de octubre de 2026 con `"language": "es"` («funda iphone 16», la misma con `ship_from: "ES"` y «zapatillas running»), los 60 títulos llegaron en inglés, y el texto de ventas de las tarjetas, cuando lo había, también («50,000+ sold»). El título en español sale en `product_detail`; `sold_count` vino en null en las cuatro fichas, así que las ventas hay que leerlas en `sold_text`.
• El precio de la tarjeta de búsqueda puede no coincidir con la ficha. En dos de las cuatro que comparamos quedaba fuera del rango de la ficha: 2,32 € frente a 3,39–3,89 €, y 4,02 € frente a 3,09–3,79 €.
• En 3 de las 4 fichas consultadas, `store` devolvió la misma tienda (id 1103573332, con 10 valoraciones de vendedor). Es el mismo bloque que ya vimos en agosto de 2026 repetido, idéntico, en productos sin ninguna relación entre sí (una esterilla de yoga, un teclado, un cable USB-C): llega así en los datos de AliExpress, no lo pone nuestro parser, y sigue sin resolver. No atribuyas un producto a una tienda solo por ese bloque.
• Los plazos de `shipping` son los que publica AliExpress y no siempre cuadran: en la ficha del ejemplo, «1 days» convivía con una entrega estimada para el 2 de noviembre. El texto del plazo llega en inglés aunque la fecha venga en español.
• `product_detail` cuesta 2 créditos por llamada y el resto de endpoints, 1.
• No hay histórico de precios ni respuestas guardadas: cada llamada trae el precio de ese instante (`cache_hit: false`), y si quieres ver cómo evoluciona tendrás que ir guardándolo tú.