hirepulse/aliexpress-search-scraper
hirepulse--aliexpress-search-scraperDestructive
This tool calls the Actor "hirepulse/aliexpress-search-scraper" and retrieves its output results. Actor description: Search AliExpress by keyword to extract products, sale prices, original prices, discounts, exact orders, ratings, shipping signals, delivery estimates, SKU IDs and image galleries. Built for e-commerce research, dropshipping, n8n workflows and AI agents.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | best_match for relevance; orders for source-reported cumulative units sold; price_low or price_high for listing prices. Sold counts are not sales in a fixed time period. Example values: "best_match" | best_match |
| queries | No | AliExpress search keywords, one per item, up to 20 per run. Also accepts singular "query", "keyword", or "search". Example: ["yoga mat", "usb c cable"]. Example values: ["yoga mat"] | |
| ship_to | No | Delivery country as a two-letter ISO code. Prices and availability follow it, as on the website. Example: "DE". Default: "US". Example values: "US" | US |
| currency | No | Currency of all prices, one of the listed codes. Example: "EUR". Default: "USD". Example values: "USD" | USD |
| 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. | |
| max_price | No | Only products priced at or below this value, as a whole number. Example: 50. Optional; must not be below min_price. | |
| min_price | No | Only products priced at or above this value, as a whole number. Example: 5. Optional. | |
| use_paid_upstream | No | Off by default. Supported paid sources also require the owner-controlled HIREPULSE_ALLOW_PAID_UPSTREAM=1 environment setting. Keep false for all quality and smoke checks. | |
| max_results_per_query | No | Maximum products per keyword: 1–1,200, over at most 20 pages. Start with 5 to inspect relevance. Free-plan preview is capped at 100 products total per run. Source limits, repeated pages or blocking can produce fewer results; inspect the run summary. Example values: 5 |
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 |