AliExpress Scraper data API: fields, sample output and cost per 1,000 rows
Reference for AliExpress Scraper: output fields, a sample record and what a run costs. Scrape AliExpress search results into product rows: product ID, title, sale price, original price, discount, star rating, units sold, Choice and shipping fla...
Scrape AliExpress search results into product rows: product ID, title, sale price, original price, discount, star rating, units sold, Choice and shipping flags, delivery estimate, image and link.
This is the reference for the Actor v0iddo/aliexpress-scraper: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.
At a glance
| Actor | v0iddo/aliexpress-scraper |
| Store page | AliExpress Scraper |
| Output | one row per result, as JSON, CSV, Excel or HTML |
| Fields per row | 17 (7 number, 6 text, 3 true/false, 1 URL) |
| Cap on results | maxItems in the input |
| Price | $1.50 per 1,000 results |
Output fields
Each result is one row with these fields (fields that name people are left out):
| Field | Type | Meaning | Sample value |
|---|---|---|---|
productId |
text | Product ID | 3256811621288203 |
title |
text | Title | 2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate M... |
price |
number | Price | 13.52 |
discountPercent |
number | Discount % | 76 |
rating |
number | Stars | 4.9 |
sold |
number | Sold | 4000 |
choice |
true/false | Choice | false |
url |
URL | Product URL | https://www.aliexpress.com/item/3256811621288203.html |
searchTerm |
text | wireless earbuds | |
page |
number | 1 | |
position |
number | 1 | |
originalPrice |
number | 57.55 | |
currency |
text | USD | |
soldText |
text | 4,000+ sold | |
freeShipping |
true/false | false | |
ad |
true/false | false | |
image |
text | https://ae-pic-a1.aliexpress-media.com/kf/Sa57a4580c1274b01988d5df3... |
One record
{
"searchTerm": "wireless earbuds",
"page": 1,
"position": 1,
"productId": "3256811621288203",
"title": "2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate Monitoring, Active Noise Cancellation Headphones, Waterproof for Daily...",
"price": 13.52,
"originalPrice": 57.55,
"discountPercent": 76,
"currency": "USD",
"rating": 4.9,
"sold": 4000,
"soldText": "4,000+ sold",
"choice": false,
"freeShipping": false,
"ad": false,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sa57a4580c1274b01988d5df3fa8e76cbx.jpg",
"url": "https://www.aliexpress.com/item/3256811621288203.html"
}
Input parameters
| Parameter | Type | Required | Default | What it does |
|---|---|---|---|---|
searchTerms |
array | no | ["wireless earbuds"] | What you would type into the AliExpress search box, one per line. |
searchUrls |
array | no | Optional aliexpress.com search URLs (https://www.aliexpress.com/w/wholesale-....html). | |
sort |
string | no | best_match | Sort order for search terms (URLs keep their own). |
maxPages |
integer | no | 3 | How many result pages (60 products each) to read per search. |
includeAds |
boolean | no | true | Keep promoted products (they are marked with ad = true). |
maxItems |
integer | no | 300 | The run stops after this many result rows. |
Ready-made examples
Saved inputs on Apify: run one as it is, or copy it and change the values.
- AliExpress search results for wireless earbuds
- AliExpress best selling smart watches
- AliExpress search results for LED strip lights
Cost per 1,000 rows
$1.50 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.05 per 1,000.
| Results | Cost at the listed price | Cost at the lowest plan price |
|---|---|---|
| 100 | $0.15 | $0.10 |
| 1,000 | $1.50 | $1.05 |
| 10,000 | $15.00 | $10.50 |
| 100,000 | $150.00 | $105.00 |
The figures are the listed price times the number of results. The maxItems limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.
Get the rows as CSV over HTTP
One request starts a run, waits for it and returns the dataset. The format parameter picks the file type and fields picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.
curl -X POST "https://api.apify.com/v2/acts/v0iddo~aliexpress-scraper/run-sync-get-dataset-items?format=csv&fields=productId,title,price" \
-H "Authorization: Bearer YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchTerms": ["wireless earbuds"], "maxPages": 1, "maxItems": 20}'
Good to know
- Prices are in US dollars as shown to a visitor shipping to the United States.
- Units sold is the figure AliExpress shows, such as 1,000+ sold; soldText keeps the original wording.
- AliExpress shows at most 60 result pages (about 3,600 products) for one search; give more or narrower search terms to collect more products.
Links
- Actor on the Apify Store: AliExpress Scraper
- Guide with the Python and JavaScript code: https://voidd0.github.io/aliexpress-scraper/
Comments
Join the discussionNo comments yet. Be the first to comment.
