AliExpress Scraper: how to get Prices, Sold Counts as JSON/CSV (API, Python, no code)
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 guide shows the output fields, a working input, and
Python, JavaScript and cURL code for the Actor v0iddo/aliexpress-scraper on Apify.
Open AliExpress Scraper on Apify
What data you get
One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.
| Field | Label | Type | Example |
|---|---|---|---|
productId | Product ID | text | 3256812972305397 |
title | Title | text | 2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate M... |
price | Price | number | 22.69 |
originalPrice | Original | number | 57.51 |
rating | Stars | number | 4.9 |
sold | Sold | number | 248 |
choice | Choice | true/false | false |
url | Product URL | URL | https://www.aliexpress.com/item/3256812972305397.html |
searchTerm | text | wireless earbuds | |
page | number | 1 | |
position | number | 1 | |
discountPercent | number | 60 | |
currency | text | USD | |
soldText | text | 248 sold | |
freeShipping | true/false | true | |
ad | true/false | false | |
image | text | https://ae-pic-a1.aliexpress-media.com/kf/Sa57a4580c1274b01988d5df3... |
Input example
This is the input that is pre-filled on the Actor page. Change the values for your own run.
{
"searchTerms": [
"wireless earbuds"
],
"maxPages": 1,
"maxItems": 20
}
| Input field | Type | What it does |
|---|---|---|
searchTerms | array | What you would type into the AliExpress search box, one per line. |
searchUrls | array | Optional aliexpress.com search URLs (https://www.aliexpress.com/w/wholesale-....html). |
sort | string | Sort order for search terms (URLs keep their own). |
maxPages | integer | How many result pages (60 products each) to read per search. |
includeAds | boolean | Keep promoted products (they are marked with ad = true). |
maxItems | integer | The run stops after this many result rows. |
Output sample
Real rows from a run of the Actor. Fields that name people are left out of the sample.
[
{
"searchTerm": "wireless earbuds",
"page": 1,
"position": 1,
"productId": "3256812972305397",
"title": "2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate Monitoring, Active Noise Cancellation Headphones, Waterproof for Daily...",
"price": 22.69,
"originalPrice": 57.51,
"discountPercent": 60,
"currency": "USD",
"rating": 4.9,
"sold": 248,
"soldText": "248 sold",
"choice": false,
"freeShipping": true,
"ad": false,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sa57a4580c1274b01988d5df3fa8e76cbx.jpg",
"url": "https://www.aliexpress.com/item/3256812972305397.html"
},
{
"searchTerm": "wireless earbuds",
"page": 1,
"position": 2,
"productId": "3256809799847416",
"title": "SK26 Bluetooth 5.4 Wireless Earphones Small Earbuds Sleeping Sport Invisible Headphones Bass Sound Quality Headset Sliding Cover",
"price": 6.5,
"originalPrice": 33.71,
"discountPercent": 80,
"currency": "USD",
"rating": 4.9,
"sold": 600,
"soldText": "600+ sold",
"choice": false,
"freeShipping": true,
"ad": false,
"image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc7e00ad6ceea40ae95b32b724322bea98.jpg",
"url": "https://www.aliexpress.com/item/3256809799847416.html"
}
]
Code: Python, JavaScript and cURL
Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/aliexpress-scraper.
Python (apify-client)
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {'searchTerms': ['wireless earbuds'], 'maxPages': 1, 'maxItems': 20}
run = client.actor("v0iddo/aliexpress-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
JavaScript (apify-client)
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const input = {
"searchTerms": [
"wireless earbuds"
],
"maxPages": 1,
"maxItems": 20
};
const run = await client.actor('v0iddo/aliexpress-scraper').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
cURL
curl -X POST "https://api.apify.com/v2/acts/v0iddo~aliexpress-scraper/run-sync-get-dataset-items" \
-H "Authorization: Bearer YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchTerms": ["wireless earbuds"], "maxPages": 1, "maxItems": 20}'
Price
$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. See the pricing tab for your plan. A new Apify account gets $5 of platform credit every month.
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 for one search; use narrower search terms to collect more products.
FAQ
What data does the AliExpress Scraper return?
Each result is one row in an Apify dataset. Fields include productId, title, price, originalPrice, rating, sold, choice, url, and more. The table above shows every field with an example value.
How do I use the AliExpress Scraper from Python?
Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/aliexpress-scraper with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.
Can I use it without writing code?
Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.
How much does it cost?
$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. A new Apify account gets $5 of platform credit every month.
How do I limit the number of results?
Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.
Can I send the results to Google Sheets, Make, Zapier or n8n?
Yes. Apify datasets connect to Google Sheets, Slack, Make, Zapier and n8n, and a webhook can call your own service when a run finishes. You can also export the dataset as JSON, CSV or Excel.
Open AliExpress Scraper on Apify
Related guides
- Coles Price Scraper: Scrape Coles Australia products by department, category or the specials pages: price, was price, unit price...
- Alibaba Scraper: Scrape Alibaba.com product offers by keyword: title, price range and quantity price tiers, minimum order, u...
- Vinted Product Scraper: Collect public Vinted listings by search word or catalog link: title, brand, size, condition, price with cu...