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

> Access AliExpress data through 9 API endpoints. Profiles, posts, comments, search, and more. One unified schema. Free trial.

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 }`.

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