# AliExpress Products Scraper: Search Data as JSON | Scrapier (https://scrapier.io/scrapers/aliexpress/products/)

> AliExpress Products Scraper API: products for a keyword or URL as JSON with price, rating, review count and sold count. 1 credit per call. Get a free API key.

Last updated: 2026-11-12

**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.

[Get a free API key →](https://app.scrapier.io/sign-up) [View API docs](https://scrapier.io/scrapers/aliexpress/products/api/)

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

Last updated 9 Nov 2026

// 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

Pricing

[1 credit / page of products](https://scrapier.io/pricing/)

From $1.58 per 1,000 on Pro

Endpoint facts

Credits per call**1**

Pagination**cursor**

AliExpress login**Not needed**

Format**JSON**

Auth

`X-API-Key: <your key>`

MCP tool

`run_scrape · aliexpress-products`

One of six tools in the Scrapier MCP server, which reach all 199 endpoints.

Platform

[AliExpress: 2 endpoints →](https://scrapier.io/scrapers/aliexpress/)

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](#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.

AliExpress**AliExpress Products**Live

Platform

Endpoint

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 →](https://scrapier.io/scrapers/aliexpress/products/mcp/)

### Run it yourself

1. **Get your free Scrapier API key**Sign up at [app.scrapier.io](https://app.scrapier.io/sign-up); the free tier lets you try it first.
2. **Open AliExpress Products Scraper in the catalog**It lives under [Scrapers / AliExpress](https://scrapier.io/scrapers/aliexpress/), next to the other AliExpress tools.
3. **Enter a keyword or URL**Type 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 request**One 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 results**Each 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

- **Price**`priceCurrent` and `priceCurrency` on every product
- **Social proof**`ratingValue`, `reviewCount` and `soldCount`
- **Sorting**`sort_by` orders by default, price ascending, price descending or orders
- **Locale**`currency`, `region` and `locale` set how prices show
- **Reviews**`fetch_reviews` fills in rating and review count per product
- **Paging**`next_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](https://scrapier.io/scrapers/aliexpress/products/mcp/) 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).

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `queries` | string | Yes | — | 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` |
| `cursor` | string | No | — | Pass back `data.next_cursor` from the previous response, unchanged, to get the next page; `null` means the last page |
| `sort_by` | string | No | `default` | Result order, default `default`. Options: `default`, `price_asc`, `price_desc`, `orders`. Locked into the cursor |
| `currency` | string | No | `USD` | Currency for prices, default `USD`. Locked into the cursor |
| `region` | string | No | `US` | Region code, default `US`. Locked into the cursor |
| `locale` | string | No | `en_US` | Locale, default `en_US`. Locked into the cursor |
| `fetch_reviews` | boolean | No | `false` | Fill 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_proxy` | boolean | No | `true` | Route through Scrapier's residential proxy pool, on by default. Leave as is |
| `raw_data` | boolean | No | `false` | Return 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

| Status | Meaning | Billed | Fix |
| --- | --- | --- | --- |
| 200 | Page of products data returned in `data.products` | Yes | — |
| 400 | Bad or missing input | No | Check `queries`: one value per call |
| 401 | `X-API-Key` header missing | No | Add the header |
| 402 | Out of credits (body has `balance`) | No | Top up; retrying will not help |
| 403 | Invalid or revoked API key | No | Check the key in your dashboard |
| 429 | Throttled | No | Wait `Retry-After` seconds, then retry |
| 5xx | Upstream failure or timeout | No | Retry with backoff; set a 210 s client timeout |

From the [error reference](https://docs.scrapier.io/errors/). 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

| Field | Type | Example | Description |
| --- | --- | --- | --- |
| `products.productId` | string | `"1005006789012345"` | AliExpress product ID |
| `products.title` | string | `"Wireless Earbuds Bluetooth 5.3 Noise Cancel…"` | Product title |
| `products.productUrl` | string | `"https://www.aliexpress.us/item/100500678901…"` | Product page URL |
| `products.position` | integer | `1` | Position of the product in the results |
| `products.tags` | string | `"Bulk deal"` | Promotion tag shown, such as Bulk deal |

### Price

| Field | Type | Example | Description |
| --- | --- | --- | --- |
| `products.priceCurrent` | string | `"US $12.99"` | Current price as shown, such as US $12.99 |
| `products.priceCurrency` | string | `"$"` | Currency symbol |

### Rating and sales

| Field | Type | Example | Description |
| --- | --- | --- | --- |
| `products.ratingValue` | number | `4.8` | Average star rating |
| `products.reviewCount` | integer | `1240` | Number of reviews |
| `products.soldCount` | integer | `5000` | Units sold as a number |
| `products.soldDescription` | string | `"5,000+ sold"` | Units sold as shown, such as 5,000+ sold |
| `products.reviewsEnriched` | boolean | `true` | true if rating and review count were enriched for this row |

### Search context

| Field | Type | Example | Description |
| --- | --- | --- | --- |
| `products.searchQuery` | string | `"wireless earbuds"` | Keyword the product was found for |
| `products.scrapedAt` | string | `"2026-06-18T12:00:00.000Z"` | UTC time the row was scraped |

### Response envelope and paging

| Field | Type | Example | Description |
| --- | --- | --- | --- |
| `success` | boolean | `true` | true on every 200 response |
| `data.url` | string | `"https://www.aliexpress.com/w/wholesale-wire…"` | AliExpress search URL used for this page |
| `data.page` | integer | `1` | Page number of this response |
| `data.page_size` | integer | `60` | Products per page |
| `data.next_cursor` | string | `"zc1.eNpjYGBg..."` | Pass back as cursor for the next page; null on the last page |
| `data.timing` | object | `{…}` | Time spent on the call: total and per stage |
| `data.enrichment` | object | `{…}` | 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](https://scrapier.io/scrapers/aliexpress/products/api/).

### 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 →](https://scrapier.io/scrapers/aliexpress/products/mcp/)

### 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.

| Plan | Monthly price | Credits | Pages of products included | Per 1,000 pages of products |
| --- | --- | --- | --- | --- |
| Hobby | $29 | 15,000 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | 250,000 | $1.20 |
| Enterprise | [Custom volume and terms](https://scrapier.io/enterprise/#contact) |

Prices from the live billing page. [See all plans and limits](https://scrapier.io/pricing/).

## Call cost and timing

**1**credit per successful call

**0**credits for a failed call

**3**parallel requests per key

**210s**recommended 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](https://docs.scrapier.io/rate-limits/) 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

| Feature | Scrapier AliExpress scraper | DIY AliExpress scraping |
| --- | --- | --- |
| Access needed | One Scrapier API key | Your own proxies, parser and servers |
| Which data | Products for any keyword or URL, as AliExpress shows them | Whatever your parser extracts |
| Fields returned | 14 fields per product: title, price, rating, reviews, sold count and position | Whatever you build and maintain |
| Setup | Sign up, copy a key, send a request | Write selectors, handle blocks and retries |
| Cost | 1 credit per page of products, from $1.20 per 1,000 calls | Proxy, 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.

## Is it legal to scrape AliExpress data?

Scraping publicly available web pages is generally lawful in many countries, but the answer depends on what you collect, where you are and how you use it. In the US, hiQ Labs v. LinkedIn is the case most often cited on public-data scraping. Scrapier returns only data any visitor can see without logging in. Product listings hold no personal data about buyers. Under GDPR and similar laws, collecting public data can be permissible, but how you store and use personal data must still comply with local data-protection rules, and AliExpress's terms apply. Consult legal counsel if your use case involves bulk storage of personal data. This is not legal advice; see our [Terms of Use](https://scrapier.io/terms/).

## 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.

## Related scrapers

| Scraper | What it extracts |
| --- | --- |
| [Reviews Scraper](https://scrapier.io/scrapers/aliexpress/reviews/) | Buyer reviews of one product with rating, text, photos, variant and date, plus the product's rating breakdown. |

All 2 AliExpress endpoints are on the [AliExpress scraper hub](https://scrapier.io/scrapers/aliexpress/).

## Your feedback

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

[Report an issue](https://scrapier.io/contact/)[Email support](mailto:support@scrapier.io)

Get started

## Start Scraping AliExpress Pages Of Products

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

[Get a free API key →](https://app.scrapier.io/sign-up)[View pricing](https://scrapier.io/pricing/)

---
Canonical page: https://scrapier.io/scrapers/aliexpress/products/
Site index for AI agents: https://scrapier.io/llms.txt
