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
Autorisierung
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Abfrageparameter
query*string
Search 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?boolean
When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.
Antworttext
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.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 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}