AliExpress Shipping

Quote what shipping one AliExpress item to a country costs, by every carrier, and how long it takes.

GET | POST /v1/aliexpress/shipping

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Parameters

Parameter	Type	Required	Notes
`id`	string	yes	AliExpress product id.
`currency`	string		Currency for the shipping fee. Default USD.
`quantity`	integer ≥ 1		How many units are shipped together. Default 1.
`region`	string		Destination country (ISO 3166-1 alpha-2). Default US.
`sku`	string		The variant to quote: a variant `id` from the product, or a numeric sku id. Omit for the product's listed variant.

Request

curl "https://gateway.apinoa.com/v1/aliexpress/shipping?id=1005012583726882&region=US" \
  -H "x-api-key: $APINOA_API_KEY"

Response

Returns ShippingQuote in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "data": {
    "marketplace": "aliexpress",
    "productId": "1005012583726882",
    "skuId": "12000058743753115",
    "region": "US",
    "quantity": 1,
    "available": true,
    "options": [
      {
        "carrier": "AliExpress Selection Standard",
        "code": "CAINIAO_FULFILLMENT_STD",
        "estimate": "Oct. 31 - Nov. 06",
        "cost": {
          "currency": "USD",
          "amount": 1.99
        },
        "free": false,
        "minDays": 8,
        "maxDays": 14,
        "guaranteedDays": 60,
        "tracking": true,
        "shipsFrom": "CN"
      }
    ]
  },
  "requestId": "079c568500e94ee7abaf4bfd01c142cc",
  "success": true
}

Errors

Status	Code	Meaning
400	`INVALID_PARAMS`	A parameter is missing, unknown or out of range. The message names it.
401	`UNAUTHORIZED`	The `x-api-key` header is missing, or the key is revoked or unknown.
402	`INSUFFICIENT_BALANCE`	The balance does not cover this call. Top up in the dashboard.
404	`ITEM_NOT_FOUND`	AliExpress does not know this product or variant.
503	`TOKEN_EXPIRED`	AliExpress is temporarily unavailable. Retry later.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.001 per call, plus $0.001 for each extra call it makes — at most 1 more, so $0.002 in total. List price; the rate steps down above 1,000 calls a day.

Notes

Every option, cheapest first: carrier, cost (absent with free: true when shipping is free), minDays/maxDays, the arrival estimate as worded, and where it ships from.
available: false with no options means AliExpress does not ship this item to region. That is an answer, not an error.
Shipping can differ by variant. Pass sku as a variant id from the product response; omit it for the variant whose price the product reports. With a numeric SKU id the call is 1 unit, otherwise 2.

Shipping