# Alibaba API

> Alibaba provides wholesale product offers, pricing, and supplier details as a workflow and API.

Alibaba, also called Alibaba.com, returns wholesale product offers with Search products, using a product query and optional filters. Get product returns offer details, pricing tiers, and supplier information from a product link or product and supplier name. Get supplier returns a public company profile using a supplier name or Alibaba store link.

- Page: https://fous.com/tools/alibaba
- Handle: `@alibaba`
- Category: [Commerce](https://fous.com/tools/category/commerce)
- Source website: https://alibaba.com
- Last verified: Sep 29, 2026

## Methods

### Get product

Operation `get_product`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get one Alibaba wholesale offer from its link or a product name and supplier. Shipping choices may be unavailable until a destination and quantity are selected.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `product` | string | yes | `"https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html"` | Alibaba product link or product name followed by supplier name, for example bamboo toothbrush, Yangzhou Ranbay. |

**Input schema**

```json
{
  "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.",
      "examples": [
        "https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html",
        "bamboo toothbrush, Yangzhou Ranbay",
        "https://www.alibaba.com/product-detail/Wholesale-Customized-Logo-Wood-Bamboo-Toothbrush_1601214092701.html"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html"
    },
    {
      "product": "bamboo toothbrush, Yangzhou Ranbay"
    },
    {
      "product": "https://www.alibaba.com/product-detail/Wholesale-Customized-Logo-Wood-Bamboo-Toothbrush_1601214092701.html"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `photo_links` | array |  |  |
| `price_tiers` | array |  |  |
| `price_tiers[].currency` | string | `"USD"` |  |
| `price_tiers[].unit_price` | number | `0.13` |  |
| `price_tiers[].minimum_quantity` | integer | `500` |  |
| `product_link` | string | `"https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html"` |  |
| `product_name` | string or null | `"Natural Bamboo Toothbrush Black Eco Friendly Soft Bristle Bamboo Toothbrush"` |  |
| `quantity_unit` | string or null | `"pieces"` |  |
| `supplier_name` | string or null | `"Hebei Meixu Trade Co., Ltd."` |  |
| `key_attributes` | array |  |  |
| `key_attributes[].name` | string | `"use"` |  |
| `key_attributes[].value` | string | `"Home"` |  |
| `supplier_rating` | number or null | `4.5` |  |
| `shipping_options` | string or null |  |  |
| `supplier_country` | string or null | `"China"` |  |
| `years_on_alibaba` | integer or null | `7` |  |
| `verified_supplier` | boolean | `true` |  |
| `customization_options` | string or null | `"Logo/graphic design: Laser Carving (minimum 500 pieces); Packaging: Paper Bag (minimum 1,000 pieces); Minor customizati` |  |
| `lead_time_by_quantity` | string or null | `"1–1,000 pieces: 7 days; 1,001–10,000 pieces: 14 days; Over 10,000 pieces: to be negotiated"` |  |
| `minimum_order_quantity` | integer or null | `500` |  |

**Example input**

```json
{
  "product": "https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html"
}
```

**Example output**

```json
{
  "photo_links": [
    "https://sc04.alicdn.com/kf/H0123f750b59c43c28f310c3f798c3299g.jpg",
    "https://sc04.alicdn.com/kf/Hdafcc27c4f4d4c7693e625c0e6abd698V.jpg",
    "https://sc04.alicdn.com/kf/Haaf4401bd8cb473c91ff946e04970c43g.jpg"
  ],
  "price_tiers": [
    {
      "currency": "USD",
      "unit_price": 0.13,
      "minimum_quantity": 500
    },
    {
      "currency": "USD",
      "unit_price": 0.13,
      "minimum_quantity": 1000
    },
    {
      "currency": "USD",
      "unit_price": 0.11,
      "minimum_quantity": 50000
    }
  ],
  "product_link": "https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html",
  "product_name": "Natural Bamboo Toothbrush Black Eco Friendly Soft Bristle Bamboo Toothbrush",
  "quantity_unit": "pieces",
  "supplier_name": "Hebei Meixu Trade Co., Ltd.",
  "key_attributes": [
    {
      "name": "use",
      "value": "Home"
    },
    {
      "name": "age group",
      "value": "Adult"
    },
    {
      "name": "bristle type",
      "value": "Soft"
    }
  ],
  "supplier_rating": 4.5,
  "shipping_options": null,
  "supplier_country": "China",
  "years_on_alibaba": 7,
  "verified_supplier": true,
  "customization_options": "Logo/graphic design: Laser Carving (minimum 500 pieces); Packaging: Paper Bag (minimum 1,000 pieces); Minor customization; Drawing-based customization",
  "lead_time_by_quantity": "1–1,000 pieces: 7 days; 1,001–10,000 pieces: 14 days; Over 10,000 pieces: to be negotiated",
  "minimum_order_quantity": 500
}
```

### Get supplier

Operation `get_supplier`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Look up a supplier’s public company profile by company name or Alibaba store link. Response-rate percentages are not consistently published; unavailable details are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `supplier` | string | yes | `"Yangzhou Everbright Caps Manufacture Co., Ltd."` | Supplier company name or Alibaba store link, for example Yangzhou Everbright Caps Manufacture Co., Ltd. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "supplier"
  ],
  "properties": {
    "supplier": {
      "type": "string",
      "description": "Supplier company name or Alibaba store link, for example Yangzhou Everbright Caps Manufacture Co., Ltd.",
      "examples": [
        "Yangzhou Everbright Caps Manufacture Co., Ltd.",
        "https://crayclothing.en.alibaba.com/"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "supplier": "Yangzhou Everbright Caps Manufacture Co., Ltd."
    },
    {
      "supplier": "https://crayclothing.en.alibaba.com/"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `city` | string or null | `"Yangzhou"` |  |
| `country` | string or null | `"China"` |  |
| `store_link` | string | `"https://everbrightheadwear.en.alibaba.com/"` |  |
| `staff_count` | integer or null | `447` |  |
| `company_name` | string | `"Yangzhou Everbright Caps Manufacture Co., Ltd."` |  |
| `factory_size` | string or null | `"15,667 m²"` |  |
| `main_markets` | array |  |  |
| `review_count` | integer or null | `3` |  |
| `store_rating` | number or null | `5` |  |
| `business_type` | string or null | `"Manufacturer, Trading Company"` |  |
| `main_products` | array |  |  |
| `response_time` | string or null | `"≤7h"` |  |
| `certifications` | array |  |  |
| `years_on_alibaba` | integer or null | `3` |  |
| `verified_supplier` | boolean | `true` |  |
| `response_rate_percent` | number or null |  |  |
| `on_time_delivery_rate_percent` | number or null | `95` |  |

**Example input**

```json
{
  "supplier": "Yangzhou Everbright Caps Manufacture Co., Ltd."
}
```

**Example output**

```json
{
  "city": "Yangzhou",
  "country": "China",
  "store_link": "https://everbrightheadwear.en.alibaba.com/",
  "staff_count": 447,
  "company_name": "Yangzhou Everbright Caps Manufacture Co., Ltd.",
  "factory_size": "15,667 m²",
  "main_markets": [
    "North America",
    "South America",
    "Western Europe"
  ],
  "review_count": 3,
  "store_rating": 5,
  "business_type": "Manufacturer, Trading Company",
  "main_products": [
    "Baseball Caps",
    "Knitted Caps",
    "Apparel"
  ],
  "response_time": "≤7h",
  "certifications": [
    "ISO 9001"
  ],
  "years_on_alibaba": 3,
  "verified_supplier": true,
  "response_rate_percent": null,
  "on_time_delivery_rate_percent": 95
}
```

### Search products

Operation `search_products`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find wholesale Alibaba offers for a product, with prices, minimum orders, and supplier details. Searches up to 20 public listing pages; minimum-order filtering compares the displayed number without converting packaging units.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | yes | `"bamboo toothbrush"` | Product to source, for example bamboo toothbrush. |
| `max_results` | integer | no | `12` | Maximum offers to return, for example 20. |
| `max_min_order` | number | no | `500` | Maximum displayed minimum-order number, for example 500. Packaging units are not converted. |
| `verified_only` | boolean | no | `true` | Only show Verified Suppliers, for example true. |
| `supplier_country` | string | no | `"China"` | Supplier country name or code, for example China or CN. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Product to source, for example bamboo toothbrush.",
      "examples": [
        "bamboo toothbrush",
        "ceramic mug",
        "zzzxxyy qqq"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum offers to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        12,
        10,
        5
      ]
    },
    "max_min_order": {
      "type": "number",
      "default": null,
      "minimum": 0,
      "description": "Maximum displayed minimum-order number, for example 500. Packaging units are not converted.",
      "examples": [
        500
      ]
    },
    "verified_only": {
      "type": "boolean",
      "default": false,
      "description": "Only show Verified Suppliers, for example true.",
      "examples": [
        true
      ]
    },
    "supplier_country": {
      "type": "string",
      "default": "",
      "description": "Supplier country name or code, for example China or CN.",
      "examples": [
        "China"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "bamboo toothbrush",
      "max_results": 12
    },
    {
      "query": "ceramic mug",
      "max_results": 10,
      "max_min_order": 500,
      "verified_only": true,
      "supplier_country": "China"
    },
    {
      "query": "zzzxxyy qqq",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `offers` | array |  |  |
| `offers[].currency` | string or null | `"USD"` |  |
| `offers[].price_low` | number or null | `0.09` |  |
| `offers[].photo_link` | string or null | `"https://s.alicdn.com/@sc04/kf/H0123f750b59c43c28f310c3f798c3299g.jpg_300x300.jpg"` |  |
| `offers[].price_high` | number or null | `0.13` |  |
| `offers[].product_link` | string or null | `"https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html"` |  |
| `offers[].product_name` | string or null | `"Natural Bamboo Toothbrush Black Eco Friendly Soft Bristle Bamboo Toothbrush"` |  |
| `offers[].minimum_order` | string or null | `"500 pieces"` |  |
| `offers[].supplier_name` | string or null | `"Hebei Meixu Trade Co., Ltd."` |  |
| `offers[].supplier_rating` | number or null | `4.5` |  |
| `offers[].supplier_country` | string or null | `"China"` |  |
| `offers[].years_on_alibaba` | integer or null | `7` |  |
| `offers[].verified_supplier` | boolean | `true` |  |

**Example input**

```json
{
  "query": "bamboo toothbrush",
  "max_results": 12
}
```

**Example output**

```json
{
  "offers": [
    {
      "currency": "USD",
      "price_low": 0.09,
      "photo_link": "https://s.alicdn.com/@sc04/kf/H0123f750b59c43c28f310c3f798c3299g.jpg_300x300.jpg",
      "price_high": 0.13,
      "product_link": "https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html",
      "product_name": "Natural Bamboo Toothbrush Black Eco Friendly Soft Bristle Bamboo Toothbrush",
      "minimum_order": "500 pieces",
      "supplier_name": "Hebei Meixu Trade Co., Ltd.",
      "supplier_rating": 4.5,
      "supplier_country": "China",
      "years_on_alibaba": 7,
      "verified_supplier": true
    },
    {
      "currency": "USD",
      "price_low": 0.06,
      "photo_link": "https://s.alicdn.com/@sc04/kf/Hec0ee2acc520430dbf7fa64466642b33V.jpg_300x300.jpg",
      "price_high": 0.08,
      "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",
      "minimum_order": "1000 boxes",
      "supplier_name": "Yangzhou Ranbay Hotel Supplies Co., Ltd.",
      "supplier_rating": 4.8,
      "supplier_country": "China",
      "years_on_alibaba": 4,
      "verified_supplier": true
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@alibaba",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.html"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@alibaba\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_product\",\n  \"version\": 1,\n  \"input\": {\n    \"product\": \"https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.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=180) 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.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@alibaba",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.alibaba.com/product-detail/Natural-bamboo-toothbrush-black-eco-friendly_1600368066870.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);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/alibaba`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_product`: Get product. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_supplier`: Get supplier. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_products`: Search products. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-alibaba https://api.fous.com/mcp/tools/alibaba --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare wholesale offers, prices, and minimum orders
- Filter product offers by supplier country or verification
- Review pricing tiers and customization options for an offer
- Check supplier ratings, locations, and company details
- Assess supplier certifications and main markets

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Alibaba tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Alibaba account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from alibaba.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What wholesale offers are available for a product?

Search products finds offers for a product query, including prices, minimum orders, and supplier details.

### What are a product’s price tiers and minimum order?

Get product returns pricing tiers, minimum order quantity, and other details for a product offer.

### What details are available about a supplier?

Get supplier returns a public company profile with details such as location, ratings, certifications, and main products.

## Related

- [AliExpress API](https://fous.com/tools/aliexpress.md): AliExpress returns product listings and selected product details, including prices, variants, reviews, and destination-specific shipping options shown for the displayed variant.
- [Aldi API](https://fous.com/tools/aldi.md): Search groceries and prices at ALDI US.
- [Walmart API](https://fous.com/tools/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.
- [Amazon API](https://fous.com/tools/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.
- [Google Shopping API](https://fous.com/tools/google-shopping.md): Google Shopping shows product offers, prices, ratings, delivery and store links; results vary by country and listings, totals need shown shipping, and typical ranges may be missing.
- [Costco API](https://fous.com/tools/costco.md): Costco returns US product prices/details and warehouse hours/services/gas prices; delivery affects availability, member prices may be hidden, and posted gas and holiday hours may differ.
- [Thomasnet API](https://fous.com/tools/thomasnet.md): Find North American industrial suppliers.
- [Ulta Beauty API](https://fous.com/tools/ulta-beauty.md): Ulta Beauty returns searchable beauty products and product details, including current pricing and availability that may change.
- [All Commerce tools](https://fous.com/tools/category/commerce)