# AliExpress Product Shipping API Documentation

<p><strong>AliExpress Product Shipping API Documentation</strong> Get every shipping option of one product for a destination country: method, fee, free shipping flag and threshold, estimated delivery window, warehouse country, guaranteed delivery days, delay compensation, free return and cash on delivery. Currency and language follow the market of the request, so they can differ between calls. Failed requests are never charged.</p>

- **Documentation:** [https://scrappa.co/docs/aliexpress-api/aliexpress_product_shipping](https://scrappa.co/docs/aliexpress-api/aliexpress_product_shipping)
- **API group:** AliExpress API
- **Endpoint:** `GET https://scrappa.co/api/aliexpress/product/shipping`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `product_id` | string | Yes | AliExpress product number of 6 to 20 digits, e.g. 3256812407941674. Take it from the product_id of a search result. |
| `country` | string | No | Two-letter destination country code, e.g. DE. Defaults to US. |

## Example response

```json
{
    "data": {
        "options": [
            {
                "fee": 1.99,
                "method": "CAINIAO_FULFILLMENT_STD",
                "is_free": false,
                "currency": "USD",
                "free_return": false,
                "formatted_fee": "US $1.99",
                "cash_on_delivery": false,
                "ship_from_country": "CN",
                "delay_compensation": "US $1.15",
                "estimated_delivery": "Oct 24 - 27",
                "free_shipping_threshold": "US $10.00",
                "guaranteed_delivery_days": 90
            }
        ],
        "product_id": "3256812407941674",
        "ship_to_country": "DE"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "shipping"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | AliExpress could not be reached. Retry after a short pause. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)