# Alibaba Scraper - Products & Verified Suppliers (`zen-studio/alibaba-scraper`) Actor Scrape Alibaba products with tiered pricing, MOQ, specs, SKUs, certifications, and the verified manufacturer behind each. Browse a whole category or search by keyword. Add store reviews and full supplier verification reports. Filter by category, country, and price. Export to JSON, CSV, Excel. - **URL**: https://apify.com/zen-studio/alibaba-scraper.md - **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Alibaba Scraper - Products & Verified Suppliers ![Alibaba.com scraper output: a product with tiered pricing and MOQ, its verified manufacturer with Trade Assurance, response time, and on-time delivery, as structured JSON](https://iili.io/Cn4krQ9.png)
500 results in under a minute, 80+ fields each: tiered pricing, the full SKU matrix, specs, certifications, and the verified manufacturer behind every listing. Add store reviews and full SGS-style verification reports on demand. The richest Alibaba.com output on Apify.
Zen Studio B2B Sourcing   •  Supplier, product & import data across global marketplaces
Alibaba Scraper ➤ here 1688 Wholesale ImportYeti ThomasNet Suppliers
#### Copy page for your AI Assistant ```` zen-studio/alibaba-scraper on Apify. Scrapes Alibaba.com products and verified manufacturers by keyword. Call ApifyClient("TOKEN").actor("zen-studio/alibaba-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items. Set resultType to "products", "suppliers", or "category" (browse a whole category). keywords is required for products/suppliers; for category mode set category instead (keyword optional, narrows the browse). category also filters a products search. Full spec: GET https://api.apify.com/v2/acts/zen-studio~alibaba-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations ```` ### Key Features - **80+ data points per product**: title, image gallery, tiered ladder pricing, MOQ, the full SKU attribute matrix, specs, and certifications, all in one row. - **Verified manufacturer attached to every product**: company identity, business type, Trade Assurance amount, response time, on-time delivery rate, and reorder stats, no second lookup needed. - **Three ways in**: search product listings (each with its supplier), search manufacturer/factory profiles, or browse an entire industry category. - **Filter or browse by category**: narrow a keyword search to one of 38 industry categories (down to a specific subcategory), or browse a whole category with no keyword at all. - **On-demand enrichments**: add a supplier's store reviews and the full SGS-style verification report to any product result. - **Deep filtering**: marketplace, ship-to country, price, MOQ, supplier country, verification level, certifications, delivery time, and samples. - **Free tier**: 10 lifetime runs, 20 results per run, no credit card required. ### How to Scrape Alibaba.com Data Pick a result type, type your keywords, and run. Each keyword is searched independently, and **Max results** applies per keyword. #### Basic: products by keyword ```json { "resultType": "products", "keywords": ["led lights"], "maxResults": 100 } ```` #### Browse a whole category (no keyword) ```json { "resultType": "category", "category": "Lights & Lighting", "maxResults": 500 } ``` Browses across the category's subcategories. **Max results** is the total for the whole category. #### Filter a keyword search by category ```json { "resultType": "products", "keywords": ["led strip"], "category": "Lights & Lighting", "maxResults": 100 } ``` Restricts your search to the chosen category. You can also pick a specific subcategory, e.g. `Lights & Lighting > Outdoor Lighting`. #### Products localized to a destination market ```json { "resultType": "products", "keywords": ["cnc machine", "phone case"], "maxResults": 200, "shipToCountry": "DE", "sortBy": "sales_volume" } ``` Prices, local-stock availability, and delivery estimates localize to the **Deliver to** country. #### Products with reviews and verification reports ```json { "resultType": "products", "keywords": ["solar panel"], "maxResults": 50, "includeReviews": true, "maxReviewsPerProduct": 20, "includeSupplierReport": true } ``` #### Verified manufacturers only ```json { "resultType": "suppliers", "keywords": ["injection molding"], "maxResults": 100, "verifiedManufacturer": true, "supplierCountries": ["CN", "IN"] } ``` ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `keywords` | array | *required* | Search terms; each searched separately. | | `resultType` | string | `products` | `products`, `suppliers`, or `category` (browse a whole category). | | `category` | string | *none* | Filter a product search to an industry category, or browse a whole one (`resultType: category`). Pick a top-level category or a specific subcategory (`Parent > Subcategory`). | | `maxResults` | integer | `100` | Unique results per keyword, or the total across the whole category in category mode (`10000` = unlimited). | | `shipToCountry` | string | `US` | Buyer destination, 40 countries; localizes price and delivery. | | `includeSupplierReport` | boolean | `false` | Add the full SGS verification report for each product's supplier. Billed per report. | | `marketplace` | string | `standard` | `standard` or `worldwide` (Regional supplies). | | `sortBy` | string | `relevance` | `relevance` or `sales_volume`. | | **Price & MOQ** | | | `minPrice`, `maxPrice`, `maxMOQ`, `maxDeliveryDays`. | | **Verification** | boolean | `false` | `verifiedSupplier`, `verifiedManufacturer`, `verifiedProSupplier`, `tradeAssurance`, `guaranteed`. | | **Certifications** | array | `[]` | `companyAuthTags` (ISO, BSCI, AEO), `productCertTags` (CE, ROHS, UL). | | **More filters** | | | `supplierCountries`, `minReviewScore`, `localStock`, `paidSamples`. | | **Store reviews** | boolean | `false` | `includeReviews` (+ `maxReviewsPerProduct`). Billed per review. | The residential proxy is handled automatically; the exit country follows **Deliver to**. ### What Data You Get from Alibaba.com Every **product** result includes: - **Product**: id, title, URL, image gallery, tiered price, MOQ, scores (product, review, shipping, count), certifications, selling points, badges. - **Supplier** (attached): company id, name, logo, country, gold-supplier years, star level, profile and storefront URLs, service score. - **Detail**: ladder pricing tiers, box and customs MOQ, the full SKU attribute matrix, complete spec sheet, media gallery, category path, inventory, trade terms, and a review summary. - **Seller identity**: aliId/member id bridge, business type, join years, Trade Assurance amount, response time, on-time delivery rate, reorder stats, gold-plus/CGS membership, dispatch guarantee. - **Optional reviews**: buyer country, rating, per-product scores, review text, photos, and the supplier's reply. - **Optional verification report**: SGS-style due diligence (registered capital, year established, floor space, employee count, production capacity, quality management, R\&D, and customization capability). Every **supplier** result includes the company profile, factory images, staff and area numbers, verification flags, certifications, performance stats (review score, on-time delivery, reorder rate, online revenue), main products, and a product sample list. #### Output Example A single **products**-mode row, fully enriched (reviews and report included). Large arrays are trimmed with `... more`; every field is shown. ```json { "product": { "productId": "1601386544983", "title": "Good Price 24V 32.8ft Flexible LED Tape Smart RGB 10M Full Kit LED Neon Strip", "url": "https://www.alibaba.com/product-detail/Good-Price-24V_1601386544983.html", "marketplace": "standard", "images": [ "https://s.alicdn.com/@sc04/kf/Ha15c3c42c6774e72ad0d297857aca960u.jpg", "https://s.alicdn.com/@sc04/kf/H2b8e1f0c9a124e7d8f3.jpg" // ... 5 more ], "price": "$0.53-0.63", "moq": "Min. order: 10 meters", "scores": { "product": "4.6", "review": "4.5", "shipping": "4.5", "reviewCount": "19" }, "certifications": [{ "prefixIcons": [{ "name": "RoHS", "url": "https://s.alicdn.com/.../rohs.png" }] }], "badges": [], "sellingPoints": [{ "loopType": "re_order_rate", "text": "26% reorder rate" }], "adFlags": { "isP4P": false, "isShowAd": false, "isNewAd": false }, "tradeProduct": false, "halfTrust": false, "tmlid": "8pctgRBMALNrPrdp7AiuUA==", "trackInfo": "dynamic_tag:pidgroup=pc;testgroup=comp", "eurl": "https://us-click.alibaba.com/ci_bb?ot=local&a=1403902656", "customGroup": "8", "soldOrder": null, "koreaAgeRestricted": false, "lyb": false, "chatToken": "RWRIaHZYd0dEaGQxU2FpNitNWmRq", "contactSupplier": "//message.alibaba.com/msgsend/contact.htm?action=contact_action", "goldSupplierIcon": "https://sc01.alicdn.com/kf/H62868c75e7eb4fbba8f8eb600d749c2aR.png" }, "supplier": { "companyId": "238181772", "name": "Shenzhen Witop Technology Co., Ltd.", "logo": "https://sc02.alicdn.com/kf/H96f60213b26c423b840d3b928e1a3772S.jpg", "country": "CN", "goldSupplierYears": "10 yrs", "starLevel": "2", "profileUrl": "https://witop-led.en.alibaba.com/company_profile.html", "homeUrl": "https://witop-led.en.alibaba.com/", "serviceScore": "4.4", "service": "4.4" }, "detail": { "price": { "batchNum": 1, "currencyRule": { "currencyPattern": "$ {0}", "decimalPoint": ".", "maximumFractionDigits": 2 } }, "ladderPrices": [ { "min": 10, "max": 499, "price": "0.63" }, { "min": 500, "max": 1999, "price": "0.58" }, { "min": 2000, "price": "0.53" } ], "moq": 10, "boxMoq": 1, "customsMoq": 10, "quantityUnit": 8, "skus": { "firstSkuId": 106359893754, "skuAttrs": [ { "id": 210190015, "name": "Color", "values": ["RGB", "RGBW", "Warm White"] }, { "id": 210190016, "name": "Length", "values": ["5m", "10m"] } // ... more ] }, "specs": [ { "attrName": "Application", "attrValue": "Hotel, Home, Commercial" }, { "attrName": "Certification", "attrValue": "CE, RoHS" }, { "attrName": "IP Rating", "attrValue": "IP65" } // ... 47 more ], "media": [{ "bizType": "Product", "group": "photos", "imageUrl": { "big": "https://sc04.alicdn.com/kf/Hc1.jpg" } }], "mediaExtendInfo": { "videoExtraInfo": { "disableAutoPlay": true } }, "categoryPath": [{ "name": "Lights & Lighting" }, { "name": "LED Strip Lights" }], "sample": { "isSupportSample": true, "samplePrice": "1.20" }, "inventory": { "defaultDispatchId": "CN", "infiniteInventoryPlaceOfDispatchId": "CN" }, "trade": { "globalTradeAssuranceForBuyer": true, "hasLogistics": true, "leadTime": "7 days" }, "reviewSummary": { "averageStar": 4.5, "reviewRatingText": "Store rating:", "totalReviewCount": 19 }, "supplierRatingSubScores": { "averageStar": "4.5", "latitudeScoreDTOList": [{ "latitudeType": "Supplier service", "latitudeAverageScore": "4.4" }] }, "seller": { "companyId": 238181772, "aliId": 2933492095, "aliMemberId": 228612101, "ownerMemberSeq": 228612101, "isGoldPlus": true, "isLeader": false, "isPaidMember": true, "hasAssessment": false, "tradeHalfYear": { "ordAmt": "40,000+", "ordAmt6m": 47236.99, "ordCnt6m": 312 }, "name": "Shenzhen Witop Technology Co., Ltd.", "registerCountry": "CN", "businessType": "Manufacturer,Trading Company", "joinYears": "10", "logo": "https://sc04.alicdn.com/kf/H96f60213.jpg", "profileUrl": "https://witop-led.en.alibaba.com/company_profile.html", "homeUrl": "https://witop-led.en.alibaba.com/index.html", "feedbackUrl": "https://witop-led.en.alibaba.com/company_profile/feedback.html", "subDomain": "witop-led.en.alibaba.com", "isCgsMember": true, "isDispatchGuaranteed": true, "businessTypeAuth": true, "portraitImage": { "60x60": "https://sc04.alicdn.com/kf/Hba77.jpg" }, "tradeAssuranceAmount": "108,000", "tradeAssuranceIsDisplayed": true, "tradeAssuranceIsService": true, "responseTime": "≤2h", "onTimeDeliveryRate": "91.7%", "taIcon": "https://sc01.alicdn.com/kf/H84599.png", "tradeHistoryUrl": "https://witop-led.en.alibaba.com/company_profile/trade_history.html", "companyVideoUrl": "https://witop-led.en.alibaba.com/company_profile/video.html", "sellerSelfOperated": false, "localJoinYears": "10 yrs" } }, "report": { "basicInformation": { "mainCompanyNameEn": "Shenzhen Witop Technology Co., Ltd.", "basicCityCountry": "Bao'an, Shenzhen, Guangdong, China", "basicWebAddress": "https://witop-led.en.alibaba.com", "exportSituationNearestPort": "Shenzhen Port", "companyYearEstablished": "2014", "companyRegisteredCapital": "5,000,000", "companyRegisteredCapitalCurrency": "CNY", "totalCompanyBuildingTotalLandSize": "3,000+ square meters", "totalHumanEmployeesCount": "50 - 100 People", "languageCommunication": ["English", "Chinese"], "reportNumber": "484499017_T", "reportAvailableDate": "2026-01-24", "reportExpiredDate": "2027-01-23" }, "providerInfoDto": { "providerName": "SGS" }, "tradeProfile": { "mainMarkets": ["North America", "Western Europe"], "acceptedCurrency": ["USD", "EUR"] }, "productionCapacity": { "productionLines": 5, "annualOutputValue": "US$10 Million - US$50 Million" }, "qualityManagementCapability": { "totalQualityControlInspectorsTotal": 8, "testingMachineryCount": 12 }, "rdCapacity": { "rdEngineersCount": 6 }, "customizationCapability": { "customizationOptions": ["Graphic customization", "Logo customization"] }, "mainCategoryProfileList": [{ "categoryName": "LED Strip Lights", "annualRevenuePercent": "60%" }], "serviceCapability": { "annualSalesRevenue": "US$2.5M", "afterSaleService": "Online support" } }, "reviews": [ { "buyer": { "anonymousName": "A***i", "countryCode": "US", "countryName": "United States" }, "reviewTime": "08 Jun 2026 14:43", "productReview": [ { "score": 5, "reviewContent": "Great quality, fast shipping, exactly as described.", "productName": "24V RGB LED Neon Strip 10M Full Kit", "reviewMediaList": [{ "type": "image", "url": "https://sc04.alicdn.com/kf/Se8410.jpg" }] } ], "supplierSubScores": [ { "latitudeName": "supplierServices", "score": 5 }, { "latitudeName": "shippingTime", "score": 5 } ] } // ... more ], "keyword": "led lights", "mode": "products" } ``` In **suppliers** mode each row is a single `supplier` object with the manufacturer profile, factory images, staff and area numbers, verification flags, certifications, performance stats (review score, on-time delivery, reorder rate, online revenue), main products, and a product sample list. ### Advanced Usage Ready-made configurations for destination-priced sourcing, verified-only supplier discovery, and certification filtering. #### Worldwide marketplace (Regional supplies) ```json { "resultType": "products", "keywords": ["garden furniture"], "marketplace": "worldwide", "shipToCountry": "GB" } ``` #### Certified products under a price ceiling ```json { "resultType": "products", "keywords": ["power adapter"], "maxPrice": 5, "productCertTags": ["CE", "UL"], "tradeAssurance": true } ``` #### High-rated verified suppliers in a category ```json { "resultType": "suppliers", "keywords": ["packaging machine"], "verifiedSupplier": true, "minReviewScore": "4.5", "maxMOQ": 1 } ``` ### Pricing: Pay Per Event (PPE) **$4.99 per 1,000 products** (base price). Volume discounts apply automatically at higher Apify plan tiers. Enrichments are billed only when data is actually returned. | What you scrape | Per result | Per 1,000 | |-----------------|------------|-----------| | Result (a product with its supplier, or a supplier profile) | $0.00499 | $4.99 | | Store review | $0.00149 | $1.49 | | Supplier verification report | $0.00199 | $1.99 | A verification report is charged only when a supplier actually has one; suppliers without a report are never billed for it. Free tier: 10 lifetime runs, 20 results per run. ### FAQ **How many results can I extract?** As many as a keyword returns. Set `maxResults` per keyword, or `10000` for unlimited. Add multiple keywords to scale a run; the limit applies to each one. **How fresh is the data?** Every run fetches live from Alibaba.com at request time. Prices, stock, and delivery estimates reflect the **Deliver to** country you set. **Do I need an Alibaba account or cookies?** No. Provide your keywords and run; no account, login, or cookie export is involved. **What is the difference between Products and Suppliers mode?** Products mode returns listings, each with the manufacturer attached and a full spec/pricing/SKU detail block. Suppliers mode returns manufacturer and factory profiles directly, with performance stats and certifications. Need China-domestic wholesale pricing instead? Use the [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper). **What is in the supplier verification report?** The SGS-style due-diligence record: registered capital, year established, floor space, employee count, export ports, production capacity, quality management, R\&D, and customization capability. It is available in Products mode for suppliers that have one, and billed only when returned. **Can I see who imports from a supplier?** Not from this Actor. For US customs and bill-of-lading shipment records, use the [ImportYeti Scraper](https://apify.com/zen-studio/importyeti-scraper); for North American manufacturer directories, use the [ThomasNet Suppliers Scraper](https://apify.com/zen-studio/thomasnet-suppliers-scraper). **How do I export the data?** Download as JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or pull it via the Apify API. JSON preserves the nested product/supplier/detail structure best; CSV and Excel flatten it. **What is the free tier?** 10 lifetime runs, 20 results per run, no credit card required. Upgrade to a paid plan for full result counts and the review and report enrichments. **Is it legal to scrape Alibaba.com?** The Actor extracts only publicly available data, nothing behind a login. You are responsible for complying with Alibaba.com's terms of service and applicable data protection law, including GDPR, CCPA, and China's PIPL. Supplier and reviewer details are business and personal data; handle them accordingly. ### More Zen Studio scrapers for B2B sourcing **🌏 Wholesale marketplaces** - **1688 阿里巴巴** - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper) **🏭 Supplier & manufacturer directories** - **ThomasNet** - [ThomasNet Suppliers Scraper](https://apify.com/zen-studio/thomasnet-suppliers-scraper) - **GlobalSpec** - [GlobalSpec Suppliers Scraper](https://apify.com/zen-studio/globalspec-suppliers-scraper) - **eSources** - [eSources Wholesale Directory Scraper](https://apify.com/zen-studio/esources-wholesale-directory-scraper) - **Avito** - [Avito Supplier Directory Scraper](https://apify.com/zen-studio/avito-suppliers-directory-scraper) **📦 Import & trade intelligence** - **ImportYeti** - [ImportYeti Scraper](https://apify.com/zen-studio/importyeti-scraper) ### Support - **Bugs**: Issues tab - **Features**: Issues tab ### Legal Compliance Extracts publicly available data only. Users must comply with Alibaba.com terms of service and applicable data protection regulations, including GDPR, CCPA, and China's PIPL. Supplier company details and reviewer names are business and personal data; handle them in line with the law. *** *Scrape Alibaba.com products and verified manufacturers by keyword, with tiered pricing, SKU matrix, specs, certifications, store reviews, and full supplier verification reports.* # Actor input Schema ## `resultType` (type: `string`): Products: product listings with the supplier behind each.
Suppliers: manufacturer/factory profiles.
Category: browse every product in a chosen category (no keyword needed). ## `keywords` (type: `array`): What to search for, e.g. led lights, cnc machine. Each keyword is searched separately; Max results applies per keyword. ## `category` (type: `string`): Pick an industry category. In Products it filters your keyword search to that category; in Category mode it browses the whole category. Leave blank for a plain keyword search. ## `maxResults` (type: `integer`): Maximum unique results. Per keyword for Products/Suppliers search; total across the whole category in Category mode or when a category filter is set. Set 10000 for unlimited. ## `marketplace` (type: `string`): Standard Alibaba.com, or Worldwide (Regional supplies). Products mode only. ## `shipToCountry` (type: `string`): Buyer destination. Prices, local-stock availability, and delivery estimates localize to this country. ## `includeSupplierReport` (type: `boolean`): Add the full SGS-style due-diligence report for the verified manufacturer behind each product: registered capital, year established, floor space, employees, production capacity, and quality management. Billed separately, only when a report exists. Products mode. ## `sortBy` (type: `string`): Order results by best match or by total units sold. ## `minPrice` (type: `integer`): Minimum unit price (in the Deliver-to currency). ## `maxPrice` (type: `integer`): Maximum unit price. ## `maxMOQ` (type: `integer`): Only suppliers whose minimum order quantity is at most this. ## `supplierCountries` (type: `array`): Filter by supplier location. Enter ISO country codes, e.g. CN, IN, DE. Works on Standard and Worldwide. ## `minReviewScore` (type: `string`): Only include suppliers at or above this store rating. ## `verifiedSupplier` (type: `boolean`): Only Verified Suppliers (independently checked). ## `verifiedManufacturer` (type: `boolean`): Only Verified Manufacturers (actual factories). ## `tradeAssurance` (type: `boolean`): Only suppliers offering Trade Assurance order protection. ## `verifiedProSupplier` (type: `boolean`): Only Verified Pro Suppliers (top verification tier). ## `companyAuthTags` (type: `array`): e.g. ISO, BSCI, AEO, IATF 16949. ## `productCertTags` (type: `array`): e.g. CE, ROHS, UL, UKCA. ## `maxDeliveryDays` (type: `integer`): Only products that can ship within this many days. ## `localStock` (type: `boolean`): Only products held in local stock in the Deliver-to country. ## `paidSamples` (type: `boolean`): Only products that offer purchasable samples. ## `guaranteed` (type: `boolean`): Only listings covered by Alibaba Guaranteed. ## `includeReviews` (type: `boolean`): Add the supplier's store reviews to each result: buyer country, rating, review text, photos, and the supplier's reply. Billed separately. ## `maxReviewsPerProduct` (type: `integer`): 0 = all. ## Actor input object example ```json { "resultType": "products", "keywords": [ "led lights" ], "maxResults": 100, "marketplace": "standard", "shipToCountry": "US", "includeSupplierReport": false, "sortBy": "relevance", "supplierCountries": [], "minReviewScore": "any", "verifiedSupplier": false, "verifiedManufacturer": false, "tradeAssurance": false, "verifiedProSupplier": false, "companyAuthTags": [], "productCertTags": [], "localStock": false, "paidSamples": false, "guaranteed": false, "includeReviews": false, "maxReviewsPerProduct": 20 } ``` # Actor output Schema ## `results` (type: `string`): Dataset of scraped products or suppliers. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "led lights" ], "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("zen-studio/alibaba-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["led lights"], "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("zen-studio/alibaba-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "led lights" ], "maxResults": 100 }' | apify call zen-studio/alibaba-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zen-studio/alibaba-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Alibaba Scraper - Products & Verified Suppliers", "description": "Scrape Alibaba products with tiered pricing, MOQ, specs, SKUs, certifications, and the verified manufacturer behind each. Browse a whole category or search by keyword. Add store reviews and full supplier verification reports. Filter by category, country, and price. Export to JSON, CSV, Excel.", "version": "0.0", "x-build-id": "qqV5qwZ1CEaSEyNP7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~alibaba-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-alibaba-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zen-studio~alibaba-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-alibaba-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zen-studio~alibaba-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-alibaba-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "resultType": { "title": "What to scrape", "enum": [ "products", "suppliers", "category" ], "type": "string", "description": "Products: product listings with the supplier behind each.
Suppliers: manufacturer/factory profiles.
Category: browse every product in a chosen category (no keyword needed).", "default": "products" }, "keywords": { "title": "Search keywords 🔍", "type": "array", "description": "What to search for, e.g. led lights, cnc machine. Each keyword is searched separately; Max results applies per keyword.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "Agriculture, Food & Beverage", "Apparel & Accessories", "Automotive Supplies & Tools", "Beauty", "Commercial Equipment & Machinery", "Construction & Building Machinery", "Construction & Real Estate", "Consumer Electronics", "Electrical Equipment & Supplies", "Electronic Components", "Fabrication Services", "Furniture", "Gifts & Crafts", "Health & Medical", "Home & Garden", "Home Appliances", "Industrial Machinery", "Jewelry, Eyewear & Watches", "Lights & Lighting", "Luggage, Bags & Cases", "Material Handling", "Packaging & Printing", "Parents, Kids & Toys", "Personal Care & Home Care", "Pet Supplies", "Power Transmission", "Raw Materials", "Renewable Energy", "Safety & Security", "School & Office Supplies", "Service", "Shoes & Accessories", "Sports & Entertainment", "Sportswear & Outdoor Apparel", "Testing Instrument & Equipment", "Tools & Hardware", "Vehicle Parts & Accessories", "Vehicles & Transportation", "Agriculture, Food & Beverage > Abalone", "Agriculture, Food & Beverage > Absinthe", "Agriculture, Food & Beverage > Baking Powder", "Agriculture, Food & Beverage > Duck", "Agriculture, Food & Beverage > Goose", "Agriculture, Food & Beverage > Hams", "Agriculture, Food & Beverage > Margarine", "Agriculture, Food & Beverage > Natural Plants", "Agriculture, Food & Beverage > Palm Sugar", "Agriculture, Food & Beverage > Rum", "Agriculture, Food & Beverage > Sandwiches", "Agriculture, Food & Beverage > Sauce", "Agriculture, Food & Beverage > Walnuts", "Apparel & Accessories > Belly dance Dress", "Apparel & Accessories > Brand Label", "Apparel & Accessories > Camouflage", "Apparel & Accessories > Church Hats", "Apparel & Accessories > Churidar", "Apparel & Accessories > Cloak", "Apparel & Accessories > Cord Lock", "Apparel & Accessories > Gym Fitness Sets", "Apparel & Accessories > Rhinestones", "Apparel & Accessories > Sports Jersey", "Apparel & Accessories > Top Hat", "Automotive Supplies & Tools > Auto Electronics", "Automotive Supplies & Tools > Car Alarms", "Automotive Supplies & Tools > Car Amplifiers", "Automotive Supplies & Tools > Car Interior Accessories", "Automotive Supplies & Tools > Car Rotisserie", "Automotive Supplies & Tools > Parking System", "Automotive Supplies & Tools > Ramps", "Automotive Supplies & Tools > Roof Rack", "Automotive Supplies & Tools > Throttle Controller", "Automotive Supplies & Tools > Tire Balancer", "Automotive Supplies & Tools > Wheel Cleaner", "Automotive Supplies & Tools > Window Breaker", "Automotive Supplies & Tools > Wiper Blades", "Beauty > Blackhead Remover", "Beauty > Body Shimmer", "Beauty > Cleaning Gel", "Beauty > Cosmetic", "Beauty > Cosmetic Set", "Beauty > Eyebrow Brush", "Beauty > Makeup Sets", "Beauty > Manicure Set", "Beauty > Nail Equipments", "Beauty > Nail Stamper", "Beauty > Nail Supplies", "Beauty > Tattoo Accessories", "Beauty > Tattoo Guns", "Commercial Equipment & Machinery > Cookie Machine", "Commercial Equipment & Machinery > Cooking Machine", "Commercial Equipment & Machinery > Fog Machine", "Commercial Equipment & Machinery > Food Trailer", "Commercial Equipment & Machinery > Gas Station", "Commercial Equipment & Machinery > Glass Engraving Machine", "Commercial Equipment & Machinery > Hotel Supplies", "Commercial Equipment & Machinery > Inflatable Tube", "Commercial Equipment & Machinery > Juice Dispenser", "Commercial Equipment & Machinery > Sheeps", "Commercial Equipment & Machinery > Shopping Baskets", "Commercial Equipment & Machinery > Smoke Extractor", "Construction & Building Machinery > Auger", "Construction & Building Machinery > Cement Making Machinery", "Construction & Building Machinery > Concrete Machine", "Construction & Building Machinery > Excavator Attachment", "Construction & Building Machinery > Garbage Truck", "Construction & Building Machinery > Gold Separator", "Construction & Building Machinery > Lifting Crane", "Construction & Building Machinery > Mining Machinery", "Construction & Building Machinery > Oxygen Generator", "Construction & Building Machinery > Stone Machinery", "Construction & Building Machinery > Torque Converter", "Construction & Building Machinery > Truck Cranes", "Construction & Real Estate > Bamboo Flooring", "Construction & Real Estate > Cabins", "Construction & Real Estate > Cement", "Construction & Real Estate > Forest", "Construction & Real Estate > Garage Door Opener", "Construction & Real Estate > Glass Block", "Construction & Real Estate > HVAC Systems", "Construction & Real Estate > Hotels", "Construction & Real Estate > Mosaics", "Construction & Real Estate > Plasterboards", "Construction & Real Estate > Roof Panel", "Construction & Real Estate > Shower Doors", "Construction & Real Estate > Wall Cabinet", "Construction & Real Estate > Wallpaper", "Consumer Electronics > Bass Amplifier", "Consumer Electronics > Bluetooth Receiver", "Consumer Electronics > Broadcasting Equipment", "Consumer Electronics > Camera Backpack", "Consumer Electronics > Camera Flash Lights", "Consumer Electronics > Electronic accessories", "Consumer Electronics > Home Theater Systems", "Consumer Electronics > Light Stand", "Consumer Electronics > Mounts", "Consumer Electronics > Phone Charm", "Consumer Electronics > Software", "Consumer Electronics > Vga Cable", "Consumer Electronics > Video Cameras", "Consumer Electronics > Web Camera", "Electrical Equipment & Supplies > Alligator Clips", "Electrical Equipment & Supplies > Cable Clips", "Electrical Equipment & Supplies > Dimmer Switch", "Electrical Equipment & Supplies > Enclosure", "Electrical Equipment & Supplies > Generator Controller", "Electrical Equipment & Supplies > Insulation Resistance Tester", "Electrical Equipment & Supplies > Led Connectors", "Electrical Equipment & Supplies > Power Box", "Electrical Equipment & Supplies > Rocker Switches", "Electrical Equipment & Supplies > Timer Switch", "Electrical Equipment & Supplies > Timers", "Electrical Equipment & Supplies > Voltage Tester", "Electronic Components > Antenna", "Electronic Components > Bluetooth Modules", "Electronic Components > Educational Kits", "Electronic Components > Electronic Modules", "Electronic Components > Gps Antenna", "Electronic Components > LEDs", "Electronic Components > Onu", "Electronic Components > Power Supplies", "Electronic Components > Switches", "Electronic Components > Terminal Blocks", "Electronic Components > Thermoelectric Cooler", "Fabrication Services > Casting Services", "Fabrication Services > Concrete Molds", "Fabrication Services > Forging Services", "Fabrication Services > Machining Services", "Fabrication Services > Sheet Metal Fabrication", "Furniture > Baby Cribs", "Furniture > Baby Fence", "Furniture > Baby Swing", "Furniture > Bar Tables", "Furniture > Book Shelf", "Furniture > Cabinet Handle", "Furniture > Egg Chair", "Furniture > Garden Furniture", "Furniture > Massage Table", "Furniture > Tea Table", "Furniture > Wine Racks", "Gifts & Crafts > Coin", "Gifts & Crafts > Fireworks", "Gifts & Crafts > Gift Sets", "Gifts & Crafts > Key Chain", "Gifts & Crafts > Natural stone", "Gifts & Crafts > Paper Lanterns", "Gifts & Crafts > Pendulum", "Gifts & Crafts > Posters", "Gifts & Crafts > Resin Crafts", "Gifts & Crafts > Shell", "Health & Medical > Ambulance Stretcher", "Health & Medical > Butt Plug", "Health & Medical > Ecg Machine", "Health & Medical > Hemodialysis Machine", "Health & Medical > Hemp Seeds", "Health & Medical > Massage Cushion", "Health & Medical > Massage Products", "Health & Medical > Oxygen Concentrator", "Health & Medical > Sm Products", "Health & Medical > Uv Sterilizer", "Health & Medical > Veterinary Medicine", "Health & Medical > Wheelchair", "Home & Garden > Bagel Slicer", "Home & Garden > Bathroom Accessories", "Home & Garden > Bottle Rack", "Home & Garden > Charging Lighter", "Home & Garden > Fence Posts", "Home & Garden > Fodder Trays", "Home & Garden > Garden Windmill", "Home & Garden > Pastry Cutter", "Home & Garden > Room Divider", "Home & Garden > Rotisserie Spit", "Home & Garden > Santa Claus", "Home & Garden > Stamp Album", "Home & Garden > Taper Candles", "Home & Garden > Witch Hat", "Home Appliances > Air Conditioner", "Home Appliances > Crepe Maker", "Home Appliances > Fan Cooler", "Home Appliances > Gas Range", "Home Appliances > Ice Cream Makers", "Home Appliances > Kitchen Appliances", "Home Appliances > Mist Maker", "Home Appliances > Solar Heater", "Home Appliances > Steam Mop", "Home Appliances > Table Fans", "Home Appliances > Tea Maker", "Home Appliances > Vacuum Cleaner Motor", "Home Appliances > Wine Refrigerators", "Industrial Machinery > Agricultural Trailer", "Industrial Machinery > Boom Sprayer", "Industrial Machinery > Crimping Machine", "Industrial Machinery > Crystallizers", "Industrial Machinery > Die Casting Machine", "Industrial Machinery > Electroplating Machinery", "Industrial Machinery > Engine Parts", "Industrial Machinery > English Wheels", "Industrial Machinery > Gasoline Engine", "Industrial Machinery > Honing Machines", "Industrial Machinery > Lathe Spindle", "Industrial Machinery > Socks Making Machine", "Industrial Machinery > Trimming Machine", "Industrial Machinery > Wood Shaving Machines", "Jewelry, Eyewear & Watches > Bracelet Box", "Jewelry, Eyewear & Watches > Clay Beads", "Jewelry, Eyewear & Watches > Contact Lenses", "Jewelry, Eyewear & Watches > Crystal Beads", "Jewelry, Eyewear & Watches > Headpiece", "Jewelry, Eyewear & Watches > Jade", "Jewelry, Eyewear & Watches > Nipple Ring", "Jewelry, Eyewear & Watches > Opal", "Jewelry, Eyewear & Watches > Spacer Beads", "Jewelry, Eyewear & Watches > Stainless Steel", "Lights & Lighting > Disco Light", "Lights & Lighting > Floor Light", "Lights & Lighting > Kerosene Lamp", "Lights & Lighting > Lamp Base", "Lights & Lighting > Led Light", "Lights & Lighting > Light controller", "Lights & Lighting > Music Lights", "Lights & Lighting > Night Lights", "Lights & Lighting > Outdoor Lighting", "Lights & Lighting > Pool Lights", "Lights & Lighting > Smart Bulbs", "Lights & Lighting > Sports Lighting", "Lights & Lighting > Working Light", "Luggage, Bags & Cases > Baby Bag", "Luggage, Bags & Cases > Beer Cooler", "Luggage, Bags & Cases > Cosmetic Bag", "Luggage, Bags & Cases > Kid's Luggage", "Luggage, Bags & Cases > Kids' Shoulder Bags", "Luggage, Bags & Cases > Medical Bags", "Luggage, Bags & Cases > Mommy Bags", "Luggage, Bags & Cases > Passport Wallet", "Luggage, Bags & Cases > Shoulder Bag", "Luggage, Bags & Cases > Sling Bag", "Luggage, Bags & Cases > Suitcase Set", "Material Handling > Conveyors", "Material Handling > Dollies", "Material Handling > Forklifts", "Material Handling > Hoists", "Material Handling > Manipulator", "Material Handling > Roller", "Material Handling > Shelves", "Material Handling > Trolley Cart", "Material Handling > Wheelbarrows", "Material Handling > Winches", "Packaging & Printing > Barrel", "Packaging & Printing > Beer Kegs", "Packaging & Printing > Egg Tray", "Packaging & Printing > Foil Paper", "Packaging & Printing > Jar", "Packaging & Printing > Oxygen Cylinder", "Packaging & Printing > Plastic Cover", "Packaging & Printing > Sublimation Ink", "Packaging & Printing > Wedding Favors", "Parents, Kids & Toys > Animal", "Parents, Kids & Toys > Aspirator", "Parents, Kids & Toys > Baby Souvenirs", "Parents, Kids & Toys > Baby Sweatshirt", "Parents, Kids & Toys > Beach Ball", "Parents, Kids & Toys > Boomerangs", "Parents, Kids & Toys > Bulls", "Parents, Kids & Toys > Corner Protector", "Parents, Kids & Toys > Doll Shoes", "Parents, Kids & Toys > Dollhouse Accessories", "Parents, Kids & Toys > Miscellaneous", "Parents, Kids & Toys > Swimming Pool", "Parents, Kids & Toys > Trading Cards", "Personal Care & Home Care > Curling Cream", "Personal Care & Home Care > Detergent", "Personal Care & Home Care > Dry Shampoo", "Personal Care & Home Care > Hair Perfume", "Personal Care & Home Care > Hair Sprays", "Personal Care & Home Care > Hair Styling Powder", "Personal Care & Home Care > Hand Cream", "Personal Care & Home Care > Laundry Soap", "Personal Care & Home Care > Men's Skin Care Set", "Personal Care & Home Care > Shaving Cream", "Personal Care & Home Care > Steam Cap", "Personal Care & Home Care > Washing Powder", "Personal Care & Home Care > Wood Polish", "Pet Supplies > Aquariums", "Pet Supplies > Cat Carrier", "Pet Supplies > Cat Toy", "Pet Supplies > Dog Car Seat", "Pet Supplies > Dog Food", "Pet Supplies > Dog House", "Pet Supplies > Dog Kennel", "Pet Supplies > Dog Toy", "Pet Supplies > Fish Food", "Pet Supplies > Pet Diaper", "Pet Supplies > Pet Food", "Pet Supplies > Pet Toys", "Power Transmission > Bearing", "Power Transmission > Cages", "Power Transmission > Fan Motor", "Power Transmission > Gearboxes", "Power Transmission > Housings", "Power Transmission > Hydraulic Fittings", "Power Transmission > Hydraulic Motors", "Power Transmission > Joint", "Power Transmission > Motor", "Power Transmission > Stepper Motors", "Power Transmission > Vibration Motors", "Raw Materials > 100% Linen Fabric", "Raw Materials > Camphor", "Raw Materials > Fabric", "Raw Materials > Gasoline", "Raw Materials > Hose", "Raw Materials > Metal Scrap", "Raw Materials > Nickel", "Raw Materials > PET", "Raw Materials > Polyester Fiber", "Raw Materials > Potassium Nitrate", "Raw Materials > Propylene Glycol", "Raw Materials > Sodium Hydroxide", "Raw Materials > Wire Rope", "Raw Materials > Wood Chips", "Renewable Energy > Energy Storage Battery", "Renewable Energy > Hydro Generator", "Renewable Energy > Hydrogen Fuel Cell", "Renewable Energy > Solar Cells", "Renewable Energy > Solar Generator", "Renewable Energy > Solar Kits", "Renewable Energy > Solar Light", "Renewable Energy > Solar Panels", "Renewable Energy > Solar Pump", "Renewable Energy > Solar Tracker", "Renewable Energy > Wind Power Generation System", "Renewable Energy > Wind Turbine", "Safety & Security > Barrier Gate", "Safety & Security > Boots", "Safety & Security > Emergency Kits", "Safety & Security > Face Shields", "Safety & Security > Fire Hose", "Safety & Security > Locksmith Tools", "Safety & Security > Military Supplies", "Safety & Security > Road Sign", "Safety & Security > Self Defense Supplies", "Safety & Security > Spy Camera", "Safety & Security > Surveillance Systems", "Safety & Security > Video Intercom", "School & Office Supplies > Art Supplies", "School & Office Supplies > Binder Clips", "School & Office Supplies > Calligraphy Brushes", "School & Office Supplies > Cutting Plotter", "School & Office Supplies > Fabric Paint", "School & Office Supplies > Glue Sticks", "School & Office Supplies > Money Envelope", "School & Office Supplies > Oil Pastel", "School & Office Supplies > Paint Palette", "School & Office Supplies > Paper Punch", "School & Office Supplies > Shredder", "School & Office Supplies > Tape Dispensers", "School & Office Supplies > Water Color", "Service > 3D Game Art", "Service > AI Chatbot", "Service > Book Design", "Service > Brand Style Design", "Service > Fashion Design", "Service > Flyer Design", "Service > Household items", "Service > Other Goods", "Service > Other Regions", "Service > PC Games", "Service > Quality Control", "Service > Supplier Search", "Service > Wix", "Shoes & Accessories > Athletic Shoes", "Shoes & Accessories > Bedroom Slippers", "Shoes & Accessories > Cowboy Boots", "Shoes & Accessories > Fur Slides", "Shoes & Accessories > Ladies Loafers", "Shoes & Accessories > Shoe Accessories", "Shoes & Accessories > Shoe Care Kits", "Shoes & Accessories > Shoelaces", "Shoes & Accessories > Soles", "Shoes & Accessories > Sport Sandals", "Shoes & Accessories > Waterproof Boots", "Sports & Entertainment > Climbing Rope", "Sports & Entertainment > Crossbow", "Sports & Entertainment > Fighting", "Sports & Entertainment > Fishing Gear", "Sports & Entertainment > Flying Car", "Sports & Entertainment > Horseshoes", "Sports & Entertainment > Kayak", "Sports & Entertainment > Novelties", "Sports & Entertainment > Paddle Boat", "Sports & Entertainment > Pom Poms", "Sports & Entertainment > Rescue Boat", "Sports & Entertainment > Scooter Accessories", "Sports & Entertainment > Speed Skates", "Sports & Entertainment > Surfboard Fins", "Sportswear & Outdoor Apparel > Arm Sleeve", "Sportswear & Outdoor Apparel > Cricket Shoes", "Sportswear & Outdoor Apparel > Cycling Shoes", "Sportswear & Outdoor Apparel > Diving Bags", "Sportswear & Outdoor Apparel > Football Boots", "Sportswear & Outdoor Apparel > Golf Shoes", "Sportswear & Outdoor Apparel > Hockey Bag", "Sportswear & Outdoor Apparel > Jockstrap", "Sportswear & Outdoor Apparel > Leg Massager", "Sportswear & Outdoor Apparel > Muay Thai Shorts", "Sportswear & Outdoor Apparel > Souvenirs", "Sportswear & Outdoor Apparel > Spike Shoes", "Sportswear & Outdoor Apparel > Volleyball Shoes", "Testing Instrument & Equipment > Flasks", "Testing Instrument & Equipment > Funnels", "Testing Instrument & Equipment > Gas Analyzers", "Testing Instrument & Equipment > Gas Regulator", "Testing Instrument & Equipment > Lab Equipment", "Testing Instrument & Equipment > Optics Instruments", "Testing Instrument & Equipment > Pocket Scale", "Testing Instrument & Equipment > Test Tubes", "Testing Instrument & Equipment > Thermal Camera", "Testing Instrument & Equipment > Water Test Kit", "Tools & Hardware > Ammo Box", "Tools & Hardware > Drill Set", "Tools & Hardware > Garden Forks", "Tools & Hardware > Hand Tools", "Tools & Hardware > Pickaxe", "Tools & Hardware > Rake", "Tools & Hardware > Refrigeration Tool", "Tools & Hardware > Sand Pump", "Tools & Hardware > Shelf Bracket", "Tools & Hardware > Studs", "Tools & Hardware > Swivels", "Tools & Hardware > Thimbles", "Tools & Hardware > Valve Seal", "Tools & Hardware > Welding Accessories", "Vehicle Parts & Accessories > Atv Accessories", "Vehicle Parts & Accessories > Auto Parts", "Vehicle Parts & Accessories > Boat Accessories", "Vehicle Parts & Accessories > Bus Accessories", "Vehicle Parts & Accessories > Bus Lights", "Vehicle Parts & Accessories > Lighting Accessories", "Vehicle Parts & Accessories > Motor Boat", "Vehicle Parts & Accessories > Radiator Tank", "Vehicle Parts & Accessories > Scooter Engines", "Vehicle Parts & Accessories > Tuning Lightings", "Vehicles & Transportation > ATVs", "Vehicles & Transportation > Boat Trailers", "Vehicles & Transportation > Car Trailers", "Vehicles & Transportation > Motorcycle", "Vehicles & Transportation > Pit Bike", "Vehicles & Transportation > Racing Motorcycles", "Vehicles & Transportation > Sport Car", "Vehicles & Transportation > Trailers", "Vehicles & Transportation > UTVs", "Vehicles & Transportation > Used Motorcycles" ], "type": "string", "description": "Pick an industry category. In Products it filters your keyword search to that category; in Category mode it browses the whole category. Leave blank for a plain keyword search." }, "maxResults": { "title": "Max results (10000 = unlimited)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum unique results. Per keyword for Products/Suppliers search; total across the whole category in Category mode or when a category filter is set. Set 10000 for unlimited.", "default": 100 }, "marketplace": { "title": "Marketplace", "enum": [ "standard", "worldwide" ], "type": "string", "description": "Standard Alibaba.com, or Worldwide (Regional supplies). Products mode only.", "default": "standard" }, "shipToCountry": { "title": "Deliver to", "enum": [ "US", "CN", "DE", "GB", "FR", "IT", "ES", "NL", "BE", "SE", "PL", "CH", "AT", "IE", "DK", "NO", "FI", "PT", "GR", "CZ", "IN", "JP", "KR", "HK", "SG", "MY", "TH", "VN", "ID", "PH", "AE", "SA", "TR", "IL", "CA", "MX", "BR", "AU", "NZ", "ZA" ], "type": "string", "description": "Buyer destination. Prices, local-stock availability, and delivery estimates localize to this country.", "default": "US" }, "includeSupplierReport": { "title": "Include supplier verification report", "type": "boolean", "description": "Add the full SGS-style due-diligence report for the verified manufacturer behind each product: registered capital, year established, floor space, employees, production capacity, and quality management. Billed separately, only when a report exists. Products mode.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "sales_volume" ], "type": "string", "description": "Order results by best match or by total units sold.", "default": "relevance" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum unit price (in the Deliver-to currency)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum unit price." }, "maxMOQ": { "title": "Max MOQ", "minimum": 1, "type": "integer", "description": "Only suppliers whose minimum order quantity is at most this." }, "supplierCountries": { "title": "Supplier countries", "type": "array", "description": "Filter by supplier location. Enter ISO country codes, e.g. CN, IN, DE. Works on Standard and Worldwide.", "default": [], "items": { "type": "string" } }, "minReviewScore": { "title": "Min review score", "enum": [ "any", "4", "4.5", "5" ], "type": "string", "description": "Only include suppliers at or above this store rating.", "default": "any" }, "verifiedSupplier": { "title": "Verified Supplier only", "type": "boolean", "description": "Only Verified Suppliers (independently checked).", "default": false }, "verifiedManufacturer": { "title": "Verified Manufacturer only", "type": "boolean", "description": "Only Verified Manufacturers (actual factories).", "default": false }, "tradeAssurance": { "title": "Trade Assurance only", "type": "boolean", "description": "Only suppliers offering Trade Assurance order protection.", "default": false }, "verifiedProSupplier": { "title": "Verified Pro Supplier only", "type": "boolean", "description": "Only Verified Pro Suppliers (top verification tier).", "default": false }, "companyAuthTags": { "title": "Company certifications", "type": "array", "description": "e.g. ISO, BSCI, AEO, IATF 16949.", "default": [], "items": { "type": "string" } }, "productCertTags": { "title": "Product certifications", "type": "array", "description": "e.g. CE, ROHS, UL, UKCA.", "default": [], "items": { "type": "string" } }, "maxDeliveryDays": { "title": "Max delivery days", "minimum": 1, "type": "integer", "description": "Only products that can ship within this many days." }, "localStock": { "title": "Local stock only", "type": "boolean", "description": "Only products held in local stock in the Deliver-to country.", "default": false }, "paidSamples": { "title": "Samples available", "type": "boolean", "description": "Only products that offer purchasable samples.", "default": false }, "guaranteed": { "title": "Guaranteed only", "type": "boolean", "description": "Only listings covered by Alibaba Guaranteed.", "default": false }, "includeReviews": { "title": "Include store reviews", "type": "boolean", "description": "Add the supplier's store reviews to each result: buyer country, rating, review text, photos, and the supplier's reply. Billed separately.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per result", "minimum": 0, "type": "integer", "description": "0 = all.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```