# 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/workflows/alibaba
- Handle: `@alibaba`
- Category: [Commerce](https://fous.com/workflows/category/commerce)
- Source website: https://alibaba.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Alibaba.

## Methods

### Get product

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

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

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

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

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": "@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.
# 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\": \"@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=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": "@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);
```

Or describe the data in plain language: send `{"api":"@alibaba","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 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

### Is Fous affiliated with Alibaba?

No. Fous is not affiliated with Alibaba. This workflow reads the public alibaba.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 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; 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 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/workflows/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/workflows/aldi.md): Search groceries and prices at ALDI US.
- [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.
- [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.
- [Google Shopping API](https://fous.com/workflows/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/workflows/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/workflows/thomasnet.md): Find North American industrial suppliers.
- [Ulta Beauty API](https://fous.com/workflows/ulta-beauty.md): Ulta Beauty returns searchable beauty products and product details, including current pricing and availability that may change.
- [All Commerce workflows](https://fous.com/workflows/category/commerce)