AliExpress Product Scraper — Product Search API for 18 Countries

Affiliate disclosure: Apify links on this page may include referral parameters. If you sign up through them, AgentX may receive a commission at no extra cost to you.

Search AliExpress by keyword and destination country, then export normalized product records with current price signals, discounts, sales text, ratings, shipping or delivery text, images, sponsored status, rank, and source links. Optional fields stay empty when AliExpress does not expose them for a result.

Run a minimum 10-result test with a specific model and one destination country before increasing volume.

---

Why Choose This API

Country-aware AliExpress search

Select one of 18 supported destination countries. Results can reflect localized ranking, currency, availability, and offer signals for that destination instead of using a post-search country label.

Source-linked product intelligence

Each publishable record keeps its query, search rank, product URL, and source URL. This makes price, assortment, promotion, and ranking observations easier to verify against the source response for that run.

Verifiable records without fabricated values

Delivered records retain source links and leave unavailable optional values empty. This gives downstream users a consistent dataset without inventing seller, price, availability, or identifier data.

Predictable normalized output

All records use the shared 58-field AgentX shopping schema. Fields that are not available for a particular AliExpress result remain empty instead of being invented.

---

Quick Start Guide

1. Open AliExpress Product Scraper.
2. Enter a product keyword, choose a supported country, and set max_results.
3. Click Start.
4. Review the default dataset and export the records you need.

Example input:

{
  "keyword": "wireless earbuds",
  "country": "United States",
  "max_results": 10
}

max_results is an upper bound. The delivered count can be lower when AliExpress exposes fewer usable public products for the selected keyword and country.

---

Input Parameters

Parameter	Type	Required	Limits	Description
keyword	string	Yes	Non-empty	Product, brand, category, or search phrase to extract AliExpress product data
country	string	Yes	Supported enum	AliExpress country/site setting to query
max_results	integer	Yes	10–10,000	Maximum number of AliExpress product records to return

Supported countries

Australia, Brazil, Canada, Chile, France, Germany, Italy, Japan, Mexico, Netherlands, Poland, Saudi Arabia, South Korea, Spain, Turkey, United Arab Emirates, United Kingdom, and United States.

This is a single-platform Actor. It does not expose a platforms input; use All Shopping Scraper when you need a multi-platform search.

---

Output Data Schema

The default dataset contains 58 fields. Source-dependent fields are nullable.

Group	Fields
Images and identity	main_image, image_urls, title, brand, badges, category, breadcrumbs, description, features, product_id, sku, gtin, mpn, model
Product details	specifications, manufacturer, origin, energy_class, included, condition, release_date, variant_group, variants
Price and promotions	price, was_price, unit_price, currency, price_text, discount_pct, discount_text, promo_text, installment_text
Availability and demand	stock_status, stock_text, sales_text, buy_limit, rating, review_count
Seller and fulfillment	seller, seller_url, seller_score, shipping_text, shipping_cost, delivery_text, pickup_text, return_text, return_days, warranty_text
Traceability	platform, site, country, product_url, source_url, query, rank, sponsored, processor, processed_at

Example record:

{
  "main_image": "https://ae01.alicdn.com/kf/example.jpg",
  "title": "Wireless Bluetooth Earbuds",
  "product_id": "1005000000000000",
  "price": 18.99,
  "was_price": 24.99,
  "currency": "USD",
  "price_text": "$18.99",
  "discount_pct": 24,
  "sales_text": "1,000+ sold",
  "rating": 4.6,
  "shipping_text": "Free shipping",
  "platform": "aliexpress",
  "site": "www.aliexpress.com",
  "country": "US",
  "product_url": "https://www.aliexpress.com/item/1005000000000000.html",
  "source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html",
  "query": "wireless earbuds",
  "rank": 1,
  "sponsored": false,
  "processor": "https://apify.com/agentx/aliexpress-product-scraper",
  "processed_at": "2026-07-20T00:00:00.000Z"
}

The example illustrates the schema, not a live product promise. Real rows contain only the values exposed and accepted during that run.

---

Integration Examples

Apify Console and dataset exports

Run the Actor from its Store page, inspect the default dataset, and export data in the formats made available by Apify. The run exposes its dataset reference for downstream automation.

Scheduled monitoring workflow

Use a stable keyword, country, and result limit for each scheduled run. Compare product_id or product_url across datasets, and retain query, rank, source_url, and processed_at when evaluating changes.

Actor API and MCP

{
  "actorId": "30q96KJJJKp3ruehY",
  "input": {
    "keyword": "wireless earbuds",
    "country": "United States",
    "max_results": 10
  }
}

Use the Actor API tab for token-aware examples. For AI clients, follow the official Apify MCP guide and pass the same explicit input object. The runtime does not manufacture missing required values.

---

Pricing & Cost Calculator

Each Actor start has an apify-actor-start event price of $0.01. Delivered dataset records use the result event:

Account tier	Actor start	Price per delivered result	Total for 10 delivered results
FREE	$0.01000	$0.00520	$0.06200
BRONZE	$0.01000	$0.00503	$0.06030
SILVER	$0.01000	$0.00485	$0.05850
GOLD	$0.01000	$0.00468	$0.05680
PLATINUM	$0.01000	$0.00468	$0.05680
DIAMOND	$0.01000	$0.00468	$0.05680

Charges apply to delivered result events, not the requested max_results value. Review the live pricing panel before a large run because Store pricing can change after this README is published.

---

Compared with alternatives

Option	Best fit	Important trade-off
AliExpress Product Scraper	Repeatable keyword snapshots across 18 destination-country contexts	Public observations only; localization and seller data can vary
All Shopping Scraper	Compatible multi-platform product research from one workflow	Broader results require more product-matching judgment
Manual AliExpress browsing	A few visual checks where a person reviews every seller and variant	Slow to repeat and difficult to audit at scale
Authorized merchant tooling	Managing a seller's own catalog, price, and fulfillment	Different credentials, scope, and purpose

Choose this Actor for structured public search collection. Keep manual listing review for supplier selection, authenticity, delivery, tax, and purchase decisions.

---

Use Cases & Applications

• Compare localized AliExpress prices, promotions, and ranking for the same keyword.
• Research product assortment and public sales or rating signals.
• Build source-linked product shortlists for manual supplier evaluation.
• Monitor price text, discount, promotion, shipping, and delivery changes over successive runs.
• Enrich internal catalogs with titles, images, identifiers, and traceable product URLs.

The dataset supports research and monitoring; it does not verify seller identity, product authenticity, inventory, delivery performance, or future price availability.

---

FAQ

What does each delivered record represent?

Each record represents a usable public AliExpress result collected during that run. Use query, rank, product_url, source_url, and processed_at to review its source context.

Can a run return fewer records than max_results?

Yes. max_results is an upper bound, while the delivered count depends on the usable public products available for the selected keyword and country during that run.

Why are some fields empty?

AliExpress exposes different fields by result, country, page, and product. Missing values remain empty rather than being inferred.

Are prices and rankings historical?

No. Each record represents the public response processed during that run. Save successive datasets if you need history.

Does country guarantee the same currency or assortment every time?

Results use the selected destination-country context, but AliExpress still controls localization, ranking, availability, currency, and the values returned.

Can I request more than 10,000 products?

No. The public input accepts 10 through 10,000. A run may deliver fewer usable products than requested.

Can I select another marketplace?

Not in this Actor. Use All Shopping Scraper for supported multi-platform searches.

---

Legal & Compliance

Use the Actor and exported data only when permitted by applicable law, the current AliExpress Terms of Use, and your own compliance requirements. The Actor does not grant intellectual-property, resale, privacy, or marketplace usage rights. Users remain responsible for their inputs, retention, and downstream use.

---

Related Tools

Related product scrapers

• Bol Product Scraper
• Hepsiburada Product Scraper
• Rakuten Product Scraper

Enrich with AgentX

• All Shopping Scraper
• All Jobs Scraper
• All Property Scraper

---

Support & Community

• Open the Actor
• Explore AgentX APIs
• Telegram community: @Apify_Actor
• Direct support: @AiAgentApi

When reporting a result issue, include the input, run identifier, affected source_url, and a small sample of unexpected rows. Do not publish private tokens.

Last updated: July 21, 2026. Maintained by AgentX.