# AliExpress API: Get product

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

Unofficial. Not affiliated with or endorsed by AliExpress.

- Page: https://fous.com/methods/aliexpress.com/get-product
- Method: `aliexpress.com/get_product`, version 1
- Website: aliexpress.com
- Returns: prices, variants, rating, reviews, sold count, shipping options, store, specifications, images
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | 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 | `"United States"` | Destination country name or two-letter code, for example Canada. Default "United States". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

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

Its 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
    },
    {
      "price": 1.9,
      "options": [
        {
          "name": "Color",
          "value": "USB - Type-C"
        },
        {
          "name": "Length",
          "value": "12m"
        }
      ],
      "currency": "USD",
      "stock_available": 3
    }
  ],
  "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",
    "https://ae-pic-a1.aliexpress-media.com/kf/Sbc58bc0304c64c389eb333cc2d25ff81U.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"
    },
    {
      "name": "Maximum Current",
      "value": "2.4A"
    }
  ],
  "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
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"aliexpress.com/get_product","input":{"product":"https://www.aliexpress.com/item/3256807832329468.html","ship_to":"United States"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the current price and shipping cost to Germany for this item: https://www.aliexpress.com/item/1005006234871952.html?
- Find the best-selling wireless earbuds with ANC listing on AliExpress and tell me its rating, how many have sold, and which color variants are available.
- I'm thinking of buying a mini portable projector from a Chinese marketplace — pull up the top seller's specs, store name, and delivery options to Australia.
- Check reviews and seller info for item 3256805519874431 and whether it ships to CA.
- Show me prices for each size option of the top-selling men's waterproof hiking boots and how long shipping takes to the UK.

## 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."
    },
    "ship_to": {
      "type": "string",
      "default": "United States",
      "description": "Destination country name or two-letter code, for example Canada."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "value": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "currency": {
            "type": "string"
          },
          "stock_available": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    },
    "product_id": {
      "type": "string",
      "x-fous-developer": true
    },
    "store_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "image_links": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "number_sold": {
      "type": [
        "integer",
        "null"
      ]
    },
    "price_range": {
      "type": "object",
      "required": [
        "low",
        "high",
        "currency"
      ],
      "properties": {
        "low": {
          "type": [
            "number",
            "null"
          ]
        },
        "high": {
          "type": [
            "number",
            "null"
          ]
        },
        "currency": {
          "type": "string"
        }
      }
    },
    "star_rating": {
      "type": [
        "number",
        "null"
      ]
    },
    "product_link": {
      "type": "string"
    },
    "product_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "specifications": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      }
    },
    "shipping_options": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cost": {
            "type": [
              "number",
              "null"
            ]
          },
          "carrier": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "delivery_estimate": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "number_of_reviews": {
      "type": [
        "integer",
        "null"
      ]
    },
    "store_positive_feedback_percent": {
      "type": [
        "number",
        "null"
      ]
    }
  }
}
```

## See more

- [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches 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.
- [Amazon API: Get product](https://fous.com/methods/amazon.com/get-product.md): Gets details for an Amazon product, found by name or by link, in a chosen country store. Offer prices, delivery and variants may be missing when Amazon does not show them publicly.
- [Alibaba API: Get product offer](https://fous.com/methods/alibaba.com/get-product.md): Gets one Alibaba wholesale offer from a product link, or from a product name plus supplier name.
- [Flipkart API: Get product](https://fous.com/methods/flipkart.com/get-product-by-product.md): Finds a Flipkart product from its name or link and returns its price, offers, seller, ratings, highlights, specifications, images and delivery estimate (for a PIN code when given).
- [Walmart API: Get product](https://fous.com/methods/walmart.com/get-product.md): Gets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
- [H&M API: Get product](https://fous.com/methods/hm.com/get-product.md): Gets an H&M item's current country-specific price, sizes, colours and images by product name or product page link. Description, materials, composition, care and sustainability details are always returned as null.
- [bhphotovideo.com API: Get B&H Photo product](https://fous.com/methods/bhphotovideo.com/get-product.md): Gets a B&H Photo product's details by name, product link, or B&H number. A name uses the best matching search result; details and prices reflect the public page.
- [Nike API: Get product](https://fous.com/methods/nike.com/get-product.md): Gets a Nike product's details by name or product link for a chosen country. Returns its colourways, size availability, price and reviews.
- [All AliExpress methods](https://fous.com/methods/aliexpress.com.md)