leoworks/aliexpress-search-scraper
leoworks--aliexpress-search-scraperThis tool calls the Actor "leoworks/aliexpress-search-scraper" and retrieves its output results. Actor description: AliExpress search scraper: rank, price, sold count, ads flagged. AliExpress rank tracker mode. Use for search, price and sold count; for reviews use leoworks/aliexpress-reviews-classifier. keywords (+ tracked products). No login, ~6 s/20 results, rank history in your key-value store. Pay per result.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keywords": "<keywords>"
},
"name": "leoworks--aliexpress-search-scraper"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Order of the search results. Example values: "best_match" | best_match |
| country | No | Two-letter country code. Results, prices and product IDs depend on the region; the proxy exits in this country. Example values: "US" | US |
| currency | No | Three-letter currency code for prices (e.g. USD, EUR, GBP). Example values: "USD" | USD |
| keywords | Yes | **REQUIRED** Search terms, one per line (e.g. wireless earbuds, phone case). Example values: ["wireless earbuds"] | |
| maxPages | No | 60 products per page. Search mode: an upper bound next to the result cap (default 60 pages). Rank mode: how deep to look for tracked products (default 5 = top 300, up to 60). | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| includeAds | No | Keep sponsored products in search-mode results (flagged isAd). Organic rank never counts ads. Example values: true | |
| healthCheck | No | Internal: fail the run when results look degraded (used by the developer's scheduled checks). | |
| trackProducts | No | Optional. Product URLs or IDs (any AliExpress site). When set, the Actor runs in rank mode: one row per keyword × product with its organic rank (ads excluded), position, page, and the change since the previous run — or 'not found within N'. Charged as keyword-checked instead of per result. | |
| maxConcurrency | No | Keywords processed in parallel. Example values: 3 | |
| rankHistoryStore | No | Key-value store in your account that keeps the last rank of each keyword × product, so each row shows previousRank, rankChange (positive = moved up) and isNew. Leave empty to turn off. No extra charge. Example values: "aliexpress-rank-history" | aliexpress-rank-history |
| proxyConfiguration | No | Default Apify datacenter proxy (in the shipping country) works. Example values: {"useApifyProxy":true} | |
| residentialFallback | No | Retry failing pages through residential proxy in the shipping country. Example values: true | |
| maxResultsPerKeyword | No | Stop after this many products per keyword. Applied before the page count. Starts at 20 for a quick, low-cost first run; raise it up to 3,600 (60 pages). Example values: 20 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |