AliExpress Scraper

Slug: fatihtahta/aliexpress-scraper

Overview

AliExpress Scraper collects structured product data from AliExpress, including product identifiers, titles, prices, discounts, images, ratings, merchandising details, and source-page context. It supports search result pages, category pages, store catalog pages, individual product pages, and keyword-based discovery, giving you flexible ways to collect marketplace data at scale. AliExpress is one of the largest global ecommerce marketplaces, making it a useful source for pricing research, sourcing analysis, assortment tracking, and catalog intelligence. The actor automates repetitive collection work and returns records in a consistent structure that is easier to analyze and operationalize. This saves time, reduces manual effort, and helps teams keep datasets current with less overhead.

Why Use This Actor

• Market researchers and analysts: Track pricing, discounting, ratings, and product assortment across categories for benchmark reports, trend analysis, and competitor comparisons.
• Product and content teams: Discover popular listings, review merchandising patterns, and gather structured product inputs for catalogs, landing pages, and editorial planning.
• Developers and data engineers: Send analysis-ready records into ETL pipelines, data warehouses, dashboards, and downstream APIs with minimal cleanup.
• Lead generation and enrichment teams: Identify relevant products, brands, and listing patterns for sourcing workflows, supplier research, and marketplace enrichment.
• Monitoring and competitive tracking teams: Schedule recurring runs to watch changes in price, promotions, rating signals, and listing visibility over time.

Input Parameters

Provide any combination of URLs, queries, and filters to control what gets collected.

Parameter	Type	Description	Default
shipping_to	string	Required shipping destination country. This controls which items are considered shippable to that market and also influences the localized pricing and currency shown in results.	US
startUrls	string[]	One or more AliExpress URLs to scrape directly. Supports search result pages, category pages, store catalog pages, and individual product pages, and you can mix these page types in the same run.	prefill ["https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless%20earbuds"]
queries	string[]	Search keywords such as product names, brands, model numbers, or categories. Use this when you want the actor to discover matching listings through AliExpress search.	–
min_price	integer	Minimum price for query-based searches. Useful for excluding very low-priced items.	–
max_price	integer	Maximum price for query-based searches. Useful for keeping results within a target range.	–
sort	string	Sort order for query-based searches. Allowed values: best_match (Best Match First), most_ordered (Most Ordered First), lowest_price (Lowest Price First), highest_price (Highest Price First).	best_match
free_shipping	boolean	When true, keeps only products marked with free shipping in query-based searches.	false
on_sale	boolean	When true, keeps only products marked with sale promotions in query-based searches.	false
delivery_choice	boolean	When true, keeps only items marked with Delivery & service choice in query-based searches.	false
high_rated	boolean	When true, keeps only products rated 4 stars or higher in query-based searches.	false
premium_quality	boolean	When true, keeps only items labeled with premium quality tags in query-based searches.	false
enrich_data	boolean	When true, the actor makes extra HTTP requests for each saved product to fetch PDP detail data and adds an enrichment block with richer seller info, shipping, quantity, SKU details, specifications, and description links. This makes runs slower because each saved product triggers additional detail requests.	false
limit	integer	Maximum number of product listings to save for each seed. This caps discovered product listing rows only and does not cap review records or other derived outputs. Use lower values for quick validation and higher values for broader research, monitoring, or larger exports.	50000

Example Inputs

Example 1: Keyword discovery with quality filters

{
  "shipping_to": "US",
  "queries": ["portable air purifier", "wireless earbuds"],
  "min_price": 5,
  "max_price": 50,
  "sort": "most_ordered",
  "free_shipping": true,
  "high_rated": true,
  "limit": 1000
}

Example 2: Scrape specific search and product URLs directly

{
  "shipping_to": "US",
  "startUrls": [
    "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless%20earbuds",
    "https://www.aliexpress.com/item/1005009916186943.html"
  ],
  "enrich_data": true,
  "limit": 200
}

Example 3: Budget sourcing for sale items

{
  "shipping_to": "MY",
  "queries": ["phone tripod", "ring light"],
  "max_price": 25,
  "sort": "lowest_price",
  "on_sale": true,
  "delivery_choice": true,
  "limit": 5000
}

Example 4: Premium product research

{
  "shipping_to": "FR",
  "queries": ["mechanical keyboard", "gaming mouse"],
  "min_price": 20,
  "sort": "best_match",
  "high_rated": true,
  "premium_quality": true,
  "limit": 3000
}

Example 5: Listing scrape with product-page enrichment

{
  "shipping_to": "SG",
  "queries": ["air purifier"],
  "sort": "most_ordered",
  "enrich_data": true,
  "limit": 100
}

Output

6.1 Output destination

The actor writes results to an Apify dataset as JSON records. And the dataset is designed for direct consumption by analytics tools, ETL pipelines, and downstream APIs without post-processing.

6.2 Record envelope (all items)

Every dataset record includes these stable identifiers:

• type (string, required): Record category. Product rows use product; review rows use review.
• id (number, required): Stable AliExpress identifier for the record.
• url (string, required): Canonical AliExpress URL for the record.

Recommended idempotency key: type + ":" + id

Use this key to deduplicate repeated discoveries of the same entity and to perform reliable upserts across repeated runs.

6.3 Examples

Example: product (type = "product")

{
  "type": "product",
  "id": 3256809729872191,
  "url": "https://www.aliexpress.com/item/3256809729872191.html",
  "product": {
    "product_id": "3256809729872191",
    "title": "Air Purifier Smoke Odor Negative Ion Generator USB Portable Air Cleaner for Household HEPA Filter Efficient Purifying Air",
    "item_type": "productV3",
    "product_type": "natural",
    "native_card_type": "nt_srp_cell_g",
    "item_card_type": "app_us_local_card",
    "transitionary_exp_frame": false,
    "launch_time": "2025-10-20 00:00:00",
    "seo_white": "false"
  },
  "pricing": {
    "currency_code": "USD",
    "current_price": 9.33,
    "current_price_display": "US $9.33",
    "original_price_display": "US $27.66",
    "discount_percent": 66
  },
  "media": {
    "primary_image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S1a6aaf58890d441e8897bf2241120e30Q.png",
    "gallery": [
      {
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S1a6aaf58890d441e8897bf2241120e30Q.png",
        "image_width": 350,
        "image_height": 350,
        "image_type": "0"
      },
      {
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S867b3362bca349e8a22fedbbf737d0ffM.png",
        "image_width": 350,
        "image_height": 350,
        "image_type": "0"
      },
      {
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S498451565cad4f6a8c3138647cfcc97eP.png",
        "image_width": 350,
        "image_height": 350,
        "image_type": "0"
      },
      {
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S9c97ad73e83a42e58f01e3bc8b4e781dl.png",
        "image_width": 350,
        "image_height": 350,
        "image_type": "0"
      },
      {
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S137392c7e4d74cf2ac84167f30c3c60bX.png",
        "image_width": 350,
        "image_height": 350,
        "image_type": "0"
      },
      {
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S66b2e4a1637d4593a8f116cccee6a5af2.png",
        "image_width": 350,
        "image_height": 350,
        "image_type": "0"
      }
    ],
    "extra_parameters": {
      "sku_images": "H4sIAAAAAAAAABXLuQ2AMAwAwI1Q/CdhDCZwHIMEFOxfAf0dcCfVvkUisQcKA7EGVh3NCrTkAjFG3sv5HCu2vslMMBMPMPnGdPKZzhS4g3mN65cvWMVG4VcAAAA="
    }
  },
  "sales": {
    "trade_description": "2,000+ sold",
    "rating": 4.9
  },
  "merchandising": {
    "featured_offer": {
      "rainbow_type": "channelProduct",
      "title": "Dollar Express",
      "url": "https://www.aliexpress.com/ssr/300000512/BundleDeals2?productIds=1005009916186943:12000050569650089&pha_manifest=ssr&_immersiveMode=true&disableNav=YES&sourceName=SEARCHProduct",
      "need_replace_url": true
    },
    "selling_points": [
      {
        "selling_point_tag_id": "m0000094",
        "position": 1,
        "tag_style_type": "default",
        "tag_content": {
          "display_tag_type": "image",
          "tag_image_url": "https://ae01.alicdn.com/kf/S1887a285b60743859ac7bdbfca5e0896Z/154x64.png",
          "tag_image_width": 154,
          "tag_image_height": 64,
          "tag_style": {
            "position": "1"
          }
        },
        "source": "choice_atm",
        "resource_code": "searchItemCard"
      },
      {
        "selling_point_tag_id": "m0000026",
        "position": 1,
        "tag_style_type": "default",
        "tag_content": {
          "display_tag_type": "image",
          "tag_image_url": "https://ae01.alicdn.com/kf/Sb6a0486896c44dd8b19b117646c39e36J/116x64.png",
          "tag_image_width": 116,
          "tag_image_height": 64,
          "tag_style": {
            "position": "1"
          }
        },
        "source": "bigSale_atm",
        "resource_code": "searchItemCard"
      },
      {
        "selling_point_tag_id": "m0000155",
        "position": 4,
        "tag_style_type": "default",
        "tag_content": {
          "display_tag_type": "image_text",
          "tag_text": "Save $18.33",
          "tag_image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S9957aad5196c404bbae29db0392ef0b24/45x60.png",
          "tag_image_width": 45,
          "tag_image_height": 60,
          "tag_style": {
            "color": "#F00633",
            "is_price_power": "false",
            "position": "4"
          }
        },
        "source": "bigSale_discount",
        "resource_code": "searchItemCard"
      }
    ],
    "available_actions": [
      {
        "action_text": "Add to cart",
        "action_type": "shopCart"
      },
      {
        "action_text": "See preview",
        "action_type": "quickView"
      },
      {
        "action_text": "Similar items",
        "action_type": "similarItems"
      }
    ],
    "product_detail_url": "https://www.aliexpress.com/ssr/300000512/BundleDeals2?_immersiveMode=true&disableNav=YES&pha_manifest=ssr&productIds=1005009916186943%3A12000050569650089&sourceName=SEARCHProduct"
  },
  "platform_metadata": {
    "display_configuration": {
      "evaluation": {
        "show_single_rating": "false"
      },
      "rainbow": {
        "hide": "false"
      },
      "action": {
        "close_animation": "false"
      },
      "prices": {
        "is_price_power": "false"
      }
    }
  },
  "source_context": {
    "product_url": "https://www.aliexpress.com/item/3256809729872191.html",
    "source_page_url": "https://www.aliexpress.com/w/wholesale-Air-Purifier.html",
    "extraction_method": "embedded_json",
    "seed_id": "04d47afff27e",
    "seed_type": "url",
    "seed_value": "https://www.aliexpress.com/w/wholesale-Air-Purifier.html",
    "page_index": 1,
    "scraped_time": "2026-03-24T04:39:37.002516+00:00"
  },
  "enrichment": {
    "status": "success",
    "source": "product_detail_http_api",
    "request": {
      "api": "mtop.aliexpress.pdp.pc.query",
      "country": "US",
      "currency_code": "USD",
      "client_type": "pc",
      "product_id": "3256809729872191"
    },
    "reviews": {
      "rating": 4.9,
      "reviews_count": 124,
      "trade_description": "2,000+ sold"
    },
    "inventory": {
      "total_available_inventory": 87,
      "max_buy_count": 5
    },
    "shipping": {
      "delivery_provider_name": "AliExpress Selection Standard Shipping",
      "delivery_date": "Apr. 20",
      "ship_to": "United States"
    },
    "seller": {
      "store_name": "Example Store",
      "seller_positive_rate": 95.4
    },
    "description": {
      "pc_desc_url": "https://aeproductsourcesite.alicdn.com/product/description/pc/v2/en_US/desc.htm?productId=3256809729872191"
    }
  }
}

When enrich_data is disabled, records keep the current listing-only structure and the enrichment block is omitted.

Example: review (type = "review")

{
  "type": "review",
  "product": {
    "product_id": "1005010098248212",
    "title": "EVA Kaymaz Erkek Terlikleri Ev Kalin Tabanli Terlikler Rahat Hafif Ic Mekan Dis Mekan Ev Terlikleri"
  },
  "source_context": {
    "product_url": "https://www.aliexpress.com/item/1005010098248212.html",
    "source_page_url": "https://www.aliexpress.com/w/wholesale-slippers.html?SearchText=slippers&g=y&pr=-20",
    "parent_record_type": "product"
  },
  "review_metadata": {
    "review_id": "60094373571227451",
    "current_page": 1,
    "total_pages": 42,
    "total_reviews": 828,
    "evaluation_id": 60094373571227450,
    "evaluation_id_str": "60094373571227451",
    "eval_date": "16 Dec 2025",
    "review_type": "REVIEW",
    "selected_review": true,
    "sku_id": 12000051136225964,
    "sku_info": "Color:Beige Shoe Size:42-43",
    "status": "1"
  },
  "reviewer": {
    "aigc": false,
    "anonymous": false,
    "buyer_add_fb_days": 0,
    "buyer_country": "BR",
    "buyer_eval": 100,
    "buyer_fb_type": {
      "crowd_sourcing_person_name": "AliExpress Shopper",
      "source_lang": "en",
      "type_translation_accepted": "crowdsourcing"
    },
    "buyer_head_portrait": "http://ae01.alicdn.com/kf/A48e20a0a9438487ba81da722706d96bay.jpg_220x220.jpg",
    "buyer_name": "J***r"
  },
  "review_content": {
    "buyer_feedback": "Tem uma qualidade boa, um pouco durinho mas conforme for usando vai amaciando. A cor e bonita, e combina com tudo",
    "buyer_translation_feedback": "It has good quality, a bit stiff but it will soften with use. The color is beautiful and matches everything.",
    "images": [
      "https://ae01.alicdn.com/kf/Ab1f639e717354927950631f8870d6fc2m.jpg"
    ],
    "thumbnails": [
      "http://ae01.alicdn.com/kf/Ab1f639e717354927950631f8870d6fc2m.jpg_220x220.jpg"
    ],
    "logistics": "Aliexpress Selection Standard",
    "same_purchase_suggestion": "Buy the same",
    "selected_icon": "https://ae01.alicdn.com/kf/S2df5f3fa0d8242b1a0bbb1cc92cab109P/221x221.png",
    "independent_site": false,
    "third_party": false,
    "trendyol": false,
    "up_vote_count": 5,
    "down_vote_count": 0
  }
}

Field reference

Product fields (type = "product")

• type (string, required): Record type.
• id (number, required): Stable AliExpress product identifier.
• url (string, required): Canonical product URL.
• product.product_id (string, optional): Product identifier from the source payload.
• product.title (string, optional): Product title.
• product.item_type (string, optional): Source item classification.
• product.product_type (string, optional): Product type label.
• product.native_card_type (string, optional): Display card type.
• product.item_card_type (string, optional): Item card variant.
• product.transitionary_exp_frame (boolean, optional): Display-related flag.
• product.launch_time (string, optional): Launch timestamp when available.
• product.seo_white (string, optional): Source SEO flag.
• pricing.currency_code (string, optional): Currency code for pricing.
• pricing.current_price (number, optional): Current product price.
• pricing.current_price_display (string, optional): Current price as displayed.
• pricing.original_price_display (string, optional): Original or list price as displayed.
• pricing.discount_percent (number, optional): Discount percentage.
• media.primary_image_url (string, optional): Primary product image URL.
• media.gallery (array[object], optional): Product image gallery.
• media.gallery[].image_url (string, optional): Gallery image URL.
• media.gallery[].image_width (number, optional): Gallery image width in pixels.
• media.gallery[].image_height (number, optional): Gallery image height in pixels.
• media.gallery[].image_type (string, optional): Gallery image type value.
• media.extra_parameters.sku_images (string, optional): Additional image-related parameter.
• sales.trade_description (string, optional): Sales text, such as units sold.
• sales.rating (number, optional): Product rating.
• merchandising.featured_offer.rainbow_type (string, optional): Featured offer classification.
• merchandising.featured_offer.title (string, optional): Featured offer title.
• merchandising.featured_offer.url (string, optional): Featured offer URL.
• merchandising.featured_offer.need_replace_url (boolean, optional): Featured offer flag.
• merchandising.selling_points (array[object], optional): Merchandising badges or highlights.
• merchandising.selling_points[].selling_point_tag_id (string, optional): Selling-point identifier.
• merchandising.selling_points[].position (number, optional): Selling-point position.
• merchandising.selling_points[].tag_style_type (string, optional): Selling-point style type.
• merchandising.selling_points[].tag_content.display_tag_type (string, optional): Tag content type.
• merchandising.selling_points[].tag_content.tag_text (string, optional): Tag text when present.
• merchandising.selling_points[].tag_content.tag_image_url (string, optional): Tag image URL.
• merchandising.selling_points[].tag_content.tag_image_width (number, optional): Tag image width.
• merchandising.selling_points[].tag_content.tag_image_height (number, optional): Tag image height.
• merchandising.selling_points[].tag_content.tag_style.position (string, optional): Tag display position.
• merchandising.selling_points[].tag_content.tag_style.color (string, optional): Tag color value.
• merchandising.selling_points[].tag_content.tag_style.is_price_power (string, optional): Price-power flag.
• merchandising.selling_points[].source (string, optional): Selling-point source.
• merchandising.selling_points[].resource_code (string, optional): Resource code.
• merchandising.available_actions (array[object], optional): Available actions shown with the listing.
• merchandising.available_actions[].action_text (string, optional): Action label.
• merchandising.available_actions[].action_type (string, optional): Action type.
• merchandising.product_detail_url (string, optional): Related detail or promotional URL.
• platform_metadata.display_configuration.evaluation.show_single_rating (string, optional): Rating display flag.
• platform_metadata.display_configuration.rainbow.hide (string, optional): Rainbow visibility flag.
• platform_metadata.display_configuration.action.close_animation (string, optional): Action animation flag.
• platform_metadata.display_configuration.prices.is_price_power (string, optional): Price display flag.
• source_context.product_url (string, optional): Product URL observed during collection.
• source_context.source_page_url (string, optional): Source results or category page URL.
• source_context.extraction_method (string, optional): Source extraction label.
• source_context.seed_id (string, optional): Seed identifier for the discovery context.
• source_context.seed_type (string, optional): Seed category, such as URL or query.
• source_context.seed_value (string, optional): Original input used to discover the record.
• source_context.page_index (number, optional): Page number when available.
• source_context.scraped_time (string, optional): ISO timestamp for when the record was collected.
• enrichment (object, optional): Present only when enrich_data = true. Contains detail-page PDP data such as request context, seller info, shipping, quantity, SKU details, specifications, and description links.

Review fields (type = "review")

• type (string, required): Record type.
• product (object, optional): Parent product identifiers copied onto the review row.
• seller (object, optional): Parent seller info, including seller_admin_seq when available.
• source_context (object, optional): Parent product URL, source page URL, and parent_record_type.
• review_metadata (object, optional): Review-level identifiers and pagination fields such as review_id, current_page, total_pages, total_reviews, evaluation IDs, SKU references, status, and selection flags.
• reviewer (object, optional): Reviewer attributes such as anonymity, country, score, display name, avatar, and buyer feedback type.
• review_content (object, optional): The review body and delivery-specific fields such as translated text, images, thumbnails, vote counts, logistics, and any remaining AliExpress review payload fields not classified as metadata or reviewer info.

Data guarantees & handling

• Best-effort extraction: fields may vary by region, session, availability, and UI experiments.
• Optional fields: null-check in downstream code.
• Deduplication: recommend type + ":" + id.

How to Run on Apify

1. Open the Actor in Apify Console.
2. Configure your input using one or more product, search, or category URLs, or enter one or more search queries.
3. Set any filters you want to apply, such as price range, sort order, shipping, sale status, or minimum rating.
4. Set the maximum number of outputs to collect.
5. Click Start and wait for the run to finish.
6. Download results in JSON, CSV, Excel, or other supported formats.

Scheduling & Automation

Scheduling

Automated Data Collection

You can schedule runs to keep your dataset fresh without starting each run manually. This is useful for recurring price checks, assortment monitoring, and regular marketplace reporting.

• Navigate to Schedules in Apify Console
• Create a new schedule (daily, weekly, or custom cron)
• Configure input parameters
• Enable notifications for run completion
• Optional: Add webhooks for automated processing

Integration Options

• Webhooks: Trigger downstream actions when a run completes
• Zapier: Connect to 5,000+ apps without coding
• Make (Integromat): Build multi-step automation workflows
• Google Sheets: Export results to a spreadsheet
• Slack/Discord: Receive notifications and summaries
• Email: Send automated reports via email

Performance

Estimated run times:

• Small runs (< 1,000 outputs): ~2–3 minutes
• Medium runs (1,000–5,000 outputs): ~5–15 minutes
• Large runs (5,000+ outputs): ~15–30 minutes

Execution time varies based on filters, result volume, and how much information is returned per record.

Compliance & Ethics

Responsible Data Collection

This actor collects publicly available product and marketplace listing information from https://www.aliexpress.com for legitimate business purposes. Common use cases include ecommerce research and market analysis, pricing and assortment monitoring, and sourcing or catalog enrichment. Users are responsible for ensuring their collection and use of data complies with applicable laws, regulations, and the platform's terms. This section is informational and not legal advice.

• Ecommerce research and market analysis
• Pricing and assortment monitoring
• Sourcing and catalog enrichment

Best Practices

• Use collected data in accordance with applicable laws, regulations, and the target site's terms
• Respect individual privacy and personal information
• Use data responsibly and avoid disruptive or excessive collection
• Do not use this actor for spamming, harassment, or other harmful purposes
• Follow relevant data protection requirements where applicable (e.g., GDPR, CCPA)

Support

If you need help, use the Issues tab or the actor page in Apify Console. Include the input you used with sensitive values redacted, the run ID, a short note describing expected versus actual behavior, and, if useful, a small output sample so the issue can be reproduced more quickly.