---
title: "Scrape AliExpress search results"
method: POST
path: "/goods/aliexpress-search"
tags: ["Plugins"]
---

# Scrape AliExpress search results

`POST /goods/aliexpress-search`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/goods/aliexpress-search`
- Auth: API key in header `x-scrapeunblocker-key`

Searches AliExpress for `keyword` and returns the products as JSON: `title`, product `url`, `price` (numeric) + `priceFormatted` + `currency`/`currencySymbol`, `originalPrice`, `rating`, `orders` (sold count) and `images`. Sort with `sort` (relevance / orders / price_asc / price_desc / newest) and collect up to `max_results` across pages. AliExpress localises price by region, so the currency follows the proxy country; pass `proxy_country` to pin it.

## Query parameters

- `keyword` string, required: What to search, e.g. 'wireless earbuds' or 'phone case'.
- `sort` string: Ordering: relevance, orders, price_asc, price_desc, newest.
- `max_results` integer: How many products to collect across pages (~60 per page, max 1200).
- `page` integer: 1-based results page to start from.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'); also pins AliExpress price currency. Leave blank to let the API pick.

## Response `200`

JSON with a `products` array plus totals.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by AliExpress, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)