# 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 -G "https://www.socialcrawl.dev/v1/aliexpress/product" \
  --data-urlencode "product_id=3256812847028710" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Do I need an AliExpress API key to get product data?

No. Call GET /v1/aliexpress/product with your SocialCrawl key and a product_id or a url. You do not need an AliExpress developer or affiliate account.

### What does the AliExpress product endpoint return?

One product with title, sale price, original price, currency, shop name, images, sold count and category. Reviews and description are not part of it, so call the reviews endpoint for review text.

### Can I pass a product URL instead of an id?

Yes. Pass the full aliexpress.com/item/{id}.html URL as url and the id is read from the path. Or pass the numeric product_id directly, for example 3256812847028710.

### How do I get the price in my own currency?

Add currency, country and language. Currency takes an ISO code such as USD, GBP, EUR, JPY or KRW, and country is the two-letter ship-to code. Displayed price and availability follow those two values.

### What does a 404 mean and is it billed?

It means the product does not exist or is not sold to the country you chose. It is not billed. Try another country before you assume the product is gone.

### How much does an AliExpress product lookup cost?

Each call costs 5 credits on the advanced tier. New accounts get 100 free credits, about 20 lookups, and credits for failed calls are refunded automatically. There is no subscription.

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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get AliExpress product details from a URL with an API?
- Does SocialCrawl need an AliExpress API key to return product prices?