AliExpress Scraper (Apify Actor)

Apify actor that scrapes AliExpress in four modes:

Input field	What it does	Backed by
searchUrls	Scrape AliExpress search-result pages	aliexpress.scrape_search
productUrls	Scrape full product detail pages	aliexpress.scrape_product
categoryUrls	Scrape products listed on category pages	aliexpress.find_aliexpress_products
productIdsForReviews	Scrape buyer reviews for a product	aliexpress.scrape_product_reviews

Each pushed item is tagged so a single dataset can hold mixed output:

```jsonc
{ "_type": "search_result", "_sourceUrl": "...", "title": "...", ... }
{ "_type": "product",       "_sourceUrl": "...", "name": "...", ... }
{ "_type": "category_item", "_sourceUrl": "...", ... }
{ "_type": "review",        "_sourceProductId": "1005006...", "rating": 5, ... }

Proxy

AliExpress aggressively blocks datacenter IPs. The default input enables Apify Proxy with the RESIDENTIAL group — this gives you the best chance of getting real data. You can also point at a custom proxy via the standard Apify proxy input fields.

The shim reads whichever URL Apify hands it through the PROXY_URL env var, and uses it for both httpx (search/category/reviews) and Chromium (product/search-with-render_js).

Run locally with the Apify CLI

npm install -g apify-cli           # one-time
apify login                        # paste your token from console.apify.com
cd aliexpress-actor
apify run --purge                  # builds the Docker image and runs once

To deploy to your Apify account:

$apify push

Then run from https://console.apify.com with whatever input you like.

Run on Apify without the CLI

1. Zip the contents of this folder (so the zip's top level contains .actor/, src/, Dockerfile, requirements.txt, README.md — not a single wrapper folder).
2. https://console.apify.com → Actors → Create new → Upload → drop the zip.
3. Click Build, wait ~3 min for the Docker image (Playwright + Chromium is the slow part).
4. Click Start, fill in the input, run.

Example input

{
  "searchUrls": [
    "https://www.aliexpress.com/wholesale?SearchText=mechanical+keyboard",
    "https://www.aliexpress.com/wholesale?SearchText=gpu+rtx+4060"
  ],
  "maxSearchPages": 2,
  "productUrls": [
    "https://www.aliexpress.com/item/3256805592859125.html"
  ],
  "productIdsForReviews": [
    "1005006717259012"
  ],
  "maxReviewPages": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Output (sample item shape)

// _type=search_result
{
  "_type": "search_result",
  "_sourceUrl": "https://www.aliexpress.com/wholesale?SearchText=mechanical+keyboard",
  "productId": "3256809981706062",
  "title": { "displayTitle": "..." },
  "image": { "imgUrl": "..." },
  "prices": { "salePrice": { "formattedPrice": "$24.50" } },
  "store": { "storeName": "..." }
  // ...all upstream fields preserved
}