Piloterr

AliExpress Product

GET
/v2/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

Authentification

ApiKeyAuth
headerx-api-key<token>

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

Paramètres de requête

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.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corps de la réponse

Successful response

application/json
  1. response
faqs?array<unknown>
info?
pricing?
delivery?
specifications?array<>
Example Request
curl -X GET 'https://api.piloterr.com/v2/aliexpress/product?query=string'
Example Response
{  "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,    "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"    }  ]}

Alibaba Search GET

Précédent

AliExpress Reviews GET

Suivant