Skip to main content

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

Updated 5 min readMarkdown

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.

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.

No comments yet. Be the first to comment.