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

> Returns shipping fee, origin country, and min/max delivery days for one product SKU and a ship-to country. sku_id comes back on every product row. Optional price is the sale price used for free-shipping thresholds. Default tax_rate is 0.

TL;DR: `GET /v1/aliexpress/product/shipping` 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 |
| --- | --- | --- |
| `sku_id` | yes | SKU id for a colour or size variant. Comes back on every product as sku_id. |
| `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. |
| `price` | no | Sale price in the target currency, used for free-shipping calculation. |
| `tax_rate` | no | Tax rate as a decimal, for example 0.1. Default 0. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/aliexpress/product/shipping" \
  --data-urlencode "sku_id=12000060082591973" \
  --data-urlencode "product_id=3256812847028710" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the AliExpress shipping API return?

For one SKU and one ship-to country it returns the shipping fee, the origin country and the minimum and maximum delivery days. For example, a quote can come back as 8.17 from CN with 14 to 19 days.

### Where do I get the sku_id?

sku_id identifies a colour or size variant and comes back on every product as sku_id, from both the product and the search endpoints. Pass it together with the product_id or the product url.

### How do I get a quote for another country?

Set country to the two-letter ship-to code and currency to an ISO code. Delivery time and fee change with the destination, so request one quote per country you serve.

### What are price and tax_rate for?

price is the sale price in the target currency and is used for free-shipping thresholds. tax_rate is a decimal such as 0.1 and defaults to 0.

### Can I track a package with this endpoint?

No. It quotes shipping for a SKU before purchase and does not track parcels. Use it to show a delivery estimate next to a product.

### How much does an AliExpress shipping quote cost?

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

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 shipping cost and delivery days through an API?
- Is there an AliExpress shipping API for a specific SKU and country?