# AliExpress Search API (https://www.socialcrawl.dev/platforms/aliexpress/search)

> Returns AliExpress products matching a keyword, 10 per page by default (max 50). Each row has product id, title, sale price, shop name, and image. Pass the returned cursor back until has_more is false. Optional sort_by: price_low, price_high, most_sold, least_sold. Optional min_price and max_price are in the smallest currency unit (cents). A query that matches nothing comes back empty and is not billed.

TL;DR: `GET /v1/aliexpress/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keywords, for example xiaomi or wireless earbuds. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `page_size` | no | Products per page, 1 to 50. Default 10. |
| `sort_by` | no | Result ordering: price_low, price_high, most_sold, or least_sold. (price_low \| price_high \| most_sold \| least_sold) |
| `min_price` | no | Lowest price to include, in the smallest unit of the target currency (cents for USD). |
| `max_price` | no | Highest price to include, in the smallest unit of the target currency (cents for USD). |
| `category_id` | no | AliExpress category id. Category ids come from GET /v1/aliexpress/categories. |
| `delivery_days` | no | Keep products that claim delivery within this many days. |
| `country` | no | Ship-to country as a two-letter code. Default US. Changes displayed price and availability. A product that exists for US can return empty for another country. |
| `currency` | no | ISO 4217 currency for displayed prices. Default USD. Live-validated: USD GBP CAD EUR UAH MXN TRY RUB BRL AUD INR JPY IDR SEK KRW ILS THB CLP VND. |
| `language` | no | Copy language as an ISO code. Default EN. Live-validated: EN RU PT ES FR ID IT TH JA AR VI TR DE HE KO NL PL MX CL IN. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/aliexpress/search?query=xiaomi" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full AliExpress API: https://www.socialcrawl.dev/platforms/aliexpress

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing