Search AliExpress or fetch product, store, and review records by ID or URL across 18 regional storefronts and 42 currencies, with price, rating, and ship-from/ship-to filters. Output fields: title, sa
Search AliExpress or fetch product, store, and review records by ID or URL across 18 regional storefronts and 42 currencies, with price, rating, and ship-from/ship-to filters.
vexaloom-labs~aliexpress-multi-region-search-store-and-review)references/example-input.jsonreferences/input-schema.jsonreferences/output-fields.jsonUse this skill when the user wants:
Do not use it for private, login-protected or paywalled data.
One JSON row per result. Columns from the Actor's dataset schema:
title: TitleproductId: Product IdsalePrice: Sale PriceoriginalPrice: Original PricecurrencyCode: Currency CodediscountPercent: Discount Percentrating: RatingordersCount: Orders CountshipFromCountry: Ship From CountryproductUrl: Product UrlisSponsored: Is Sponsored| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| mode | string | yes | search | What to collect. search: keyword results. byProduct: product lookup by ID or URL. byStore: store lookup. byReviews: customer reviews. |
| searchQueries | array | no | | One or more keywords, e.g. "phone case" or "wireless earbuds". Each query is scraped up to maxPages pages. |
| productIds | array | no | | Numeric AliExpress product IDs or item URLs. Both 1005… and 3256… ID formats are accepted. |
| storeIds | array | no | | Numeric store IDs or /store/… URLs. |
| urls | array | no | | Any mix of search, item, store and review URLs. The mode is detected per URL. |
| region | string | no | US | Country used for prices, availability and the storefront locale. Global leaves the region to the requesting IP. |
| currency | string | no | | Optional ISO-4217 currency. Leave blank to use the region's usual currency. The currency actually returned is recorded in every record. |
| language | string | no | en_US | Storefront language and the language used to translate review text. |
| sortBy | string | no | default | How keyword results are ordered. AliExpress does not expose a newest sort. |
| priceMin | number | no | 0 | Minimum price in the selected currency. 0 disables the lower bound. |
| priceMax | number | no | 0 | Maximum price in the selected currency. 0 disables the upper bound. |
| ratingMin | number | no | 0 | Minimum star rating from 0 to 5. Products without a rating are skipped when a threshold is set. |
| shipFrom | string | no | | Only show items stocked in this country. Leave blank for any warehouse. |
| freeShippingOnly | boolean | no | false | Only show items advertised with free shipping. |
10 more optional fields on the Actor's Input tab.
Example:
{
"mode": "search",
"region": "US",
"language": "en_US",
"sortBy": "default",
"priceMin": 0,
"priceMax": 0,
"ratingMin": 0,
"freeShippingOnly": false,
"choiceOnly": false,
"fourStarPlus": false,
"includeSponsored": true,
"includeWelcomeGifts": false,
"maxItems": 100,
"maxPages": 3,
"includeReviews": false,
"maxReviewsPerProduct": 20,
"reviewFilter": "all",
"includeProductStats": true,
"searchQueries": [
"keyword"
]
}
Set APIFY_TOKEN, then call the synchronous endpoint for small and medium runs (it waits up to 300 seconds):
curl -s -X POST "https://api.apify.com/v2/acts/vexaloom-labs~aliexpress-multi-region-search-store-and-review/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d @references/example-input.json > output.json
Or with Node 18+: node scripts/run.mjs [input.json].
For large runs, start an async run and read its dataset when it finishes:
RUN=$(curl -s -X POST "https://api.apify.com/v2/acts/vexaloom-labs~aliexpress-multi-region-search-store-and-review/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
-d @references/example-input.json)
RUN_ID=$(echo "$RUN" | jq -r '.data.id'); DATASET=$(echo "$RUN" | jq -r '.data.defaultDatasetId')
curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status'
curl -s "https://api.apify.com/v2/datasets/$DATASET/items?format=json" -H "Authorization: Bearer $APIFY_TOKEN" > output.json
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.