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

> SocialCrawl covers AliExpress with 9 endpoints: product detail by id or URL, keyword search, hot products, similar products, written reviews, shipping quotes for a SKU, and the category and promotion lists. Prices can be shown for a ship-to country in a currency you choose.

TL;DR: SocialCrawl's AliExpress API exposes 9 endpoints, 1 to 9 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Product | GET | `/v1/aliexpress/product` | 5 | Get an AliExpress product by id or URL |
| Search | GET | `/v1/aliexpress/search` | 5 | Search AliExpress products |
| Product Similar | GET | `/v1/aliexpress/product/similar` | 5 | Get similar AliExpress products |
| Reviews | GET | `/v1/aliexpress/reviews` | 5 to 9 | Get AliExpress product reviews |
| Product Shipping | GET | `/v1/aliexpress/product/shipping` | 5 | Get AliExpress shipping for a product SKU |
| Search Hot | GET | `/v1/aliexpress/search/hot` | 5 | List hot AliExpress products |
| Search Promo | GET | `/v1/aliexpress/search/promo` | 5 | List AliExpress products in a featured promotion |
| Categories | GET | `/v1/aliexpress/categories` | 1 | List AliExpress categories |
| Promo | GET | `/v1/aliexpress/promo` | 1 | List AliExpress featured promotions |

## 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"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### Do I need an AliExpress API key?

No. You call SocialCrawl with a SocialCrawl API key and nothing else, with no AliExpress developer or affiliate account. Pass a product id or a product URL and the endpoint returns the data as unified JSON.

### What data does the AliExpress API return?

Product detail has title, sale price, original price, currency, shop name, images, sold count and category. Search and hot-product rows carry id, title, sale price, shop name and image. Reviews, shipping quotes, similar products and the category and promotion lists have their own endpoints.

### How do I get an AliExpress product id?

It is the numeric id in a product URL: aliexpress.com/item/3256812847028710.html is product id 3256812847028710. Search and hot-product rows also return it, or you can pass the full URL instead.

### Can I see prices for a different country or currency?

Yes. Optional country, currency and language parameters localise the displayed price. A product that exists for the US can come back empty for another country, so check the ship-to country if a lookup returns nothing.

### Does the API return product descriptions?

No. The product endpoint has no description field, so use it for price, shop, images and sold count. Written reviews come from GET /v1/aliexpress/reviews and nearby listings from GET /v1/aliexpress/product/similar.

### Am I billed when a search returns nothing?

No. A query that matches nothing comes back empty and is not billed, and a product that does not exist or is not sold to the chosen country returns 404 and is not billed. Credits for failed calls are refunded automatically.

## 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:

- Is there an API for AliExpress product data without an affiliate account?
- How do I get AliExpress prices and shipping costs through an API?
- What is the easiest way to search AliExpress products programmatically?