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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Product, required
product AliExpress product link or product name, for example https://www.aliexpress.com/item/3256807832329468.html.
https://www.aliexpress.com/item/3256807832329468.html
- Ship to optional
ship_to Destination country name or two-letter code, for example Canada.
United States
Default
United States.
Input as JSON
{ "product": "https://www.aliexpress.com/item/3256807832329468.html" , "ship_to": "United States"}Output
{ "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}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "aliexpress.com/get_product" , "input": { "product": "https://www.aliexpress.com/item/3256807832329468.html" , "ship_to": "United States" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "aliexpress.com/get_product" , "input": { "product": "https://www.aliexpress.com/item/3256807832329468.html" , "ship_to": "United States" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run aliexpress.com/get_product# with {"product":"https://www.aliexpress.com/item/3256807832329468.html","ship_to":"United States"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
aliexpress.com/get_product- Returns
- prices, variants, rating, reviews, sold count, shipping options, store, specifications, images
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method aliexpress.com/get_product with the inputs above.
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.
See more
All AliExpress methodsSearches 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.
aliexpress.com/search_productsGets 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.
amazon.com/get_productGets one Alibaba wholesale offer from a product link, or from a product name plus supplier name.
alibaba.com/get_productFinds 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).
flipkart.com/get_product_by_productGets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
walmart.com/get_productGets 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.
hm.com/get_productGets 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.
bhphotovideo.com/get_productGets a Nike product's details by name or product link for a chosen country. Returns its colourways, size availability, price and reviews.
nike.com/get_product
