New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →
GET/api/v2/aliexpress-products/

AliExpress Products Scraper

AliExpress products for a keyword or a search, category or item URL as typed JSON: title, current price, rating, review count and sold count, 60 per page. 1 credit per page. No AliExpress login, no proxies to manage.

Free API key · 1 credit per page of products · failed calls free

Last updated
// GET /api/v2/aliexpress-products/?queries=wireless earbuds · sample from the catalog
{
  "success": true,
  "data": {
    "url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html",
    "page": 1,
    "page_size": 60,
    "products": [
      {
        "productId": "1005006789012345",
        "title": "Wireless Earbuds Bluetooth 5.3 Noise Cancelling TWS Headphones",
        "productUrl": "https://www.aliexpress.us/item/1005006789012345.html",
        "searchQuery": "wireless earbuds",
        "priceCurrent": "US $12.99",
        "priceCurrency": "$",
        "ratingValue": 4.8,
        "reviewCount": 1240,
        "soldCount": 5000,
        "soldDescription": "5,000+ sold",
        "tags": "Bulk deal",
        "scrapedAt": "2026-06-18T12:00:00.000Z",
        "reviewsEnriched": true
      }
    ],
    "next_cursor": "zc1.eNpjYGBg...",
    "timing": {
      "total_s": 11.8,
      "search_pages_s": [
        4.1
      ],
      "enrich_s": 7.2
    },
    "enrichment": {
      "requested": 60,
      "enriched": 60
    }
  }
}
Copy for your AI agent
Quick answer

Scrapier's AliExpress Products Scraper returns products for a keyword or URL as JSON, a page at a time: title, priceCurrent, ratingValue, reviewCount, soldCount, productUrl and position. It costs 1 credit per successful call. Send one keyword or URL in queries. No AliExpress login is needed.

Every request is fetched live at call time · failed calls are free

AliExpress Products Scraper searches AliExpress for a keyword, or reads a search, category or item URL, and returns the products as rows: title, current price, rating, review count, sold count, tags and result position. Sort by price or orders and page through with a cursor to scrape aliexpress products at scale. Every response is structured JSON, ready to pass directly to an LLM. It is one of 2 AliExpress endpoints on the same API key used by 12,000+ developers. Next, follow next_cursor for page two.

What data can I extract with AliExpress Products Scraper?

Using this AliExpress Products Scraper, you can extract the following data from public AliExpress pages of products:

Product ID
Product title
Product URL
Current price
Price currency
Star rating
Review count
Sold count
Sold description
Promotion tags
Result position
Search query
Scraped time
Enrichment flag
Next-page cursor

Want the exact field names? See the example output.

Playground

Try AliExpress Products Scraper Live

Press Run to see the catalog sample. Add your API key and it runs a real call to the Scrapier API from your browser. The key is sent only to proxy.scrapier.io and never stored.

AliExpressAliExpress ProductsLive

Parameters
+ Run live with your API key
Response
Sample dataCatalog sample, run to see live data

How to use AliExpress Products Scraper

Hand it to your AI assistant, or run it yourself in five steps.

Copy to your AI assistant

Paste this into ChatGPT, Claude or Cursor and it knows how to call the scraper.

Use the Scrapier AliExpress Products Scraper to get public AliExpress pages of products. Endpoint: GET https://proxy.scrapier.io/api/v2/aliexpress-products/?queries={queries} with header "X-API-Key: YOUR_API_KEY" and a 210-second timeout. Send one value per call in queries; for a list, make one call per value, at most 3 in parallel. It returns JSON under data.products: productId, title, productUrl, searchQuery, priceCurrent, priceCurrency, ratingValue, reviewCount, soldCount, soldDescription, tags, scrapedAt. Each successful call costs 1 credit; failed calls are free. If you support MCP, run: claude mcp add -t http scrapier https://mcp.scrapier.io/mcp --header "X-API-Key: YOUR_API_KEY" and call run_scrape with endpoint "aliexpress-products" (find it with search_endpoints).
AliExpress Products Scraper MCP Server

Use this scraper from ChatGPT, Claude or Cursor. Point your assistant at Scrapier and it reads AliExpress pages of products on its own: no glue code, no scraping logic in your prompts.

MCP setup →

Run it yourself

  1. Get your free Scrapier API keySign up at app.scrapier.io; the free tier lets you try it first.
  2. Open AliExpress Products Scraper in the catalogIt lives under Scrapers / AliExpress, next to the other AliExpress tools.
  3. Enter a keyword or URLType a keyword such as wireless earbuds, or paste an AliExpress search, category or item URL, in queries. Pick sort_by, currency and region if you want.
  4. Send your API requestOne GET with your key in the X-API-Key header, or one run_scrape call from your agent. Set a 210-second client timeout.
  5. Save your resultsEach page comes back as JSON in data.products: store it as is, or flatten it to CSV. Pass data.next_cursor back as cursor to get the next page until it is null.

How to scale to bulk AliExpress pages of products

queries takes one value per call, so for a list you loop: one request per value. Within a search, pass back data.next_cursor unchanged to read the next page of products. Run up to 3 requests in parallel per API key; above that the API answers 429 with a Retry-After header, and throttled calls cost nothing. Each call is 1 credit and failed calls are free, so 1,000 pages of products cost 1,000 credits, inside the Hobby plan's 15,000.

Features

This AliExpress product extractor turns search results into rows you can rank, filter and store. It suits product research, price monitoring, dropshipping research and any workflow that needs AliExpress product data without parsing HTML.

It extracts, per page of products
  • PricepriceCurrent and priceCurrency on every product
  • Social proofratingValue, reviewCount and soldCount
  • Sortingsort_by orders by default, price ascending, price descending or orders
  • Localecurrency, region and locale set how prices show
  • Reviewsfetch_reviews fills in rating and review count per product
  • Pagingnext_cursor reads the next page of products

Proxies, retries and parsing run on Scrapier's side, so you send one request and get JSON back, at 1 credit per page of products and 0 credits for a failed call.

Use cases

  • Dropshipper searches a niche sorted by orders and reads soldCount and priceCurrent to shortlist products worth listing.
  • Price analyst runs the same keyword on a schedule and stores priceCurrent to track how prices move.
  • Market researcher collects ratingValue, reviewCount and tags across a category to see what sells and what buyers rate.
  • Sourcing manager compares products for a keyword by price and sold count before contacting suppliers.
  • AI engineer gives an agent a tool that searches AliExpress, so it can recommend products from live results and cite their URLs.

Running these from an agent? Use the MCP integration and let Claude or Cursor call the scraper directly.

Why choose this Scraper API?

Keyword or URL in one field.

Send a keyword, a search URL, a category URL or an item URL in queries and the scraper detects which it is.

Sort and locale in the request.

Choose sort_by, currency, region and locale on the first call and they stay locked for every following page.

One key for AliExpress and the rest of the catalog.

The same key and response envelope work across Scrapier's endpoints, so a product search can feed a reviews call without new code.

Input

The scraper takes one AliExpress keyword or URL per call in queries. It is required on the first call. Send parameters in the query string (GET) or as a JSON body (POST).

NameTypeRequiredDefaultDescription
queriesstringYes—An AliExpress search keyword, or a ready search, category or item URL (detected automatically). One per call. Required on the first call. Aliases: searchQueries, startUrls, query, q
cursorstringNo—Pass back data.next_cursor from the previous response, unchanged, to get the next page; null means the last page
sort_bystringNodefaultResult order, default default. Options: default, price_asc, price_desc, orders. Locked into the cursor
currencystringNoUSDCurrency for prices, default USD. Locked into the cursor
regionstringNoUSRegion code, default US. Locked into the cursor
localestringNoen_USLocale, default en_US. Locked into the cursor
fetch_reviewsbooleanNofalseFill in reviewCount and rating per product, default false. It adds one extra request per product, is heavy and time-boxed, and rows not finished in time carry reviewsEnriched false. Locked into the cursor
use_proxybooleanNotrueRoute through Scrapier's residential proxy pool, on by default. Leave as is
raw_databooleanNofalseReturn AliExpress's raw upstream payloads under raw_responses instead of the formatted items

One keyword or URL per call: to search ten keywords, make ten calls and page each with cursor. Booleans are the strings true or false.

Example input

POST body · input.json
{
  "queries": "wireless earbuds",
  "sort_by": "default",
  "currency": "USD",
  "region": "US",
  "locale": "en_US",
  "fetch_reviews": "false",
  "use_proxy": "true",
  "raw_data": "false"
}

Error codes

StatusMeaningBilledFix
200Page of products data returned in data.productsYes—
400Bad or missing inputNoCheck queries: one value per call
401X-API-Key header missingNoAdd the header
402Out of credits (body has balance)NoTop up; retrying will not help
403Invalid or revoked API keyNoCheck the key in your dashboard
429ThrottledNoWait Retry-After seconds, then retry
5xxUpstream failure or timeoutNoRetry with backoff; set a 210 s client timeout

From the error reference. Any non-2xx response costs 0 credits.

Output

Typed JSON with the same schema on every call. One call returns a page of products under products, each with 14 fields, inside the standard data envelope. Field names stay the same on every call. Set raw_data to true if you want AliExpress's raw payload instead.

Example output

200 OK · 1 credit · catalog sample
{
  "success": true,
  "data": {
    "url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html",
    "page": 1,
    "page_size": 60,
    "products": [
      {
        "productId": "1005006789012345",
        "title": "Wireless Earbuds Bluetooth 5.3 Noise Cancelling TWS Headphones",
        "productUrl": "https://www.aliexpress.us/item/1005006789012345.html",
        "searchQuery": "wireless earbuds",
        "priceCurrent": "US $12.99",
        "priceCurrency": "$",
        "ratingValue": 4.8,
        "reviewCount": 1240,
        "soldCount": 5000,
        "soldDescription": "5,000+ sold",
        "tags": "Bulk deal",
        "scrapedAt": "2026-06-18T12:00:00.000Z",
        "reviewsEnriched": true,
        "position": 1
      }
    ],
    "next_cursor": "zc1.eNpjYGBg...",
    "timing": {
      "total_s": 11.8,
      "search_pages_s": [
        4.1
      ],
      "enrich_s": 7.2
    },
    "enrichment": {
      "requested": 60,
      "enriched": 60
    }
  }
}

The catalog's sample response for queries=wireless earbuds, labelled as a sample: live calls return the account's current values.

Product

FieldTypeExampleDescription
products.productIdstring"1005006789012345"AliExpress product ID
products.titlestring"Wireless Earbuds Bluetooth 5.3 Noise Cancel…"Product title
products.productUrlstring"https://www.aliexpress.us/item/100500678901…"Product page URL
products.positioninteger1Position of the product in the results
products.tagsstring"Bulk deal"Promotion tag shown, such as Bulk deal

Price

FieldTypeExampleDescription
products.priceCurrentstring"US $12.99"Current price as shown, such as US $12.99
products.priceCurrencystring"$"Currency symbol

Rating and sales

FieldTypeExampleDescription
products.ratingValuenumber4.8Average star rating
products.reviewCountinteger1240Number of reviews
products.soldCountinteger5000Units sold as a number
products.soldDescriptionstring"5,000+ sold"Units sold as shown, such as 5,000+ sold
products.reviewsEnrichedbooleantruetrue if rating and review count were enriched for this row

Search context

FieldTypeExampleDescription
products.searchQuerystring"wireless earbuds"Keyword the product was found for
products.scrapedAtstring"2026-06-18T12:00:00.000Z"UTC time the row was scraped

Response envelope and paging

FieldTypeExampleDescription
successbooleantruetrue on every 200 response
data.urlstring"https://www.aliexpress.com/w/wholesale-wire…"AliExpress search URL used for this page
data.pageinteger1Page number of this response
data.page_sizeinteger60Products per page
data.next_cursorstring"zc1.eNpjYGBg..."Pass back as cursor for the next page; null on the last page
data.timingobject{…}Time spent on the call: total and per stage
data.enrichmentobject{…}How many rows were requested and enriched when fetch_reviews is on

How does it work?

01

Scrapier sends each request through its residential proxy pool (use_proxy, on by default), so you never manage IPs or proxy accounts.

02

Retries and parsing of AliExpress's pages happen on Scrapier's side. You send one HTTP request and get typed JSON back.

03

Only publicly visible data is returned: the products and prices any visitor sees on AliExpress without signing in. No AliExpress account or cookie is used.

04

The schema is stable. When AliExpress changes its pages, Scrapier updates the scraper; the field names in the result stay the same.

How do you integrate AliExpress Products Scraper into your stack?

It works with what you already use: any HTTP client, AI agents over MCP, and no-code automation tools. Code samples for cURL, Python and Node.js are on the API tab.

MCP integration for AI agents

claude mcp add -t http scrapier …

This registers the Scrapier MCP server, whose tools reach every Scrapier scraper, including aliexpress-products: the agent finds it with search_endpoints and calls it with run_scrape. Works with Claude Code, Cursor and Windsurf. MCP calls are billed like REST: 1 credit per successful call. Full MCP setup →

No-code tools (n8n, Make, LangChain)

n8n

Use the HTTP Request node with your Scrapier API key in an X-API-Key header and point it at /api/v2/aliexpress-products/ with a queries query parameter. Map the result list into the next node.

Make

Add an HTTP "Make a request" module with the same header and URL, and parse the response as JSON. Map title, priceCurrent and soldCount straight into Sheets, Airtable or your CRM.

LangChain

Wrap the endpoint in a requests-based tool, or load the Scrapier MCP server through LangChain's MCP adapters so the agent finds aliexpress-products with search_endpoints itself.

Pricing and Rate Limits

One AliExpress page of products costs 1 credit, so 1,000 pages of products cost 1,000 credits: $1.58 on the Pro plan. Failed and empty calls are not billed. Run up to 3 requests in parallel per key; above that the API answers 429 with a Retry-After header.

PlanMonthly priceCreditsPages of products includedPer 1,000 pages of products
Hobby$2915,00015,000$1.93
Pro$7950,00050,000$1.58
Scale$299250,000250,000$1.20
EnterpriseCustom volume and terms

Prices from the live billing page. See all plans and limits.

Call cost and timing

1credit per successful call
0credits for a failed call
3parallel requests per key
210srecommended client timeout

How we measure this

Credit cost, pagination and the sample come from the live catalog (GET /api/v2/endpoints, /aliexpress-products/, checked 9 Nov 2026). Concurrency and timeout guidance come from the rate limits page of the docs. Scrapier does not publish latency or success-rate figures for this endpoint, so none are shown here.

AliExpress Products Scraper vs the Official AliExpress API

FeatureScrapier AliExpress scraperDIY AliExpress scraping
Access neededOne Scrapier API keyYour own proxies, parser and servers
Which dataProducts for any keyword or URL, as AliExpress shows themWhatever your parser extracts
Fields returned14 fields per product: title, price, rating, reviews, sold count and positionWhatever you build and maintain
SetupSign up, copy a key, send a requestWrite selectors, handle blocks and retries
Cost1 credit per page of products, from $1.20 per 1,000 callsProxy, server and engineering time

If you need a fully custom crawler or already run your own scraping stack, DIY gives more control; Scrapier suits teams that want one key and one JSON shape across many platforms.

Frequently asked questions

What fields does AliExpress Products Scraper return?

Each product has productId, title, productUrl, priceCurrent, priceCurrency, ratingValue, reviewCount, soldCount, soldDescription, tags and position: 14 fields in data.products. The envelope adds url, page, page_size, next_cursor, timing and enrichment. Each call costs 1 credit.

Is there an AliExpress product data API?

Scrapier's AliExpress product data API is a REST endpoint at /api/v2/aliexpress-products/: send a keyword or URL and your key in the X-API-Key header, and get products as JSON. It costs 1 credit per page and failed calls are free.

How do I find best-selling products for dropshipping?

Search a niche keyword with sort_by set to orders, then read soldCount, priceCurrent, ratingValue and reviewCount on each product. The data is a research signal; it does not tell you margins or supplier quality.

Can I sort AliExpress results by price?

Yes. Set sort_by to price_asc or price_desc, or to orders for the most ordered, or leave it at default. The value is locked into the cursor, so every following page keeps the same order.

What does fetch_reviews do?

It fills in reviewCount and rating for each product with one extra request per product. It is heavy and time-boxed, and rows that did not finish in time carry reviewsEnriched false. It is off by default.

What can I send as input?

Send an AliExpress keyword, such as wireless earbuds, or a search, category or item URL in queries. You can also set sort_by, currency, region and locale. One value per call.

How do I get the next page?

Take data.next_cursor from the response and send it back unchanged as cursor. Repeat until next_cursor is null, which means you have reached the last page. Each page is one call and costs 1 credit.

Can I scrape several pages of products in one call?

No. queries takes one value per call: make one call each, up to 3 in parallel per API key. Throttled calls return 429 with a Retry-After header and cost nothing.

Does AliExpress Products Scraper require a AliExpress account or login?

No. AliExpress Products Scraper uses no AliExpress account or cookies: you send your Scrapier API key in the X-API-Key header and your input, and get JSON back. Only publicly visible data is returned.

How fast does AliExpress Products Scraper run?

Scrapier does not publish a latency figure for this endpoint. Each call reads the page live, so timing depends on the page. Set a client timeout of 210 seconds, as the docs recommend for every endpoint.

What happens if the input is wrong or nothing comes back?

If a call fails, the API returns a non-2xx status and costs 0 credits. In code, check the status, then skip that input or retry it later. Throttled calls (429 with a Retry-After header) are free as well, so retry loops cost nothing.

Does AliExpress Products Scraper work with Claude, ChatGPT and other AI agent tools?

Yes. Connect the Scrapier MCP server with claude mcp add -t http scrapier https://mcp.scrapier.io/mcp and your API key in an X-API-Key header; it works in Claude Code, Cursor and Windsurf. The agent finds aliexpress-products with search_endpoints and calls it with run_scrape. Any agent that can call an HTTP endpoint can use the REST API directly.

How much does it cost to run AliExpress Products Scraper 1,000 times?

1,000 credits, because each call is 1 credit. That is about $1.93 on Hobby, $1.58 on Pro and $1.20 on Scale, at the plans' price per credit. Failed calls are free.

How do I use AliExpress Products Scraper with Python?

For an AliExpress product scraper in Python, send a GET request with the requests library to https://proxy.scrapier.io/api/v2/aliexpress-products/ with params={"queries": "wireless earbuds"}, your key in the X-API-Key header and timeout=210. Read r.json()["data"]["products"]: it is already JSON, so no HTML parsing is needed.

Your feedback

Found a bug or missing a field? Let us know. Write to support@scrapier.io and the team replies to every report.

Get started

Start Scraping AliExpress Pages Of Products

Public AliExpress pages of products as JSON, 1 credit each, from REST or MCP.