# AliExpress Product API (https://www.socialcrawl.dev/platforms/aliexpress/product)

> Returns one AliExpress product: title, sale price, original price, currency, shop name, images, sold count, and category. Pass the numeric product id or the full aliexpress.com/item/{id} URL. Optional country, currency, and language localise the price. A product that does not exist, or is not sold to that country, comes back 404 and is not billed. There is no product description on this surface. For reviews call GET /v1/aliexpress/reviews. For similar items call GET /v1/aliexpress/product/similar.

TL;DR: `GET /v1/aliexpress/product` 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 |
| --- | --- | --- |
| `product_id` | no | AliExpress product id, the numeric id in a product URL: aliexpress.com/item/3256812847028710.html is product id 3256812847028710. Product ids also come back on every row of GET /v1/aliexpress/search and GET /v1/aliexpress/search/hot. |
| `url` | no | Full AliExpress product URL, for example https://www.aliexpress.com/item/3256812847028710.html. The product id is extracted from the path. |
| `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/product" \
  -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