Piloterr

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

GET
/v2/aliexpress/search

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

Search keyword or full AliExpress search results URL.

Example (keyword):

meta

Resolves 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.0

Example (page 2):

https://www.aliexpress.com/w/wholesale-meta.html?page=2

Accepted URL patterns: /w/, /wholesale, searchText=, /af/

Notes:

  • Pass a keyword or copy the full search URL from aliexpress.com.
  • There is no page parameter — paginate by adding ?page=2 to the URL.
  • Use each result listing_url or product_id with 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.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

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
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}