# AliExpress Scraper API: 6 Endpoints, Typed JSON | Scrapier (https://scrapier.io/scrapers/aliexpress/)

> AliExpress scraper API: product search and buyer reviews as typed JSON, with prices, sold counts, ratings and photos. 2 credits per call. Get a free API key.

Last updated: 2026-11-12

## AliExpress Scraper API: _6 endpoints_, structured JSON

Product search with prices, ratings and sold counts, and buyer reviews with star filters, photos and translations: each live AliExpress endpoint returns typed JSON in the same response envelope. Public data only.

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

Copy for your AI agent

**6**AliExpress endpoints

**1**credit per successful call

**0**credits for a failed call

**2**need no AliExpress login

Quick answerScrapier returns typed JSON from **6 AliExpress endpoints**: product search, prices, sold counts and buyer reviews. Public data only and no proxies; no AliExpress login needed. 1 credit per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with AliExpress Scraper?

Pick the data you need. The live endpoints take a keyword, a URL or a product ID and give you clean JSON back for 2 credits per successful call. Cards without a GET path are on our final API list and show the input they take.

[### Product searchStart here

`**GET**/api/v2/aliexpress-products/`

Products for a keyword or a search, category or item URL, a page at a time: price, rating, reviews and sold count.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/aliexpress/products/)[### Product reviews

`**GET**/api/v2/aliexpress-reviews/`

Buyer reviews of one product with rating, text, photos, variant and date, plus the product's rating breakdown.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/aliexpress/reviews/)

### Listings with product details

`**IN**searchUrls`

Products from search URLs with price, original price, discount, stock, images, rating, total sold and store.

Same API key and JSON envelope

### Hot products

`**IN**query`

Hot products for a query with price and original price, rating, reviews count, seller and sold count.

Same API key and JSON envelope

### Email finder

`**IN**keywords`

Public email addresses on AliExpress pages that match a keyword, with the page title, description and URL.

Same API key and JSON envelope

### Phone number finder

`**IN**keywords`

Public phone numbers on AliExpress pages that match a keyword, with the country and dial code.

Same API key and JSON envelope

Playground

## Try AliExpress Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

AliExpress**Product search**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping AliExpress cost?

Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 AliExpress calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | $1.20 |

How to

## How do I use AliExpress Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get AliExpress data in a few minutes:

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

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**Product search or product reviews.
3. **Add your input**One keyword or search URL in `queries`, or one product ID or URL in `product_id`, per call.
4. **Set your market**Products take `currency`, `region` and `locale`; reviews take `lang` for translations.
5. **Filter and sort**Sort products by price or orders with `sort_by`; filter reviews by stars, photos or local buyers with `filter`.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP. Pass `next_cursor` back as `cursor` for the next page.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Two ways in. Use whichever matches what you already have.

1

### By keyword

You don't know the items yet: find them with a keyword.

Product search`wireless earbuds`

Best fordiscovery · plain text, "travel" not "#travel"

2

### By ID

You already have the platform's IDs, for example from an earlier call.

Product reviews`1005006079931969`

Best forknown items · one ID per call

Example requests

// GET /api/v2/aliexpress-products/
{
  "queries": "wireless earbuds",
  "sort\_by": "default",
  "currency": "USD",
  "region": "US",
  "locale": "en\_US",
  "fetch\_reviews": "false"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Keyword, or search, category or item URL | `queries` · `sort_by` | Products with price, rating, review count and sold count |
| Product ID or product URL | `product_id` · `filter` · `sort` | Buyer reviews, photos, variants and the product's rating breakdown |
| Market settings | `currency` · `region` · `locale` · `lang` | Prices and review translations for your market |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/aliexpress-products/?queries=wireless earbuds
// one item of data.products · catalog sample
{
  "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
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with AliExpress data?

Public AliExpress data powers product sourcing, dropshipping research, price tracking and supplier quality checks. Here are five common jobs, and the AliExpress scraper endpoints each one chains together.

01

### Product sourcing

Search a product type sorted by orders and shortlist the items with the most sold units and the best ratings. Start sourcing from demand, not guesses.

1. _1_products
2. Shortlist

WeeklySheets, CSV

02

### Supplier quality checks

Before you order in volume, pull a product's reviews filtered to 1 and 2 stars and read what went wrong: sizing, shipping, broken parts. The rating breakdown shows how common it is.

1. _1_reviews
2. Risk notes

On demandNotes, CRM

03

### Dropshipping product research

Find candidate products with a keyword search, then read their reviews with photos to judge real quality and the variants buyers choose.

1. _1_products
2. _2_reviews
3. Product brief

WeeklyNotion, Sheets

04

### Price tracking

Run the same search on a schedule, sorted by price, and track the current price of the products you compete with or buy from.

1. _1_products
2. Price feed

DailyDatabase, dashboard

05

### Review mining for product design

Collect written reviews across a product category and feed them to an LLM. Recurring complaints are a spec sheet for a better product.

1. _1_products
2. _2_reviews
3. Theme report

MonthlyLLM, database

Features

## Features

AliExpress Scraper fetches clean, structured AliExpress data at low cost: built for product sourcing, dropshipping research, price tracking and AI agents.

### Live data, every call

Each request reads AliExpress at call time, and records say when they were scraped.

### Typed, consistent JSON

Same field names on every call: ratings and sold counts as numbers, review ratings with their scale.

### Lists, page by page

Both endpoints return `next_cursor`; run up to 3 requests in parallel per key.

### Keyword or URL

Send a plain keyword, or paste a search, category or item URL; the endpoint detects which.

### MCP-ready for AI agents

The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### Reviews in your language

Set `lang` and reviews come back translated, with the original language noted.

### Maintained for you

When AliExpress changes its pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

2 credits per call, however many items the page holds. Failed calls are never billed.

Why Scrapier

## Why choose this AliExpress Scraper?

The AliExpress Open Platform and its affiliate API serve product data to registered developers and affiliates who hold an app key and secret and sign every request. Scrapier reads public AliExpress search results and reviews with one API key, at a price you know before the call runs.

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

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$1.20**Per 1,000 calls on Scale

At 2 credits a call. Flat per-call pricing, no compute units or bandwidth to estimate.

**0**Setup steps on AliExpress

No developer or affiliate account, app key, secret or request signing.

**1 key**For 35 platforms

The same key and JSON envelope cover Amazon, eBay, Etsy, Walmart and more.

| Feature | Scrapier AliExpress Scraper | AliExpress Open Platform | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Any public product and its reviews | Products available to your app | Any public product |
| Setup | One API key | Developer or affiliate account, app key and secret | Proxies, browsers, parsers |
| Maintenance | Handled by Scrapier | Request signing, API changes | Breaks on layout changes |
| Cost | From $1.20 per 1,000 calls | Free for registered apps, within limits | Servers, proxies and engineering time |
| AI agents | MCP server included | Build your own | Build your own |

FAQ

## Frequently asked questions

### Can I scrape several data types in one call?

No. Each endpoint returns one data type. To get products and their reviews, call aliexpress-products then aliexpress-reviews with each productId, or let an AI agent chain the calls over MCP.

### What can I send to the AliExpress products endpoint?

A plain search keyword such as "wireless earbuds", or a ready AliExpress search, category or item URL; the endpoint detects which. Send one value per call in queries, and sort with sort\_by: default, price\_asc, price\_desc or orders.

### Can I filter AliExpress reviews?

Yes. Set filter to all, a star value from 1 to 5, image for reviews with photos, additional for follow-up reviews or local for buyers in one country. Sort by default or newest, and written\_only drops rating-only rows.

### How many results can I get?

As many as AliExpress shows publicly. Both endpoints return a page at a time with next\_cursor; pass it back as cursor for the next page. Each page is one call at 2 credits, however many items it holds.

### Can I get prices in another currency?

Yes. aliexpress-products takes currency, region and locale, for example USD, US and en\_US. These settings are locked into the cursor, so every page of one search uses the same market.

### Why is a field sometimes null?

When AliExpress doesn't show a value, the field is null, so you can tell "not shown" from zero. A reviewer's profile URL or review count, for example, can be null.

### Is it legal to scrape AliExpress?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. AliExpress masks reviewer names, but treat any personal data under GDPR or CCPA with care.

### Can I connect AliExpress data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON response.

### Can I get AliExpress data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right AliExpress endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### AliExpress Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

### How much does the AliExpress scraper cost?

Both live AliExpress endpoints cost 2 credits per successful call, however many items the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### What are the AliExpress scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed. Reviews can run long, so set a client timeout of 210 seconds or more.

### How do I scrape AliExpress with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/aliexpress-products/", headers={"X-API-Key": key}, params={"queries": "wireless earbuds"}, timeout=210). The response is JSON, so read r.json()\["data"\]\["products"\] directly; there is no HTML to parse or proxy to run.

Other platforms

## You might also like

[### Amazon

8 endpoints](https://scrapier.io/scrapers/amazon/)[### eBay

3 endpoints](https://scrapier.io/scrapers/ebay/)[### Etsy

6 endpoints](https://scrapier.io/scrapers/etsy/)[### Walmart

5 endpoints](https://scrapier.io/scrapers/walmart/)[### TikTok

29 endpoints](https://scrapier.io/scrapers/tiktok/)[### Google

18 endpoints](https://scrapier.io/scrapers/google/)

Get started

## Start pulling AliExpress data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 6 endpoints](#endpoints)

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