AliExpress Search
AliExpress Search API: search by keyword or wholesale URL and get product listings with prices, ratings, sold counts, and pagination as JSON via browser rendering.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringSearch keyword or full AliExpress search results URL.
Example (keyword):
metaResolves to a wholesale search page such as https://www.aliexpress.com/w/wholesale-meta.html.
Example (wholesale URL):
https://www.aliexpress.com/w/wholesale-meta.html?spm=a2g0o.productlist.search.0Example (page 2):
https://www.aliexpress.com/w/wholesale-meta.html?page=2Accepted URL patterns: /w/, /wholesale, searchText=, /af/
Notes:
- Pass a keyword or copy the full search URL from aliexpress.com.
- There is no
pageparameter: paginate by adding?page=2to the URL. - Use each result
listing_urlorproduct_idwith AliExpress Product for full PDP and seller data.
return_page_source?booleanWhen true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/aliexpress/search?query=string'{ "results": [ { "price": 36.99, "title": "Lunettes Intelligentes IA Meta AI Sans Fil à Changement de Couleur de Haute Qualité, Film Intelligent, Étanchéité IP65, Vidéo 2K, Traduction en Temps Réel", "currency": "EUR", "condition": "new", "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S4a87e08500774848bba251a21308e471l.jpg", "product_id": "1005012335698677", "sold_count": 1, "listing_url": "https://www.aliexpress.com/item/1005012335698677.html" }, { "price": 654.92, "title": "Oculus Quest 3 d'origine, 8 Go de RAM + 512 Go de stockage, écran 4K+ Infinite Display, résolution 2064x2208, batterie 5060 mAh, autonomie de 2,2 heures", "rating": 4.8, "currency": "EUR", "condition": "new", "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sc8f0a4c26b164cd08ded129e317f5a5aL.png", "product_id": "1005011541924400", "sold_count": 48, "listing_url": "https://www.aliexpress.com/item/1005011541924400.html" }, { "price": 8.39, "title": "HIBLOKS Ray-Ban Meta Wayfarer lunettes chargeur de câble de charge rapide pour RW4006/RW4008/RW4012/RW4010/RW4014 Portable sûr Type C", "rating": 4.5, "currency": "EUR", "condition": "new", "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S51d4975962144f30af5853775400fa69P.jpg", "product_id": "1005008808856805", "sold_count": 800, "listing_url": "https://www.aliexpress.com/item/1005008808856805.html" } ], "pagination": { "next": true, "page": 1, "per_page": 60, "total_pages": 94, "total_results": 5624 }}