Alibaba API: Get product offer
Gets one Alibaba wholesale offer from a product link, or from a product name plus supplier name.
Unofficial. Not affiliated with or endorsed by Alibaba.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Product, required
product Alibaba product link or product name followed by supplier name, for example bamboo toothbrush, Yangzhou Ranbay.
bamboo toothbrush, Yangzhou Ranbay
Input as JSON
{ "product": "bamboo toothbrush, Yangzhou Ranbay"}Output
{ "photo_links": [ "https://sc04.alicdn.com/kf/Hec0ee2acc520430dbf7fa64466642b33V.jpg" , "https://sc04.alicdn.com/kf/Hbbc15a1263564457a5e95f401247a3c7W.jpg" , "https://sc04.alicdn.com/kf/Hd1e3aac7794e42d8b401fd777099685as.jpg" ], "price_tiers": [ { "currency": "USD", "unit_price": 0.08, "minimum_quantity": 1000 }, { "currency": "USD", "unit_price": 0.07, "minimum_quantity": 3000 }, { "currency": "USD", "unit_price": 0.06, "minimum_quantity": 5000 } ], "product_link": "https://www.alibaba.com/product-detail/Wholesale-Customized-Logo-Wood-Bamboo-Toothbrush_1601214092701.html" , "product_name": "Wholesale Customized Logo Wood Bamboo Toothbrush with Soft Bristle for Home Travel Hotel Amenities Set", "quantity_unit": "boxes", "supplier_name": "Yangzhou Ranbay Hotel Supplies Co., Ltd.", "key_attributes": [ { "name": "use", "value": "Home" }, { "name": "age group", "value": "Adult" }, { "name": "bristle type", "value": "Soft" } ], "supplier_rating": 4.8, "shipping_options": null, "supplier_country": "China", "years_on_alibaba": 4, "verified_supplier": true, "customization_options": "Logo/graphic design: As requested (minimum 1,000 boxes); Customized packaging: As requested (minimum 3,000 boxes); Graphic customization: As requested (minimum 5,000 boxes); Minor customization; Drawing-based customization" , "lead_time_by_quantity": "1–3,000 boxes: 8 days; Over 3,000 boxes: to be negotiated", "minimum_order_quantity": 1000}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"alibaba.com/get_product","input":{"product":"bamboo toothbrush, Yangzhou Ranbay"}}' # 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": "alibaba.com/get_product" , "input": { "product": "bamboo toothbrush, Yangzhou Ranbay" }})# 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": "alibaba.com/get_product" , "input": { "product": "bamboo toothbrush, Yangzhou Ranbay" } }), 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 alibaba.com/get_product# with {"product":"bamboo toothbrush, Yangzhou Ranbay"}"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": "Alibaba product link or product name followed by supplier name, for example bamboo toothbrush, Yangzhou Ranbay." } }}Output schema
{ "type": "object", "required": [ "product_name", "price_tiers", "minimum_order_quantity", "quantity_unit", "customization_options", "lead_time_by_quantity", "shipping_options", "key_attributes", "supplier_name", "supplier_country", "years_on_alibaba", "verified_supplier", "supplier_rating", "photo_links", "product_link" ], "properties": { "photo_links": { "type": "array", "items": { "type": "string" } }, "price_tiers": { "type": "array", "items": { "type": "object", "required": [ "minimum_quantity", "unit_price", "currency" ], "properties": { "currency": { "type": "string" }, "unit_price": { "type": "number" }, "minimum_quantity": { "type": "integer" } }, "additionalProperties": false } }, "product_link": { "type": "string" }, "product_name": { "type": [ "string", "null" ] }, "quantity_unit": { "type": [ "string", "null" ] }, "supplier_name": { "type": [ "string", "null" ] }, "key_attributes": { "type": "array", "items": { "type": "object", "required": [ "name", "value" ], "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": false } }, "supplier_rating": { "type": [ "number", "null" ] }, "shipping_options": { "type": [ "string", "null" ] }, "supplier_country": { "type": [ "string", "null" ] }, "years_on_alibaba": { "type": [ "integer", "null" ] }, "verified_supplier": { "type": "boolean" }, "customization_options": { "type": [ "string", "null" ] }, "lead_time_by_quantity": { "type": [ "string", "null" ] }, "minimum_order_quantity": { "type": [ "integer", "null" ] } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
alibaba.com/get_product- Returns
- product name, price tiers, minimum order, customization, lead times, supplier details, photos, link
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 alibaba.com/get_product with the inputs above.
Ask your agent
- Can you pull up the Alibaba offer for the stainless steel water bottle from Hangzhou Tianji Metal and show me the price tiers and minimum order?
- I need the price breakdown and lead time for a 500-unit order of silicone kitchen spatulas from Dongguan Huaxin Silicone.
- Look up this product link and tell me whether the LED desk lamp can be customized with our logo, plus the supplier contact details: https://www.alibaba.com/product-detail/LED-desk-lamp_1600123456789.html
- Get the wholesale listing for yoga mats sold by Xiamen Yoga Life, including photos and the link to the offer.
- What are the bulk prices and minimum order quantity for a cotton tote bag from Guangzhou Baiyun Textile on alibaba?
See more
All Alibaba methodsFinds wholesale Alibaba offers for a product, with prices, minimum orders and supplier details. Reads up to 20 public listing pages; minimum-order filtering compares the displayed number without converting packaging units.
alibaba.com/search_productsLooks up a supplier's public company profile on Alibaba by company name or store link. Response-rate percentages are not consistently published, so that field is null.
alibaba.com/get_supplierGet 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.
aliexpress.com/get_productGets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
walmart.com/get_productSearches 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_productsFinds 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 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 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_product
