The AliExpress Search API returns product listings from AliExpress search and wholesale result pages. Pass a keyword (e.g. meta) or a full search URL and receive structured JSON with titles, prices, ratings, order counts, and pagination.
Keywords are resolved to wholesale search pages automatically. AliExpress search pages are JavaScript single-page applications. Piloterr uses browser rendering to load the page and extract listing data.
Use each result's listing_url with AliExpress Product for full PDP details and seller identity (seller_id, seller_name).
GET https://api.piloterr.com/v2/aliexpress/search?query=meta
Or pass a full wholesale URL:
GET https://api.piloterr.com/v2/aliexpress/search?query=https://www.aliexpress.com/w/wholesale-meta.html
Via POST:
POST https://api.piloterr.com/v2/aliexpress/search
Content-Type: application/json
{"query": "meta", "return_page_source": false}
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Search keyword or full AliExpress search URL |
return_page_source |
boolean |
no |
Return raw HTML as {"result": "..."} (default: false) |
| Format |
Example |
| Keyword |
meta → wholesale-meta.html |
| Wholesale URL |
https://www.aliexpress.com/w/wholesale-meta.html?spm=... |
| Paginated URL |
https://www.aliexpress.com/w/wholesale-meta.html?page=2 |
| Other patterns |
URLs containing /w/, /wholesale, searchText=, or /af/ |
There is no separate page parameter: include ?page=N in the URL to paginate.
| Field |
Type |
Always present |
Description |
product_id |
string |
yes |
AliExpress product ID |
title |
string |
yes |
Product title |
listing_url |
string |
yes |
Canonical URL: https://www.aliexpress.com/item/{id}.html |
image_url |
string |
yes |
Absolute thumbnail URL |
price |
number |
yes |
Sale price |
currency |
string |
yes |
ISO 4217 code (EUR, USD, …) |
condition |
string |
yes |
Always "new" |
rating |
number |
no |
Star rating, 1 decimal (e.g. 4.8) |
sold_count |
integer |
no |
Units sold when displayed on the card |
seller_name |
string |
no |
Seller name when available on the card |
seller_id |
string |
no |
Seller store ID when available on the card |
brand |
string |
no |
Brand name when available |
review_count |
integer |
no |
Review count when available |
Seller identity is always available on the AliExpress Product endpoint.
| Field |
Type |
Description |
page |
integer |
Current page (from URL, default 1) |
per_page |
integer |
Page size (typically 60) |
total_results |
integer |
Estimated total matching products |
total_pages |
integer |
Total pages available |
next |
boolean |
true if a next page exists |
- Search: discover listings by keyword or search URL (this endpoint)
- Product: fetch full PDP JSON from any
listing_url
| Code |
Meaning |
400 |
Missing or invalid query |
404 |
Search page not parseable or no results |
500 |
Rendering or parsing error |
- Currency codes are normalized to ISO 4217 (
EUR, not €).
- Ratings are floats rounded to 1 decimal place when present.
- Costs 2 credits per call (browser rendering).
- Dropshipping research: find trending products and prices by keyword
- Search rank tracking: monitor listing visibility across keywords and pages
- Catalog discovery: harvest
product_id and listing_url values at scale
- Product enrichment: chain Search → Product for seller and delivery data
