# AliExpress API

> AliExpress returns product listings, prices, shipping, variants, and reviews as a workflow and API.

AliExpress Search products finds listings using product words and optional destination, price range, and sort order. Get product returns prices, variants, reviews, shipping, seller details, and specifications from a product link or name, with optional destination.

- Page: https://fous.com/workflows/aliexpress
- Handle: `@aliexpress`
- Category: [Commerce](https://fous.com/workflows/category/commerce)
- Source website: https://aliexpress.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with AliExpress.

## Methods

### Get product

Operation `get_product`, version 1. 1 credit per call.

Get one AliExpress product’s prices, variants, reviews, shipping to a chosen country, seller and specifications from its link or the best-selling name match. Sold counts may be rounded, and shipping options are those shown for the displayed variant.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `product` | string | yes | `"https://www.aliexpress.com/item/3256807832329468.html"` | AliExpress product link or product name, for example https://www.aliexpress.com/item/3256807832329468.html. |
| `ship_to` | string | no | `"Canada"` | Destination country name or two-letter code, for example Canada. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "description": "AliExpress product link or product name, for example https://www.aliexpress.com/item/3256807832329468.html.",
      "examples": [
        "https://www.aliexpress.com/item/3256807832329468.html",
        "usb c cable"
      ]
    },
    "ship_to": {
      "type": "string",
      "default": "United States",
      "description": "Destination country name or two-letter code, for example Canada.",
      "examples": [
        "Canada"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "https://www.aliexpress.com/item/3256807832329468.html"
    },
    {
      "product": "usb c cable",
      "ship_to": "Canada"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `variants` | array |  |  |
| `variants[].price` | number or null | `1.09` |  |
| `variants[].options` | array |  |  |
| `variants[].currency` | string | `"USD"` |  |
| `variants[].stock_available` | integer or null | `9` |  |
| `product_id` | string | `"3256807832329468"` |  |
| `store_name` | string or null | `"Droma Store"` |  |
| `image_links` | array |  |  |
| `number_sold` | integer or null | `50000` |  |
| `price_range` | object |  |  |
| `price_range.low` | number or null | `1.09` |  |
| `price_range.high` | number or null | `1.9` |  |
| `price_range.currency` | string | `"USD"` |  |
| `star_rating` | number or null | `4.5` |  |
| `product_link` | string | `"https://www.aliexpress.com/item/3256807832329468.html"` |  |
| `product_name` | string or null | `"USB Type C 66W Fast Charge Cable 3M 5M 8M 10M 12M  USB C Port Universal Micro USB Data Cable for Huawei Xiaomi Samsung ` |  |
| `specifications` | array |  |  |
| `specifications[].name` | string | `"High-concerned chemical"` |  |
| `specifications[].value` | string | `"none"` |  |
| `shipping_options` | array |  |  |
| `shipping_options[].cost` | number or null | `1.99` |  |
| `shipping_options[].carrier` | string or null | `"AliExpress Selection Standard Shipping"` |  |
| `shipping_options[].currency` | string | `"USD"` |  |
| `shipping_options[].delivery_estimate` | string or null | `"Oct. 03 - Oct. 08"` |  |
| `number_of_reviews` | integer or null | `6711` |  |
| `store_positive_feedback_percent` | number or null | `94.2` |  |

**Example input**

```json
{
  "product": "https://www.aliexpress.com/item/3256807832329468.html"
}
```

**Example output**

```json
{
  "variants": [
    {
      "price": 1.09,
      "options": [
        {
          "name": "Color",
          "value": "USB - Type-C"
        },
        {
          "name": "Length",
          "value": "8m"
        }
      ],
      "currency": "USD",
      "stock_available": 9
    },
    {
      "price": 1.09,
      "options": [
        {
          "name": "Color",
          "value": "USB - Type-C"
        },
        {
          "name": "Length",
          "value": "5m"
        }
      ],
      "currency": "USD",
      "stock_available": 14
    }
  ],
  "product_id": "3256807832329468",
  "store_name": "Droma Store",
  "image_links": [
    "https://ae-pic-a1.aliexpress-media.com/kf/Se0712f3c68cb470d935f44bec673424ao.jpg?has_lang=1&ver=2",
    "https://ae-pic-a1.aliexpress-media.com/kf/Sd8228f3ad0954a5288b8865bd89ba459h.png?has_lang=1&ver=2"
  ],
  "number_sold": 50000,
  "price_range": {
    "low": 1.09,
    "high": 1.9,
    "currency": "USD"
  },
  "star_rating": 4.5,
  "product_link": "https://www.aliexpress.com/item/3256807832329468.html",
  "product_name": "USB Type C 66W Fast Charge Cable 3M 5M 8M 10M 12M  USB C Port Universal Micro USB Data Cable for Huawei Xiaomi Samsung Camera",
  "specifications": [
    {
      "name": "High-concerned chemical",
      "value": "none"
    },
    {
      "name": "Material",
      "value": "PVC"
    }
  ],
  "shipping_options": [
    {
      "cost": 1.99,
      "carrier": "AliExpress Selection Standard Shipping",
      "currency": "USD",
      "delivery_estimate": "Oct. 03 - Oct. 08"
    }
  ],
  "number_of_reviews": 6711,
  "store_positive_feedback_percent": 94.2
}
```

### Search products

Operation `search_products`, version 1. 1 credit per call.

Search AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"price_low_to_high"` | Listing order, such as price_low_to_high. |
| `query` | string | yes | `"phone case"` | Words to search for, such as phone case. |
| `ship_to` | string | no | `"Canada"` | Destination country name or two-letter code, such as Canada or CA. |
| `max_price` | number | no | `30` | Highest listed price, such as 30. |
| `min_price` | number | no | `5` | Lowest listed price, such as 5. |
| `max_results` | integer | no | `8` | Maximum number of products to return, such as 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "best_match",
        "orders",
        "price_low_to_high",
        "price_high_to_low"
      ],
      "type": "string",
      "default": "best_match",
      "description": "Listing order, such as price_low_to_high.",
      "examples": [
        "price_low_to_high",
        "orders"
      ]
    },
    "query": {
      "type": "string",
      "description": "Words to search for, such as phone case.",
      "examples": [
        "phone case",
        "desk lamp"
      ]
    },
    "ship_to": {
      "type": "string",
      "default": "United States",
      "description": "Destination country name or two-letter code, such as Canada or CA.",
      "examples": [
        "Canada"
      ]
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest listed price, such as 30.",
      "examples": [
        30
      ]
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Lowest listed price, such as 5.",
      "examples": [
        5
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum number of products to return, such as 20.",
      "x-fous-developer": true,
      "examples": [
        8,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "phone case"
    },
    {
      "sort": "price_low_to_high",
      "query": "desk lamp",
      "ship_to": "Canada",
      "max_price": 30,
      "min_price": 5,
      "max_results": 8
    },
    {
      "sort": "orders",
      "query": "phone case",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `products` | array |  |  |
| `products[].price` | number | `9.66` |  |
| `products[].photo_link` | string or null | `"https://ae-pic-a1.aliexpress-media.com/kf/Sf5858b0b568d4492aa80409941f639ecc.jpg"` |  |
| `products[].product_id` | string | `"1005009457730065"` |  |
| `products[].store_name` | string or null |  |  |
| `products[].number_sold` | string or null | `"148 sold"` |  |
| `products[].star_rating` | number or null | `4.9` |  |
| `products[].product_link` | string | `"https://www.aliexpress.com/item/1005009457730065.html"` |  |
| `products[].product_name` | string | `"13-Color Changing RGB Night Light Table Lamp Dimmable Bedside Lamp Remote USB Rechargeable for Bedroom Portable Room Li` |  |
| `products[].currency_code` | string | `"USD"` |  |
| `products[].free_shipping` | boolean | `false` | Whether the search listing explicitly shows free shipping. |
| `products[].original_price` | number or null | `28.46` |  |

**Example input**

```json
{
  "sort": "price_low_to_high",
  "query": "desk lamp",
  "ship_to": "Canada",
  "max_price": 30,
  "min_price": 5,
  "max_results": 8
}
```

**Example output**

```json
{
  "products": [
    {
      "price": 9.66,
      "photo_link": "https://ae-pic-a1.aliexpress-media.com/kf/Sf5858b0b568d4492aa80409941f639ecc.jpg",
      "product_id": "1005009457730065",
      "store_name": null,
      "number_sold": "148 sold",
      "star_rating": 4.9,
      "product_link": "https://www.aliexpress.com/item/1005009457730065.html",
      "product_name": "13-Color Changing RGB Night Light Table Lamp Dimmable Bedside Lamp Remote USB Rechargeable for Bedroom Portable Room Lighting",
      "currency_code": "USD",
      "free_shipping": false,
      "original_price": 28.46
    },
    {
      "price": 10.08,
      "photo_link": "https://ae-pic-a1.aliexpress-media.com/kf/S19e1b7fd863a448499e25361356db495q.jpg",
      "product_id": "1005007076476776",
      "store_name": null,
      "number_sold": "112 sold",
      "star_rating": 4.6,
      "product_link": "https://www.aliexpress.com/item/1005007076476776.html",
      "product_name": "Tomshine 5W 24LEDs Table Desk Lamp Reading Beside Light Clamp CLip Lighting Fixture USB Powered Operated 3 Colors Mode Temperatu",
      "currency_code": "USD",
      "free_shipping": false,
      "original_price": 39.86
    },
    {
      "price": 10.1,
      "photo_link": "https://ae-pic-a1.aliexpress-media.com/kf/S052fae98079f426b9fac24835c600dddv.png",
      "product_id": "1005012887814871",
      "store_name": null,
      "number_sold": "4 sold",
      "star_rating": null,
      "product_link": "https://www.aliexpress.com/item/1005012887814871.html",
      "product_name": "Touch Control Desk Lamp Minimalist Bedside Lamp Dimmable Night Light for Bedroom Living Room Office Decor",
      "currency_code": "USD",
      "free_shipping": false,
      "original_price": 29.37
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@aliexpress",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.aliexpress.com/item/3256807832329468.html"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@aliexpress\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_product\",\n  \"version\": 1,\n  \"input\": {\n    \"product\": \"https://www.aliexpress.com/item/3256807832329468.html\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@aliexpress",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.aliexpress.com/item/3256807832329468.html"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@aliexpress","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Compare listed prices across product searches
- Find products within a price range
- Review product ratings and review counts
- Check shipping options for a destination
- Compare product variants and specifications

## FAQ

### Is Fous affiliated with AliExpress?

No. Fous is not affiliated with AliExpress. This workflow reads the public aliexpress.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a AliExpress account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from aliexpress.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### What products match my search and price range?

Search products returns listings matching required search words and optional minimum and maximum prices.

### What shipping options are shown for a product?

Get product returns shipping options for the displayed variant, optionally for a chosen destination.

### What variants and specifications does a product have?

Get product returns product variants and specifications from a product link or the best-selling name match.

## Related

- [Alibaba API](https://fous.com/workflows/alibaba.md): Alibaba provides wholesale products, prices, minimum orders, and public supplier details; shipping options may depend on destination and quantity, and searches cover up to 20 public listing pages.
- [Amazon API](https://fous.com/workflows/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access.
- [eBay API](https://fous.com/workflows/ebay.md): eBay provides listings, listing details, seller reputation and newest feedback; shipping varies by destination, and some details or counts may be missing or approximate.
- [Walmart API](https://fous.com/workflows/walmart.md): Walmart helps shoppers find products from Walmart and marketplace sellers, view details, prices, ratings and reviews; availability uses Walmart’s default location, not ZIP codes.
- [Newegg API](https://fous.com/workflows/newegg.md): Newegg provides US computer and electronics listings, with product details and selected public offers whose prices, availability, stock, and shipping can change or may not be displayed.
- [Nike API](https://fous.com/workflows/nike.md): Nike returns country-specific listings and details, including prices, sizes, availability and reviews, plus publicly shown upcoming or recently stocked SNKRS releases with local launch times.
- [Best Buy API](https://fous.com/workflows/best-buy.md): Best Buy returns US electronics and appliance listings, prices, deals, specifications, images, reviews, and nearby store pickup and shipping details; prices and availability can change by location and before checkout.
- [Etsy API](https://fous.com/workflows/etsy.md): Etsy provides current listings and prices, shop ratings and shipping, plus public item and shop details; some review counts or listings may be unavailable.
- [All Commerce workflows](https://fous.com/workflows/category/commerce)