Piloterr

AliExpress Product

AliExpress Product API — scrape live /item/ product pages from a full URL. Get title, images, seller identity, pricing, specs, delivery, and FAQs as JSON via browser rendering.

Credit cost: 2 credits per call

GET
/v2/aliexpress/product

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full AliExpress product page URL (/item/{id}.html).

Example:

https://www.aliexpress.com/item/1005009517624640.html

Example (locale subdomain with tracking params):

https://es.aliexpress.com/item/1005012069266068.html?spm=...

Notes:

  • Pass the full product URL (not just the numeric ID).
  • Locale subdomains are supported (es., fr., de., …).
  • Query params (spm, pdp_ext_f, …) are preserved in info.link.
  • The page is fetched using the canonical /item/ URL without query params.
  • Rejected (400): bundle/SSR URLs (/ssr/, productIds=), non-/item/ URLs, non-AliExpress domains.
  • Use AliExpress Search to discover listing_url values first.
return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of parsed JSON. Defaults to false.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/aliexpress/product?query=string"
{
  "faqs": [],
  "info": {
    "link": "https://www.aliexpress.com/item/1005009517624640.html",
    "name": "Purificateur d'air désodorisant 24 heures, utilisation continue, lumière LED à couleur changeante, Purification complète de l'air, dépoussiérage",
    "rate": 5,
    "media": [
      "https://ae-pic-a1.aliexpress-media.com/kf/Se1f79370af2b4634bbfa9e1beadf9046C.jpeg_960x960q75.jpeg_.avif",
      "https://ae-pic-a1.aliexpress-media.com/kf/Sf9d5548be5f64e4c8ea0840d1685dfe0a.jpeg_960x960q75.jpeg_.avif",
      "https://ae-pic-a1.aliexpress-media.com/kf/S77e4c39b5540420ead87e47d010bb089M.jpeg_960x960q75.jpeg_.avif",
      "https://ae-pic-a1.aliexpress-media.com/kf/S2f998e36cac0433e86b8d36d16228b42Q.jpeg_960x960q75.jpeg_.avif",
      "https://ae-pic-a1.aliexpress-media.com/kf/Sae6e2b87c9014dbaa35c24ac5ff2df3c3.jpeg_960x960q75.jpeg_.avif",
      "https://ae-pic-a1.aliexpress-media.com/kf/S4af2669e607b42d0b85641c3160b8e19U.jpeg_960x960q75.jpeg_.avif"
    ],
    "reviews": 1,
    "seller_id": "1104914437",
    "product_id": 1005009517624640,
    "sold_count": 3,
    "seller_name": "Shop1104914437 Store",
    "available_count": 999
  },
  "pricing": {
    "price": 13.19,
    "discount": "No discount",
    "original_price": "No discount",
    "price_currency": "EUR"
  },
  "delivery": {
    "pickup_method": "Pick-up points",
    "shipping_cost": 20.42,
    "estimated_delivery": "juillet 08 - 15",
    "shipping_cost_currency": "EUR"
  },
  "specifications": [
    {
      "name": "Produit chimique à haute préoccupation",
      "value": "Aucun"
    },
    {
      "name": "Nom de marque",
      "value": "Docreate"
    },
    {
      "name": "Origine",
      "value": "CN (Origine)"
    },
    {
      "name": "Product Name",
      "value": "10W Air Revitaliser with Colour Changing  Light Refreshes Cleanses"
    },
    {
      "name": "Material",
      "value": "ABS"
    },
    {
      "name": "Size",
      "value": "18X17CM"
    }
  ]
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}