The AliExpress Product API retrieves full product detail page (PDP) data from an AliExpress /item/ URL. Pass a product page URL and receive structured JSON with title, images, seller identity, pricing, specifications, delivery estimates, and FAQs.
AliExpress product pages are JavaScript single-page applications — Piloterr uses browser rendering to load the PDP and extract parsed fields. Pair with AliExpress Search to discover product URLs, then fetch full details here.
GET https://api.piloterr.com/v2/aliexpress/product?query=https://www.aliexpress.com/item/1005009517624640.html
Via POST:
POST https://api.piloterr.com/v2/aliexpress/product
Content-Type: application/json
{"query": "https://www.aliexpress.com/item/1005009517624640.html", "return_page_source": false}
Parameter
Type
Required
Description
querystring
yes
Full AliExpress product URL
return_page_sourceboolean
no
Return raw HTML as {"result": "..."} (default: false)
https://www.aliexpress.com/item/1005009517624640.html
https://es.aliexpress.com/item/1005012069266068.html?spm=...
Locale subdomains supported (es., fr., …)
Tracking query params preserved in info.link
Page fetched via canonical /item/ URL (without query params)
Bundle / SSR links (productIds=..., /ssr/BundleDeals2)
URLs without /item/{id}
Non-AliExpress domains
Field
Type
Always present
Description
product_idinteger
yes
AliExpress numeric product ID
namestring
yes
Product title (missing → 404)
linkstring
yes
Input URL with query params preserved
mediastring[]
yes
Image URLs (960×960 when available)
ratenumber | null
yes
Star rating, 1 decimal; null if absent
reviewsinteger | null
yes
Review count; null if absent
sold_countinteger
yes
Units sold (0 if not displayed)
available_countinteger
yes
Available stock (0 if not displayed)
seller_namestring | null
yes
Seller name from /store/{id} link
seller_idstring | null
yes
Seller store ID
Field
Type
Always present
Description
pricenumber
yes
Current sale price (missing → 404)
price_currencystring | null
yes
ISO 4217 code (EUR, USD, …)
original_pricenumber | string
yes
Strikethrough price or "No discount"
discountstring
yes
Discount label or "No discount"
Object or null if the delivery block is absent on the page.
Field
Type
Description
pickup_methodstring
e.g. "Pick-up points"
shipping_costnumber
Shipping cost when displayed
shipping_cost_currencystring
ISO 4217 code
estimated_deliverystring
Estimated delivery window
Key
Type
Structure
specificationsarray
{ "name": string, "value": string }[]
faqsarray
{ "question": string, "answer": string }[]
Search — discover listings and listing_url valuesProduct — fetch full PDP JSON (this endpoint)
Code
Meaning
400Missing parameter or invalid / rejected URL
404Resource not found or not parseable
500Rendering or parsing error
A product page with no title or price returns 404 , not an empty 200 response.
Currency symbols are normalized to ISO 4217 (€ → EUR).
Ratings are floats rounded to 1 decimal place.
Seller identity is included inline (seller_name, seller_id).
Costs 2 credits per call (browser rendering).
Dropshipping validation — verify live price, stock, seller, and shippingCompetitive monitoring — track PDP changes across localesCatalog enrichment — populate databases with specs, images, and delivery dataSeller intelligence — link product listings to store IDs This is not an official API. Piloterr is an independent data provider and is not affiliated with, endorsed by, or sponsored by Piloterr or its owners. All trademarks belong to their respective owners.
