# AliExpress Scraper data API: fields, sample output and cost per 1,000 rows

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](https://apify.com/v0iddo/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

```json
{
  "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](https://apify.com/v0iddo/aliexpress-scraper/examples/aliexpress-wireless-earbuds-search)
- [AliExpress best selling smart watches](https://apify.com/v0iddo/aliexpress-scraper/examples/aliexpress-smart-watch-best-selling)
- [AliExpress search results for LED strip lights](https://apify.com/v0iddo/aliexpress-scraper/examples/aliexpress-led-strip-lights-search)

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

```bash
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](https://apify.com/v0iddo/aliexpress-scraper)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/aliexpress-scraper/](https://voidd0.github.io/aliexpress-scraper/)

