# Alibaba.com Products Scraper \[💰$1.5/1000 results] (`confidential_gnat/alibaba-products-scraper`) Actor

For only💰$1.5/1000 results scrape wholesale products from Alibaba.com by product, search or category URL: title, price tiers, MOQ, supplier and profile link, location, ratings, specifications, images, shipping and lead times.

- **URL**: https://apify.com/confidential_gnat/alibaba-products-scraper.md
- **Developed by:** [ActorFlow](https://apify.com/confidential_gnat) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Alibaba.com (Alibaba) Products Scraper

**Scrape wholesale products from Alibaba.com (www.alibaba.com)**: title, price tiers, minimum order quantity (MOQ), supplier name and profile link, country, ratings, specifications, images, shipping details and lead times. Export the data as **JSON, CSV or Excel** or call the actor as an **API**. Paste a product, search or category URL, press Start, and get clean product data in minutes.

**Target website:** [alibaba.com](https://www.alibaba.com)

![Alibaba Products Scraper - wholesale product, price, MOQ and supplier data cover](https://iili.io/nOq5gyl.jpg)

### ✨ Features of this Alibaba product scraper

- **Wholesale product extraction** — product pages, search results and category pages from Alibaba.com, with price tiers, MOQ, specifications, variants, images and video link.
- **Supplier data** — supplier name, profile and store links, country, business type, badge, years on Alibaba, store rating, response time and on-time delivery rate.
- **Shipping and lead times** — price terms (for example FOB), ships-from country, unit weight and size, and lead time by order quantity.
- **Pagination support** — follows result pages until `maxItems` is reached for each start URL.
- **Filters kept** — price range, minimum order and supplier country filters already in a search URL are applied.
- **Scrape only new products (cache)** — set a cache project name and every run skips products you already have: no repeat charges, no repeat product-page requests, perfect for daily or weekly monitoring. See [Scrape only new products](#-scrape-only-new-alibaba-products-with-the-cache).
- **Proxy support** — residential proxies are selected by default.

### 🚀 How to scrape Alibaba products in 5 steps

1. [Sign up](https://apify.com/sign-up) for a free Apify account — includes **$5 monthly credit**.
2. Open the actor page and click **Try for free**.
3. Fill in the **Input** fields (at least one start URL is required).
4. Click **Start** and wait for the run to complete.
5. Download results from the **Output** tab in JSON, CSV, or Excel format.

You can also run this actor via the [Apify API](https://docs.apify.com/api/v2) or integrate it directly into your workflows using [Zapier](https://zapier.com/apps/apify), [Make](https://www.make.com/), or [n8n](https://n8n.io/).

### 💰 Pricing for the Alibaba scraper

This actor uses **pay-per-result** billing based on the compute units a run consumes.

- New Apify accounts include **$5 of free monthly credit**.
- The actor does not use a browser, so it costs significantly less to run than browser-based scrapers.
- Turning off **Scrape product pages** keeps runs even cheaper when the basic card data from search pages is enough.

### 🔧 Alibaba scraper input configuration

![Alibaba Products Scraper input form with the URLs, max products, cache project name and scrape product pages fields marked 1 to 4](https://iili.io/nOq7ONV.png)

The numbers in the screenshot: **1** the product, search or category URLs, **2** how many products to save per URL, **3** the optional cache project name that skips products you already have, **4** whether to open every product page for the full data.

| Field | Type | Required | Default | Description |
| ----- | ---- | -------- | ------- | ----------- |
| Product, search or category URLs (`startUrls`) | array | ✅ | https://www.alibaba.com/trade/search?SearchText=sandals\&tab=all | Alibaba.com product pages, search pages and category pages. Filters in the URL (price range, minimum order, supplier country) are kept. |
| Max products per start URL (`maxItems`) | integer | — | 5 | Maximum products saved for each search or category URL. Alibaba shows at most 4,800 products per search. |
| Cache project name (`cacheProjectName`) | string | — | — | Skips products already saved under this name in earlier runs; they are not charged or counted towards Max products. New products get `changeType: new`. Leave empty to scrape everything. |
| Scrape product pages (`scrapeDetails`) | boolean | — | true | Open every product page for price tiers, specifications, images, shipping and full supplier data. Turn off for basic card data only. |
| Proxy configuration (`proxyConfiguration`) | object | — | Apify Proxy, RESIDENTIAL group | Proxy used to open product pages. Residential proxies are recommended. |

**Supported URL types:**

- Product page: `https://www.alibaba.com/product-detail/New-Arrivals-Leather-Sandals-for-Men_62162463120.html`
- Search page: `https://www.alibaba.com/trade/search?SearchText=sandals&tab=all`
- Search with filters: `https://www.alibaba.com/trade/search?SearchText=laptop+stand&pricef=5&pricet=30`
- Category page: `https://www.alibaba.com/catalog/Sandals_cid201152907`
- Keyword page: `https://www.alibaba.com/products/yoga-mat.html`

### 📦 Alibaba scraper output data

The actor saves one JSON record per product with these keys: `id`, `url`, `title`, `price`, `priceMin`, `priceMax`, `currency`, `priceTiers`, `moq`, `moqUnit`, `brand`, `modelNumber`, `placeOfOrigin`, `category`, `categoryId`, `categoryPath`, `attributes`, `variants`, `images`, `videoUrl`, `supplierName`, `supplierId`, `supplierUrl`, `supplierStoreUrl`, `supplierCountry`, `supplierType`, `supplierBadge`, `supplierYears`, `supplierRating`, `supplierReviewCount`, `supplierResponseTime`, `supplierOnTimeDeliveryRate`, `supplierOnlineRevenue`, `rating`, `reviewCount`, `shippingTerms`, `shipsFrom`, `unitWeightKg`, `unitSize`, `leadTimes`, `isCustomizable`, `isSponsored`, `sourceUrl`, `changeType` (`new` when the cache is on, otherwise `null`). Fields that are not available for a product are `null`.

The dataset has 2 views. **Overview** is a compact table of product, price, MOQ, supplier, country, rating, category and link. **Suppliers** shows who sells each product: profile link, country, type, badge, years on Alibaba, ratings, response time and on-time delivery rate.

**Output at a glance:**

| Product | Price | MOQ | Supplier | Country | Rating | Reviews |
| ------- | ----- | --- | -------- | ------- | ------ | ------- |
| [Vigo Korean-style Men's Sandals Summer T...](https://www.alibaba.com/product-detail/Vigo-Korean-style-Men-s-Sandals_1601919214424.html) | $18.20-20 | 1 pieces | Jiangmen Fanmeng Footwear Co | CN | 5 | 4 |
| [New High Quality Breathable Open Sports ...](https://www.alibaba.com/product-detail/New-High-Quality-Breathable-Open-Sports_1601710934770.html) | $11.05-12.35 | 20 pairs | Quanzhou Chongchi Supply Cha | CN | 4.7 | 58 |

**Sample output (raw JSON):**

```json
[
  {
    "id": "1601919214424",
    "url": "https://www.alibaba.com/product-detail/Vigo-Korean-style-Men-s-Sandals_1601919214424.html",
    "title": "Vigo Korean-style Men's Sandals Summer Trendy Slip-on Beach Shoes Casual Breathable Genuine Leather Anti-Slippery Peep Toe",
    "price": "$18.20-20",
    "priceMin": 18.2,
    "priceMax": 20,
    "currency": "USD",
    "priceTiers": [
      {
        "minQuantity": 1,
        "maxQuantity": 9,
        "price": 20,
        "formattedPrice": "$20",
        "promotionPrice": null
      },
      {
        "minQuantity": 10,
        "maxQuantity": 19,
        "price": 18.8,
        "formattedPrice": "$18.80",
        "promotionPrice": null
      }
    ],
    "moq": 1,
    "moqUnit": "pieces",
    "brand": "VOGU",
    "modelNumber": "F1585",
    "placeOfOrigin": "Please consult",
    "category": "Sandals",
    "categoryId": "201152907",
    "categoryPath": [
      "Shoes & Accessories",
      "Men's Shoes"
    ],
    "attributes": {
      "Outsole Material": "Rubber",
      "Upper Material": "Top-grain cowhide",
      "Feature": "Light Weight, Anti-Slippery, Hard-Wearing, comfort",
      "Place of Origin": "Please consult",
      "Brand Name": "VOGU",
      "Model Number": "F1585"
    },
    "variants": [
      {
        "name": "Color",
        "values": [
          "Black",
          "Chocolate color"
        ]
      },
      {
        "name": "EUR Size(US)",
        "values": [
          "38(6.5)",
          "39(6.5)",
          "40(7.5)",
          "41(8)",
          "42(8.5)",
          "43(9.5)"
        ]
      }
    ],
    "images": [
      "https://sc04.alicdn.com/kf/Hf61fb3004f4d4b4aa97304679ff4e70fk.jpg",
      "https://sc04.alicdn.com/kf/H41ab7c5a8ba8489eba5f3118147b5a9bO.jpg"
    ],
    "videoUrl": null,
    "supplierName": "Jiangmen Fanmeng Footwear Co., Ltd.",
    "supplierId": "292372784",
    "supplierUrl": "https://brounvanm.en.alibaba.com/company_profile.html",
    "supplierStoreUrl": "https://brounvanm.en.alibaba.com/index.html",
    "supplierCountry": "CN",
    "supplierType": "Manufacturer,Trading Company",
    "supplierBadge": "Gold Supplier",
    "supplierYears": "1 yr",
    "supplierRating": 5,
    "supplierReviewCount": 4,
    "supplierResponseTime": "≤2h",
    "supplierOnTimeDeliveryRate": "100.0%",
    "supplierOnlineRevenue": "$5K — $10K",
    "rating": 5,
    "reviewCount": 4,
    "shippingTerms": "FOB",
    "shipsFrom": "CN",
    "unitWeightKg": 1,
    "unitSize": "32X6X12",
    "leadTimes": [
      {
        "minQuantity": 1,
        "maxQuantity": 1,
        "days": 7
      }
    ],
    "isCustomizable": false,
    "isSponsored": true,
    "sourceUrl": "https://www.alibaba.com/trade/search?tab=all&categoryId=201152907"
  },
  {
    "id": "1601710934770",
    "url": "https://www.alibaba.com/product-detail/New-High-Quality-Breathable-Open-Sports_1601710934770.html",
    "title": "New High Quality Breathable Open Sports African Sandals Women 36-47 Big Size Anti-slip comfort Mesh Upper Rubber Outsole Beach",
    "price": "$11.05-12.35",
    "priceMin": 11.05,
    "priceMax": 12.35,
    "currency": "USD",
    "priceTiers": [
      {
        "minQuantity": 20,
        "maxQuantity": 99,
        "price": 12.35,
        "formattedPrice": "$12.35",
        "promotionPrice": null
      },
      {
        "minQuantity": 100,
        "maxQuantity": 499,
        "price": 11.85,
        "formattedPrice": "$11.85",
        "promotionPrice": null
      }
    ],
    "moq": 20,
    "moqUnit": "pairs",
    "brand": "CC",
    "modelNumber": "CC-552",
    "placeOfOrigin": "Fujian, China",
    "category": "Sandals",
    "categoryId": "201152907",
    "categoryPath": [
      "Shoes & Accessories",
      "Men's Shoes"
    ],
    "attributes": {
      "Outsole Material": "Rubber",
      "Upper Material": "Mesh",
      "Feature": "Breathable, Hard-Wearing, Fashion Trend, Anti-Slip, Soft",
      "Place of Origin": "Fujian, China",
      "Brand Name": "CC",
      "Model Number": "CC-552"
    },
    "variants": [
      {
        "name": "Color",
        "values": [
          "khaki",
          "Green",
          "Black"
        ]
      },
      {
        "name": "EUR Size",
        "values": [
          "36",
          "37",
          "38",
          "39",
          "40",
          "41",
          "42",
          "43",
          "44",
          "45",
          "46",
          "47"
        ]
      }
    ],
    "images": [
      "https://sc04.alicdn.com/kf/H9cbdb7db9b794dffb5eecc26da98d6d5R.jpg",
      "https://sc04.alicdn.com/kf/Ha31380a85fd342a4b1f6bea17785db6d7.jpg"
    ],
    "videoUrl": "https://gv.videocdn.alibaba.com/icbu_vod_video/video_target/gv9c-c3ceb0d6-a1ac22a4-9c2cfe81-451e/trans/aidc/m91xvm-h264-hd.mp4?bizCode=icbu_vod_video",
    "supplierName": "Quanzhou Chongchi Supply Chain Management Co., Ltd.",
    "supplierId": "292204354",
    "supplierUrl": "https://ccshoes.en.alibaba.com/company_profile.html",
    "supplierStoreUrl": "https://ccshoes.en.alibaba.com/index.html",
    "supplierCountry": "CN",
    "supplierType": "Trading Company",
    "supplierBadge": "Gold Supplier",
    "supplierYears": "1 yr",
    "supplierRating": 4.7,
    "supplierReviewCount": 58,
    "supplierResponseTime": "≤1h",
    "supplierOnTimeDeliveryRate": "100.0%",
    "supplierOnlineRevenue": null,
    "rating": 4.7,
    "reviewCount": 58,
    "shippingTerms": "FOB",
    "shipsFrom": "CN",
    "unitWeightKg": 0.65,
    "unitSize": "34X22X13",
    "leadTimes": [
      {
        "minQuantity": 1,
        "maxQuantity": 20,
        "days": 7
      }
    ],
    "isCustomizable": true,
    "isSponsored": true,
    "sourceUrl": "https://www.alibaba.com/trade/search?tab=all&categoryId=201152907"
  }
]
```

### 🔁 Scrape only new Alibaba products with the cache

Most Alibaba scrapers return the same products every time you run them, and you pay for all of them again. This actor can **remember what it has already saved** and give you only the new products.

1. Type any name into **Cache project name**, for example `sandals-weekly`.
2. Run the actor. Every product it saves is remembered under that name.
3. Run it again with **the same name**, on a schedule or by hand. Products you already have are **skipped before their product page is opened**, so they are **not charged**, **not counted towards Max products per start URL**, and the run finishes faster.
4. Every product saved while the cache is on carries `changeType: "new"`.

Good to know:

- Each cache name is its own cache, so you can keep a separate one per search, category or customer.
- The actor keeps paging through results until it has found as many new products as Max products asks for, so a daily run over a growing search returns just the fresh listings.
- A product saved with **Scrape product pages** turned off is remembered as basic card data only. If you later run with product pages turned on, it is scraped again for the full data.
- Delete the cache by using a new name, or by removing the key-value store named `alibaba-<your-name>` in your Apify account.
- Tip: combine the cache with [Apify Schedules](https://docs.apify.com/platform/schedules) to get a daily or weekly feed of newly listed products.

### 🐍 How to scrape Alibaba with Python, JavaScript or the API

Run the actor programmatically with the official Apify clients. Replace `<YOUR_API_TOKEN>` with the token from your [Apify Console](https://console.apify.com/account/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run = client.actor("confidential_gnat/alibaba-products-scraper").call(run_input={
    "startUrls": [{"url": "https://www.alibaba.com/trade/search?SearchText=sandals&tab=all"}],
    "maxItems": 20,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**JavaScript** (`npm install apify-client`):

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });

const run = await client.actor('confidential_gnat/alibaba-products-scraper').call({
    startUrls: [{ url: 'https://www.alibaba.com/trade/search?SearchText=sandals&tab=all' }],
    maxItems: 20,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**cURL** — start a run and wait for the dataset:

```bash
curl -X POST "https://api.apify.com/v2/acts/confidential_gnat~alibaba-products-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": [{"url": "https://www.alibaba.com/trade/search?SearchText=sandals&tab=all"}], "maxItems": 20}'
```

### 💡 What you can use Alibaba product data for

- Sourcing and supplier shortlisting: compare price tiers, MOQ and lead times across suppliers.
- Price monitoring of wholesale products and competitor catalogues.
- Dropshipping and private-label research: find trending products and their typical factory prices.
- Market research by category: see which countries, supplier types and specifications dominate.
- Building product databases and marketplace feeds with specifications, images and supplier links.

Importers, e-commerce sellers, procurement teams, market analysts and sourcing agents in retail, consumer goods, electronics and fashion typically use this data.

### ⚠️ Limitations of the Alibaba scraper

- **Search depth** — Alibaba shows at most 100 pages (4,800 products) per search. To collect more, add several narrower search or category URLs (for example different keywords or sub-categories).
- **Login-required content** — The actor cannot access content behind authentication, such as verified contact details of suppliers.
- **Occasional blocks** — Alibaba sometimes shows a bot check; the actor retries automatically, which can make single pages take longer.
- **Region and currency** — Prices are the USD prices shown to visitors from the proxy's country.

### ❓ Alibaba scraper FAQ

#### Can I scrape Alibaba.com legally?

The actor only collects data that is already publicly visible on Alibaba.com. It does not log in or access private content. Scraping publicly available data is generally considered lawful (see *hiQ Labs v. LinkedIn*), but you are responsible for complying with Alibaba's Terms of Service and applicable laws such as GDPR or CCPA if personal data is involved.

#### What data does the Alibaba scraper return?

Each product has its title, price range and price tiers, MOQ, specifications, variants, images, category path, supplier name and profile link, country, ratings, shipping terms, weight, size and lead times. With **Scrape product pages** turned off you get the basic card data from search pages.

#### How many products can I scrape from one Alibaba search?

`maxItems` limits the products for each start URL, not for the whole run. Alibaba shows at most 4,800 products per search (100 pages), so that is the most one search URL can return; use several narrower URLs to collect more.

#### Do I need a proxy to scrape alibaba.com?

The input defaults to Apify residential proxies, which give the best success rate on product pages. Datacenter proxies are blocked more often and can slow a run down through retries.

#### How do I scrape Alibaba with Python?

Use the Python example above with the Apify client, pass your start URLs and `maxItems`, then iterate over the dataset items.

#### Can I run this Alibaba scraper on a schedule?

Yes. Use Apify Schedules to run the actor daily or weekly. Add a **Cache project name** and each scheduled run returns only products you have not seen before. Without the cache, every run returns the current data, which is the way to track price and MOQ changes over time.

#### What output formats are supported?

JSON, CSV, Excel, XML and RSS, either from the **Output** tab or through the Apify API.

#### Why do some products have a null rating or null supplier details?

Alibaba only shows ratings, weights or revenue figures when the supplier has published them, so the actor returns `null` for missing values instead of guessing.

#### Is this the cheapest Alibaba scraper in Apify?

Possibly yes, this actor has caching feature to skip previously scraped data so it might be the cheapest Alibaba product scraper.

### 🔗 Relevant actors for Alibaba products

| Scraper | Description |
| ------- | ----------- |
| [🛒 Tokopedia Product Scraper](https://apify.com/confidential_gnat/tokopedia-products-scraper) | Scrape Tokopedia product data: title, shop, price, stock, category and images. |
| [🏷️ Carousell Products Scraper](https://apify.com/confidential_gnat/carousell-products-scraper) | Scrape Carousell.sg product listings for prices, seller ratings and deal methods. |
| [🎌 Mercari Japan Scraper](https://apify.com/confidential_gnat/mercari-japan-listings-scraper) | Scrapes Mercari Japan listings: price in JPY, status, condition and seller. |
| [🥦 Woolworths Products Scraper](https://apify.com/confidential_gnat/woolworths-products-scraper) | Scrape Woolworths Australia grocery products: name, brand, price and unit price. |
| [🍷 Total Wine Scraper](https://apify.com/confidential_gnat/totalwine-scraper) | Scrape Total Wine & More wine, liquor and beer prices, sizes and ratings. |

### 🔗 Other actors you may find useful

| Scraper | Description |
| ------- | ----------- |
| [📋 Craigslist Listings Scraper](https://apify.com/confidential_gnat/craigslist-listings-scraper) | Scrapes Craigslist classified listings in any city and category. |
| [💼 Dice Jobs Scraper](https://apify.com/confidential_gnat/dice-jobs-scraper) | Scrapes tech job listings from Dice by keyword or URL. |
| [📑 Google Patents Scraper](https://apify.com/confidential_gnat/google-patents-scraper) | Scrapes patent data from Google Patents by keyword or URL. |
| [🍇 Vivino Wine Scraper](https://apify.com/confidential_gnat/vivino-wine-scraper) | Scrapes wine data from Vivino: name, winery, vintage, region and ratings. |
| [🏠 99acres Property Scraper](https://apify.com/confidential_gnat/99acres-property-scraper) | Scrapes property listings from 99acres: price, area, bedrooms and location. |

### 💬 Support & contact

If you encounter any issues or have questions, please [open an issue](https://apify.com/confidential_gnat/alibaba-products-scraper/issues/open) or reach out via the [Apify Community Forum](https://community.apify.com/).

You can also find more of our actors on the [Actor Flow](https://apify.com/confidential_gnat) page.

# Actor input Schema

## `startUrls` (type: `array`):

Alibaba.com product pages (https://www.alibaba.com/product-detail/...), search pages (https://www.alibaba.com/trade/search?SearchText=sandals) and category pages (https://www.alibaba.com/catalog/Sandals_cid201152907). Filters already in the URL (price range, minimum order, supplier country) are kept.

## `maxItems` (type: `integer`):

Maximum products saved for each search or category URL. The site shows at most 4,800 products per search.

## `cacheProjectName` (type: `string`):

Scrape only new products. Products already saved under this name in an earlier run are skipped before their product page is opened, so they are not charged and not counted towards Max products. New products get changeType: new. Use the same name on every scheduled run; different names keep separate caches. Leave empty to scrape everything.

## `scrapeDetails` (type: `boolean`):

Open every product page for price tiers, specifications, images, shipping details and full supplier information. Turn it off to save only the basic card data from the search page, which is faster.

## `proxyConfiguration` (type: `object`):

Proxy used to open product pages. Residential proxies are recommended because Alibaba blocks most datacenter addresses.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.alibaba.com/trade/search?SearchText=sandals&tab=all"
    }
  ],
  "maxItems": 5,
  "scrapeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.alibaba.com/trade/search?SearchText=sandals&tab=all"
        }
    ],
    "maxItems": 5,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("confidential_gnat/alibaba-products-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.alibaba.com/trade/search?SearchText=sandals&tab=all" }],
    "maxItems": 5,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("confidential_gnat/alibaba-products-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.alibaba.com/trade/search?SearchText=sandals&tab=all"
    }
  ],
  "maxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call confidential_gnat/alibaba-products-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,confidential_gnat/alibaba-products-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/5MISMTh0HI8bicuDh/builds/lFCoUu3mThG82vGqt/openapi.json
