---
type: "firecrawl-provider"
description: "Public wholesale product and supplier discovery, quantity pricing and specifications. Advertised facts, not live inventory or landed-cost quotes."
use_when: "Public wholesale product and supplier discovery, quantity pricing and specifications. Advertised facts, not live inventory or landed-cost quotes."
categories: "Company"
capabilities: 5
credits_per_call: 5
---
# Alibaba wholesale products on Firecrawl Alexandria

Public wholesale product and supplier discovery, quantity pricing and specifications. Advertised facts, not live inventory or landed-cost quotes.

- Categories: Company
- Category index: [Company category](https://firecrawl.dev/alexandria/agents/categories/company)
- Provider key: `alibaba`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/alibaba)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/alibaba/openapi.json)

## Capabilities

- [Price tiers](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/price_tiers): Read advertised quantity-based unit prices in USD from source dollarPrice fields. Excludes shipping, tax and customization; localized display strings are separate and not labeled USD.
- [Product](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/product): Read an Alibaba wholesale product title, MOQ, quantity unit and supplier identity. Source-advertised facts; availability remains unknown.
- [Search](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/search): Find wholesale products and suppliers on the first page of Alibaba's public keyword listing (/premium/<keyword>.html), which is mostly sponsored placements. Returns source price strings and MOQ, not normalized price or verified inventory. Later pages are not supported.
- [Specifications](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/specifications): Read supplier-advertised product specifications as name/value pairs. Preserves duplicate attribute labels and makes no independent certification claims.
- [Supplier](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/supplier): Read the supplier summary attached to an Alibaba product: identity, country, business type, platform tenure and source-reported response/delivery metrics. Not a supplier background verification.

## 1. Choose this provider when

Public wholesale product and supplier discovery, quantity pricing and specifications. Advertised facts, not live inventory or landed-cost quotes.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "alibaba",
  "capability": "retail/price_tiers",
  "options": {
    "url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `url` (string, required): Exact https://www.alibaba.com/product-detail/<slug>_<numeric-id>.html URL without query or fragment. Pattern: ^https://www\.alibaba\.com/product-detail/[A-Za-z0-9-]+_[0-9]{1,20}\.html$. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "alibaba",
    capability: "retail/price_tiers",
    options: {
      url: "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "alibaba",
  "capability": "retail/price_tiers",
  "options": {
    "url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "alibaba",
    "capability": "retail/price_tiers",
    "options": {
      "url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'alibaba/retail/price_tiers' \
  --options '{"url":"https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "alibaba",
  "capability": "retail/price_tiers",
  "options": {
    "url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "alibaba",
  "capability": "retail/price_tiers",
  "options": {
    "url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "complete": false,
  "observed_at_ms": 1789508227088,
  "records": [
    {
      "currency": "USD",
      "display_price": "$0.5338",
      "id": "1601651021684",
      "maximum_quantity": 4999,
      "minimum_quantity": 100,
      "unit": "piece",
      "unit_price": 0.38
    },
    {
      "currency": "USD",
      "display_price": "$0.4917",
      "id": "1601651021684",
      "maximum_quantity": 9999,
      "minimum_quantity": 5000,
      "unit": "piece",
      "unit_price": 0.35
    },
    {
      "currency": "USD",
      "display_price": "$0.4636",
      "id": "1601651021684",
      "maximum_quantity": 99999,
      "minimum_quantity": 10000,
      "unit": "piece",
      "unit_price": 0.33
    },
    {
      "currency": "USD",
      "display_price": "$0.4215",
      "id": "1601651021684",
      "maximum_quantity": null,
      "minimum_quantity": 100000,
      "unit": "piece",
      "unit_price": 0.3
    }
  ],
  "source_url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Price tiers

- Capability: `retail/price_tiers`
- Description: Read advertised quantity-based unit prices in USD from source dollarPrice fields. Excludes shipping, tax and customization; localized display strings are separate and not labeled USD.
- Instructions: Read advertised quantity-based unit prices in USD from source dollarPrice fields. Excludes shipping, tax and customization; localized display strings are separate and not labeled USD.
- Cost: 5 credits per call
- Capability file: [Price tiers](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/price_tiers)

Accepted options:
- `url` (string, required): Exact https://www.alibaba.com/product-detail/<slug>_<numeric-id>.html URL without query or fragment. Pattern: ^https://www\.alibaba\.com/product-detail/[A-Za-z0-9-]+_[0-9]{1,20}\.html$. Example: `<url>`

Response schema example:
```json
{
  "complete": false,
  "observed_at_ms": 1789508227088,
  "records": [
    {
      "currency": "USD",
      "display_price": "$0.5338",
      "id": "1601651021684",
      "maximum_quantity": 4999,
      "minimum_quantity": 100,
      "unit": "piece",
      "unit_price": 0.38
    },
    {
      "currency": "USD",
      "display_price": "$0.4917",
      "id": "1601651021684",
      "maximum_quantity": 9999,
      "minimum_quantity": 5000,
      "unit": "piece",
      "unit_price": 0.35
    },
    {
      "currency": "USD",
      "display_price": "$0.4636",
      "id": "1601651021684",
      "maximum_quantity": 99999,
      "minimum_quantity": 10000,
      "unit": "piece",
      "unit_price": 0.33
    },
    {
      "currency": "USD",
      "display_price": "$0.4215",
      "id": "1601651021684",
      "maximum_quantity": null,
      "minimum_quantity": 100000,
      "unit": "piece",
      "unit_price": 0.3
    }
  ],
  "source_url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
}
```

### Product

- Capability: `retail/product`
- Description: Read an Alibaba wholesale product title, MOQ, quantity unit and supplier identity. Source-advertised facts; availability remains unknown.
- Instructions: Read an Alibaba wholesale product title, MOQ, quantity unit and supplier identity. Source-advertised facts; availability remains unknown.
- Cost: 5 credits per call
- Capability file: [Product](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/product)

Accepted options:
- `url` (string, required): Exact https://www.alibaba.com/product-detail/<slug>_<numeric-id>.html URL without query or fragment. Pattern: ^https://www\.alibaba\.com/product-detail/[A-Za-z0-9-]+_[0-9]{1,20}\.html$. Example: `<url>`

Response schema example:
```json
{
  "complete": false,
  "observed_at_ms": 1789508227088,
  "records": [
    {
      "availability": null,
      "id": "1601651021684",
      "minimum_order": 100,
      "quantity_unit": "piece",
      "source_country": "CN",
      "supplier_name": "Ningbo Purly Imp. & Exp. Co., Ltd.",
      "title": "Custom Logo Dishwasher Microwave Safe Ceramic Sublimation Mugs 11 Oz Blank Bulk Coffee Mug With Large Handle",
      "url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
    }
  ],
  "source_url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
}
```

### Search

- Capability: `retail/search`
- Description: Find wholesale products and suppliers on the first page of Alibaba's public keyword listing (/premium/<keyword>.html), which is mostly sponsored placements. Returns source price strings and MOQ, not normalized price or verified inventory. Later pages are not supported.
- Instructions: Find wholesale products and suppliers on the first page of Alibaba's public keyword listing (/premium/<keyword>.html), which is mostly sponsored placements. Returns source price strings and MOQ, not normalized price or verified inventory. Later pages are not supported.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/search)

Accepted options:
- `query` (string, required): query Example: `<query>`

Response schema example:
```json
{
  "complete": false,
  "has_more": true,
  "observed_at_ms": 1790522282021,
  "page": 1,
  "query": "ceramic mug",
  "records": [
    {
      "display_currency": null,
      "display_price": "US $0.20-$0.99",
      "id": "1601603406266",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Dongguan Brothersbox Industrial Co., Ltd.",
      "title": "Personalized Design Handmade Magnetic Rigid Packaging Luxury Custom Design Tea Cup Set Gift Box",
      "url": "https://www.alibaba.com/product-detail/Personalized-Design-Handmade-Magnetic-Rigid-Packaging_1601603406266.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.69-$0.79",
      "id": "1601931468578",
      "minimum_order_text": "36 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shandong Langxun New Materials Technology Co., Ltd.",
      "title": "11oz Mug Two Color Ceramic Mug Sublimation Mug Custom Personalized for Holiday Souvenir Gift Bulk Wholesale",
      "url": "https://www.alibaba.com/product-detail/11oz-Mug-Two-Color-Ceramic-Mug_1601931468578.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.18-$0.65",
      "id": "1601225098581",
      "minimum_order_text": "200 pieces",
      "supplier_country": "CN",
      "supplier_name": "Yatang Brand Management (chengdu) Co., Ltd.",
      "title": "ZREGGUR Custom Mugs Factory Price Colorful Beer Mugs For Printing High Quality 11Oz White Sublimation Ceramic Coffee Mug",
      "url": "https://www.alibaba.com/product-detail/ZREGGUR-Custom-Mugs-Factory-Price-Colorful_1601225098581.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.77-$0.89",
      "id": "1601918359054",
      "minimum_order_text": "36 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shandong Langxun New Materials Technology Co., Ltd.",
      "title": "Sublimation Mug 15oz Blank White Ceramic Insulated Dishwasher & Microwave Safe Eco-Friendly Custom for Home Souvenir Bulk Supply",
      "url": "https://www.alibaba.com/product-detail/Sublimation-Mug-15oz-Blank-White-Ceramic_1601918359054.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.30-$1.50",
      "id": "1601953527205",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Chaozhou Tongxinghuajiang Ceramics Making Co., Ltd.",
      "title": "Nordic Cream Christmas Tree Embossed Home Decoration Gift Stoneware Mugs Christmas Festive Ceramic Coffee Mug Cup",
      "url": "https://www.alibaba.com/product-detail/Nordic-Cream-Christmas-Tree-Embossed-Home_1601953527205.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.19-$1.69",
      "id": "1601930302220",
      "minimum_order_text": "36 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shandong Langxun New Materials Technology Co., Ltd.",
      "title": "Sublimation Mug Wholesale Blank Mug with Spoon 11oz Ceramic Mug Double Color Mug Heat Transfer Mug All Over Print Mug",
      "url": "https://www.alibaba.com/product-detail/Sublimation-Mug-Wholesale-Blank-Mug-with_1601930302220.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.55-$1.79",
      "id": "1601952024900",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Chaozhou Tongxinghuajiang Ceramics Making Co., Ltd.",
      "title": "Bulk Modern Checkerboard Pattern Ceramic Mug Household Hotel Vibrant Color Block Porcelain Coffee Cup",
      "url": "https://www.alibaba.com/product-detail/Bulk-Modern-Checkerboard-Pattern-Ceramic-Mug_1601952024900.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.19-$1.69",
      "id": "1601684745495",
      "minimum_order_text": "36 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shandong Langxun New Materials Technology Co., Ltd.",
      "title": "Wholesale 11oz White Ceramic Sublimation Mug Blank Mug With Spoon Double Color Mug Heat Transfer Mug Custom Logo",
      "url": "https://www.alibaba.com/product-detail/Wholesale-11oz-White-Ceramic-Sublimation-Mug_1601684745495.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.55-$1.79",
      "id": "1601952784393",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Chaozhou Tongxinghuajiang Ceramics Making Co., Ltd.",
      "title": "Coastal Farmhouse Style Stoneware Coffee Mug Embossed Braided Rope Detail White Finish Unique Tea Cup For Housewarming Gift",
      "url": "https://www.alibaba.com/product-detail/Coastal-Farmhouse-Style-Stoneware-Coffee-Mug_1601952784393.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.19-$1.69",
      "id": "1601930211879",
      "minimum_order_text": "36 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shandong Langxun New Materials Technology Co., Ltd.",
      "title": "Sublimation All Print 11oz Insulated BPA Free Ceramic Mug Double Color Heat Transfer Blank Custom Design Dishwasher Microwave",
      "url": "https://www.alibaba.com/product-detail/Sublimation-All-Print-11oz-Insulated-BPA_1601930211879.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.40-$1.62",
      "id": "1601952808021",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Chaozhou Tongxinghuajiang Ceramics Making Co., Ltd.",
      "title": "Wholesale Hand Painted Wavy Pattern Speckled Custom Logo Stoneware Coffee Mug Abstract Retro Ceramic Cup",
      "url": "https://www.alibaba.com/product-detail/Wholesale-Hand-Painted-Wavy-Pattern-Speckled_1601952808021.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.72-$2.23",
      "id": "1601739263307",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shanghai Karry Industrial Co., Ltd.",
      "title": "Beautiful Flower Design Insulated Coffee Tumbler 304 Stainless Steel Vacuum Travel Mug Leakproof Cup For Daily Use",
      "url": "https://www.alibaba.com/product-detail/Beautiful-Flower-Design-Insulated-Coffee-Tumbler_1601739263307.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.50-$1.73",
      "id": "1601951422916",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Chaozhou Tongxinghuajiang Ceramics Making Co., Ltd.",
      "title": "Festive Halloween Hand\u001ecrafted Bat Pattern Porcelain Coffee Mug Daily Drinkware Ceramic Water Tea Cup For Gift Retail Supply",
      "url": "https://www.alibaba.com/product-detail/Festive-Halloween-Hand-crafted-Bat-Pattern_1601951422916.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.49-$2.18",
      "id": "1601940168271",
      "minimum_order_text": "100 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shenzhen Hafly Technology Co., Ltd.",
      "title": "Custom Reusable Folding Drinking Mugs Eco Friendly Collapsible Travel Silicone Rubber Coffee Cup",
      "url": "https://www.alibaba.com/product-detail/Custom-Reusable-Folding-Drinking-Mugs-Eco_1601940168271.html"
    },
    {
      "display_currency": null,
      "display_price": "US $4.90-$7.50",
      "id": "1600831507733",
      "minimum_order_text": "1 piece",
      "supplier_country": "CN",
      "supplier_name": "Xiamen Jindajin Industry And Trade Co., Ltd",
      "title": "Best Sellers 4PCS Matcha Kit Ceramic Whisk Holder Chasen Bowl Tea Brush Japanese Engraved Ceramic Matcha Tool Set",
      "url": "https://www.alibaba.com/product-detail/Best-Sellers-4PCS-Matcha-Kit-Ceramic_1600831507733.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.90-$1.68",
      "id": "1600238329186",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Quanzhou Extraworld Imp And Exp Trading Co., Ltd.",
      "title": "Novelty Ceramic Embossed Hand Painting Unicorn Mugs Set With Cute Golden Decal Gift For Children",
      "url": "https://www.alibaba.com/product-detail/Novelty-Ceramic-Embossed-Hand-Painting-Unicorn_1600238329186.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.01-$0.04",
      "id": "1601892145619",
      "minimum_order_text": "5,000 pieces",
      "supplier_country": "CN",
      "supplier_name": "Sichuan Qiyun packaging Co., Ltd.",
      "title": "Wholesale Eco-Friendly Disposable Custom Printed 16oz 12oz 8oz Single Double Wall Kraft Paper Tea Coffee Cups With Lids",
      "url": "https://www.alibaba.com/product-detail/Wholesale-Eco-Friendly-Disposable-Custom-Printed_1601892145619.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.85-$1.35",
      "id": "1601078790383",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Quanzhou Extraworld Imp And Exp Trading Co., Ltd.",
      "title": "Dog Hug Green Stripe 3D Handmade Eco-Friendly Novelty Ceramic Coffee Mug With Cookie Holder Biscuit Pocket",
      "url": "https://www.alibaba.com/product-detail/Dog-Hug-Green-Stripe-3D-Handmade_1601078790383.html"
    },
    {
      "display_currency": null,
      "display_price": "US $25.99-$34.99",
      "id": "1601756704107",
      "minimum_order_text": "4 sets",
      "supplier_country": "CN",
      "supplier_name": "Shenzhen Armhorse Industry Co., Ltd.",
      "title": "Wholesale 18 Piece New Bone China Gold Rimmed White Luxury Elegant Porcelain Dinner Set for 6 with Gift Box",
      "url": "https://www.alibaba.com/product-detail/Wholesale-18-Piece-New-Bone-China_1601756704107.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.90-$2.45",
      "id": "1601394586977",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shanghai Karry Industrial Co., Ltd.",
      "title": "Custom Stainless Steel Double Wall Coffee Cup Vacuum Metal Water Cup Travel Coffee Mug Tumbler For Drinking Water",
      "url": "https://www.alibaba.com/product-detail/Custom-Stainless-Steel-Double-Wall-Coffee_1601394586977.html"
    },
    {
      "display_currency": null,
      "display_price": "US $9.90-$14.70",
      "id": "1601649704383",
      "minimum_order_text": "3 pieces",
      "supplier_country": "CN",
      "supplier_name": "Xiamen Jindajin Industry And Trade Co., Ltd",
      "title": "Custom Logo Portable 7PCS Matcha Tea Set Japanese Pottery Ceramic Bowl and Bamboo Whisk Gift Set with Powder Can",
      "url": "https://www.alibaba.com/product-detail/Custom-Logo-Portable-7PCS-Matcha-Tea_1601649704383.html"
    },
    {
      "display_currency": null,
      "display_price": "US $2.44-$2.73",
      "id": "1601815233601",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shanghai Karry Industrial Co., Ltd.",
      "title": "Bamboo Handle Coffee Mug Double Wall Stainless Steel Insulated Travel Mug Office Desktop Thermal Cup",
      "url": "https://www.alibaba.com/product-detail/Bamboo-Handle-Coffee-Mug-Double-Wall_1601815233601.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.01-$0.04",
      "id": "1601584180921",
      "minimum_order_text": "5,000 pieces",
      "supplier_country": "CN",
      "supplier_name": "Sichuan Botong Plastic Products Co., Ltd.",
      "title": "Custom Print LOGO Biodegradable 8 12 Oz Take Away Cup For Cafe Hot Drink To Go Double Wall Disposable Paper Coffee Cup With Lid",
      "url": "https://www.alibaba.com/product-detail/Custom-Print-LOGO-Biodegradable-8-12_1601584180921.html"
    },
    {
      "display_currency": null,
      "display_price": "US $2.15-$3.15",
      "id": "1600824978268",
      "minimum_order_text": "200 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shanghai Karry Industrial Co., Ltd.",
      "title": "Custom Logo Insulated 12oz 14oz 16oz Stainless Steel Cups Drink Water Tea Juice Beer Mugs Tumbler With Handle",
      "url": "https://www.alibaba.com/product-detail/Custom-Logo-Insulated-12oz-14oz-16oz_1600824978268.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.85-$2.49",
      "id": "1601439992500",
      "minimum_order_text": "200 pieces",
      "supplier_country": "CN",
      "supplier_name": "Yatang Brand Management (chengdu) Co., Ltd.",
      "title": "ZREGGUR Customized 500ml Stainless Steel Coffee Mug With Handle Portable Double Wall Vacuum Insulated Tumbler Travel Cup",
      "url": "https://www.alibaba.com/product-detail/ZREGGUR-Customized-500ml-Stainless-Steel-Coffee_1601439992500.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.80-$2.56",
      "id": "1600872226198",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Quanzhou Extraworld Imp And Exp Trading Co., Ltd.",
      "title": "Luxury Gold Magic Mug Customized Ceramic Brown Coffee Mugs Gift Wholesale Colour Changing Cup With Logo",
      "url": "https://www.alibaba.com/product-detail/Luxury-Gold-Magic-Mug-Customized-Ceramic_1600872226198.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.85-$1.92",
      "id": "1601519018740",
      "minimum_order_text": "100 pieces",
      "supplier_country": "CN",
      "supplier_name": "Yatang Brand Management (chengdu) Co., Ltd.",
      "title": "Custom Logo 12oz Insulated Egg Shape Coffee Mug Stainless Steel Vacuum Wine Tumbler With Travel Lid For On-The-Go Drinking",
      "url": "https://www.alibaba.com/product-detail/Custom-Logo-12oz-Insulated-Egg-Shape_1601519018740.html"
    },
    {
      "display_currency": null,
      "display_price": "US $5.55-$6.16",
      "id": "1601935979522",
      "minimum_order_text": "1,000 pieces",
      "supplier_country": "CN",
      "supplier_name": "NINGBO DONG JIE XI HARDWARE PRODUCTS CO., LTD.",
      "title": "Floral Enamel Mug Vintage Flower Print Coffee Cup For Home Kitchen Daily Coffee Tea Drinking Wholesale",
      "url": "https://www.alibaba.com/product-detail/Floral-Enamel-Mug-Vintage-Flower-Print_1601935979522.html"
    },
    {
      "display_currency": null,
      "display_price": "US $0.68-$3.79",
      "id": "1601892430451",
      "minimum_order_text": "200 pieces",
      "supplier_country": "CN",
      "supplier_name": "Yatang Brand Management (chengdu) Co., Ltd.",
      "title": "350ml Custom Coffee Tumbler Gift Set 12oz Stainless Steel Travel Mug With Flip Lid Powder Coated OEM ODM Wholesale",
      "url": "https://www.alibaba.com/product-detail/350ml-Custom-Coffee-Tumbler-Gift-Set_1601892430451.html"
    },
    {
      "display_currency": null,
      "display_price": "US $3.60-$4.18",
      "id": "1601032376114",
      "minimum_order_text": "300 pieces",
      "supplier_country": "CN",
      "supplier_name": "Zhejiang Ansheng Science & Technology Stock Co., Ltd.",
      "title": "Customized Logo 16oz Vacuum Stainless Steel Coffee Tea Mug",
      "url": "https://www.alibaba.com/product-detail/Customized-Logo-16oz-Vacuum-Stainless-Steel_1601032376114.html"
    },
    {
      "display_currency": null,
      "display_price": "US $2.21-$2.65",
      "id": "1601156655028",
      "minimum_order_text": "200 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shanghai Karry Industrial Co., Ltd.",
      "title": "Portable Outdoor Travel Coffee Mug Thermos Cup Ice Coffee Mug With Lids And Lanyard",
      "url": "https://www.alibaba.com/product-detail/Portable-Outdoor-Travel-Coffee-Mug-Thermos_1601156655028.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.99-$2.29",
      "id": "1600072431689",
      "minimum_order_text": "50 pieces",
      "supplier_country": "CN",
      "supplier_name": "Yongkang Hejia Industry And Trade Co., Ltd.",
      "title": "Wholesale 20 30 Ounce Matte Color Marble Insulated Double Walled Tumbler Cups In Bulk With Custom Print Logo",
      "url": "https://www.alibaba.com/product-detail/Wholesale-20-30-Ounce-Matte-Color_1600072431689.html"
    },
    {
      "display_currency": null,
      "display_price": "US $2.80-$3.50",
      "id": "1601942464404",
      "minimum_order_text": "25 pieces",
      "supplier_country": "CN",
      "supplier_name": "Shijiazhuang Langkuo Trading Co., Ltd.",
      "title": "Customized Matte Leakproof Flip Lid Insulated Custom Logo Stainless Steel Coffee Mug Office Travel",
      "url": "https://www.alibaba.com/product-detail/Customized-Matte-Leakproof-Flip-Lid-Insulated_1601942464404.html"
    },
    {
      "display_currency": null,
      "display_price": "US $3.86-$4.29",
      "id": "1601942197237",
      "minimum_order_text": "1,000 pieces",
      "supplier_country": "CN",
      "supplier_name": "NINGBO DONG JIE XI HARDWARE PRODUCTS CO., LTD.",
      "title": "Bulk Order No Handle Enamel Mug Kitchen Enamel Drinking Cup For Household Tea Coffee Water Daily Drinking Application",
      "url": "https://www.alibaba.com/product-detail/Bulk-Order-No-Handle-Enamel-Mug_1601942197237.html"
    },
    {
      "display_currency": null,
      "display_price": "US $4.38-$5.32",
      "id": "1601929719282",
      "minimum_order_text": "200 pieces",
      "supplier_country": "CN",
      "supplier_name": "Yatang Brand Management (chengdu) Co., Ltd.",
      "title": "400ml Ceramic Lined Coffee Tumbler With Dual Sip Lid Stainless Steel Travel Mug With Straw Carry Handle Custom Logo Wholesale",
      "url": "https://www.alibaba.com/product-detail/400ml-Ceramic-Lined-Coffee-Tumbler-With_1601929719282.html"
    },
    {
      "display_currency": null,
      "display_price": "US $3.78-$4.61",
      "id": "1601267242883",
      "minimum_order_text": "100 pieces",
      "supplier_country": "CN",
      "supplier_name": "Zhejiang Ansheng Science & Technology Stock Co., Ltd.",
      "title": "Sliding Lid Stainless Steel Mug Custom Logo Travel Coffee Cup 16oz Sublimation Coffee Mug Camping Mug With Handle",
      "url": "https://www.alibaba.com/product-detail/Sliding-Lid-Stainless-Steel-Mug-Custom_1601267242883.html"
    },
    {
      "display_currency": null,
      "display_price": "US $3.90-$9.90",
      "id": "1601361179245",
      "minimum_order_text": "5 pieces",
      "supplier_country": "CN",
      "supplier_name": "Dongguan Sheerfond New Materials Co., Ltd.",
      "title": "Hot Selling USB Coffee Mug Warmer Electric Thermostatic Coasters For Home Office Hot Milk Tea Water Heater Thermostatic USB Pad",
      "url": "https://www.alibaba.com/product-detail/Hot-Selling-USB-Coffee-Mug-Warmer_1601361179245.html"
    },
    {
      "display_currency": null,
      "display_price": "US $1.99-$4.05",
      "id": "1601080509114",
      "minimum_order_text": "100 pieces",
      "supplier_country": "CN",
      "supplier_name": "Zhejiang Ansheng Science & Technology Stock Co., Ltd.",
      "title": "Custom Logo Stainless Steel Egg Mugs Tumbler Travel Insulated Beer Coffee Thermo Steel Mug With Lid",
      "url": "https://www.alibaba.com/product-detail/Custom-Logo-Stainless-Steel-Egg-Mugs_1601080509114.html"
    },
    {
      "display_currency": null,
      "display_price": "US $20.30-$25.60",
      "id": "1601674488387",
      "minimum_order_text": "500 pieces",
      "supplier_country": "CN",
      "supplier_name": "Dongguan Sheerfond New Materials Co., Ltd.",
      "title": "Portable Stainless Steel Led Digital Temperature-Controlled Self-Heating Coffee Mug Factory Designed Smart Coffee Mug",
      "url": "https://www.alibaba.com/product-detail/Portable-Stainless-Steel-Led-Digital-Temperature_1601674488387.html"
    },
    {
      "display_currency": null,
      "display_price": "US $3.78-$4.01",
      "id": "1601297553386",
      "minimum_order_text": "1,000 pieces",
      "supplier_country": "CN",
      "supplier_name": "Zhejiang Ansheng Science & Technology Stock Co., Ltd.",
      "title": "Hot Selling Customize Logo Factory Stainless Steel Vacuum Insulation Coffee Cup Mug With Handle",
      "url": "https://www.alibaba.com/product-detail/Hot-Selling-Customize-Logo-Factory-Stainless_1601297553386.html"
    }
  ],
  "source_total": 175928,
  "source_url": "https://www.alibaba.com/premium/ceramic_mug.html"
}
```

### Specifications

- Capability: `retail/specifications`
- Description: Read supplier-advertised product specifications as name/value pairs. Preserves duplicate attribute labels and makes no independent certification claims.
- Instructions: Read supplier-advertised product specifications as name/value pairs. Preserves duplicate attribute labels and makes no independent certification claims.
- Cost: 5 credits per call
- Capability file: [Specifications](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/specifications)

Accepted options:
- `url` (string, required): Exact https://www.alibaba.com/product-detail/<slug>_<numeric-id>.html URL without query or fragment. Pattern: ^https://www\.alibaba\.com/product-detail/[A-Za-z0-9-]+_[0-9]{1,20}\.html$. Example: `<url>`

Response schema example:
```json
{
  "complete": false,
  "observed_at_ms": 1789508227088,
  "records": [
    {
      "id": "1601651021684",
      "name": "drinkware type",
      "value": "MUGS"
    },
    {
      "id": "1601651021684",
      "name": "Accessories",
      "value": "With None"
    },
    {
      "id": "1601651021684",
      "name": "type",
      "value": "Coffee Mugs"
    },
    {
      "id": "1601651021684",
      "name": "occasion",
      "value": "Back to School/Presents/ Business Gifts/ Giveaways"
    },
    {
      "id": "1601651021684",
      "name": "style",
      "value": "Minimalist, Modern"
    },
    {
      "id": "1601651021684",
      "name": "type of water bottle caps",
      "value": "no"
    },
    {
      "id": "1601651021684",
      "name": "material",
      "value": "Ceramic"
    },
    {
      "id": "1601651021684",
      "name": "ceramic type",
      "value": "Porcelain"
    },
    {
      "id": "1601651021684",
      "name": "feature",
      "value": "Stocked"
    },
    {
      "id": "1601651021684",
      "name": "place of origin",
      "value": "Zhejiang, China"
    },
    {
      "id": "1601651021684",
      "name": "brand name",
      "value": "Gloway"
    },
    {
      "id": "1601651021684",
      "name": "model number",
      "value": "PL-BZ001-11-1-1"
    },
    {
      "id": "1601651021684",
      "name": "Pattern",
      "value": "logo"
    },
    {
      "id": "1601651021684",
      "name": "Packaging",
      "value": "Paper Bag, Gift Box, Bubble Bag, Plastic Box"
    },
    {
      "id": "1601651021684",
      "name": "Application",
      "value": "Hotel, Home, Office, Gift"
    },
    {
      "id": "1601651021684",
      "name": "dishwasher safe",
      "value": "Yes"
    },
    {
      "id": "1601651021684",
      "name": "Microwave Safe",
      "value": "Yes"
    },
    {
      "id": "1601651021684",
      "name": "Product Name",
      "value": "Popular Diy Gift Custom LOGO 11oz Simple White Coffee Sublimation Mugs"
    },
    {
      "id": "1601651021684",
      "name": "Dimensions",
      "value": "8.2 x 8.2 x 9.6 cm / 11Oz."
    },
    {
      "id": "1601651021684",
      "name": "Color",
      "value": "White"
    },
    {
      "id": "1601651021684",
      "name": "Feature",
      "value": "Simple, Bright And Smooth Surface, Durable And Anti-Slip Bottom"
    },
    {
      "id": "1601651021684",
      "name": "Ideal For",
      "value": "Personalized Gift (Print Anything You Want On The Mug)"
    },
    {
      "id": "1601651021684",
      "name": "Package",
      "value": "Brown Box, Gift Box, White Paper Box or Customized"
    },
    {
      "id": "1601651021684",
      "name": "Sample",
      "value": "Provided"
    },
    {
      "id": "1601651021684",
      "name": "LOGO",
      "value": "Customized Logo"
    },
    {
      "id": "1601651021684",
      "name": "OEM and ODM",
      "value": "Acceptable"
    },
    {
      "id": "1601651021684",
      "name": "Type",
      "value": "Blank Ceramic Mug For Sublimation Printing"
    }
  ],
  "source_url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
}
```

### Supplier

- Capability: `retail/supplier`
- Description: Read the supplier summary attached to an Alibaba product: identity, country, business type, platform tenure and source-reported response/delivery metrics. Not a supplier background verification.
- Instructions: Read the supplier summary attached to an Alibaba product: identity, country, business type, platform tenure and source-reported response/delivery metrics. Not a supplier background verification.
- Cost: 5 credits per call
- Capability file: [Supplier](https://firecrawl.dev/alexandria/agents/providers/alibaba/retail/supplier)

Accepted options:
- `url` (string, required): Exact https://www.alibaba.com/product-detail/<slug>_<numeric-id>.html URL without query or fragment. Pattern: ^https://www\.alibaba\.com/product-detail/[A-Za-z0-9-]+_[0-9]{1,20}\.html$. Example: `<url>`

Response schema example:
```json
{
  "complete": false,
  "observed_at_ms": 1789508227088,
  "records": [
    {
      "business_type": "Manufacturer,Trading Company",
      "company_id": "274845515",
      "company_name": "Ningbo Purly Imp. & Exp. Co., Ltd.",
      "country": "CN",
      "on_time_delivery_text": "99.2%",
      "product_id": "1601651021684",
      "response_time_text": "≤3h",
      "source_assessment_passed": true,
      "years_on_platform": 4
    }
  ],
  "source_url": "https://www.alibaba.com/product-detail/Custom-Logo-Dishwasher-Microwave-Safe-Ceramic_1601651021684.html"
}
```