# 1688 Scraper & API: Wholesale & Price Monitor 🇨🇳 (`unitbytes/1688-scraper`) Actor ⚡ Fast & Cheap ($0.90/1k): Monitor & scrape 1688 factory prices, MOQ, stock, SKU variants, FBA specs & manufacturers. Zero login, MCP & AI Agent ready. - **URL**: https://apify.com/unitbytes/1688-scraper.md - **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community) - **Categories:** E-commerce, Lead generation, AI - **Features:** Limited permissions, Multi-tenant, Server interface - **Stats:** 73 total users, 30 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.90 / 1,000 search product listings 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 ## 🇨🇳 1688 Scraper & Price Monitor: Factory Wholesale, Product API & Sourcing (阿里巴巴批发网)

[![Available on Apify](https://img.shields.io/badge/Available_on-Apify-28B52A?style=for-the-badge\&logo=apify\&logoColor=white)](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=gh_1688) [![Speed](https://img.shields.io/badge/Speed-Results_in_Seconds-brightgreen?style=for-the-badge)](#) [![Price Monitor](https://img.shields.io/badge/24%2F7_Cron-Price_%26_Stock_Monitor-critical?style=for-the-badge)](#) [![Pricing](https://img.shields.io/badge/Price-From_$0.0015%2Fitem-orange?style=for-the-badge)](#) [![HD Images](https://img.shields.io/badge/HD_Images-100%25_Working-blue?style=for-the-badge)](#) [![Amazon FBA](https://img.shields.io/badge/Amazon_FBA-Weights_%26_Dimensions-purple?style=for-the-badge)](#) [![Zero Login](https://img.shields.io/badge/Account_Required-None-blue?style=for-the-badge)](#) **The fastest and most affordable 1688.com scraper & automated price monitor for Amazon FBA merchants, Shopify dropshippers, B2B procurement agencies, and private label brands. Extract direct factory bulk prices in seconds OR run automated daily schedules to track factory price hikes, out-of-stock SKUs, MOQ changes, Amazon FBA packaging specs, and 100% working HD images — with Zero Login & Zero Chinese Phone Number Required.** [**🚀 Try it Live on Apify**](https://console.apify.com/actors/M5S1OECxbMeNY8AzG/input) • [**📸 1688 Reverse Image Search (Photo-to-Factory)**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=gh_1688) • [**⏰ Set Up Daily Price Alert**](https://console.apify.com/actors/M5S1OECxbMeNY8AzG/input) • [**💬 Support**](https://apify.com/unitbytes/1688-scraper/issues)

***

_{⚡ 1-Click Free Trial: Test live queries using Apify's $5 free monthly credit • No credit card required}

*** ### 📖 Overview **1688.com (阿里巴巴批发网)** is Alibaba Group's premier domestic B2B marketplace. It is the real, direct manufacturing engine behind Alibaba.com, AliExpress, Temu, Shein, Taobao, and Amazon FBA — hosting over **10 million Chinese factories, raw manufacturers, and industrial suppliers**. However, extracting data from 1688 has historically been a massive headache for Western brands and sourcing teams: - Mandatory Chinese mobile number (+86) SMS verification and QR code login walls. - Broken product images (HTTP 403 Forbidden errors) when importing image links into Shopify, Excel, or Airtable. - Middleman trading companies marking up factory prices by 20–40% instead of real manufacturers. - Missing packaging weights and dimensions needed to calculate Amazon FBA fulfillment and international freight costs. - Slow scraping tools that take minutes to return results or charge exorbitant monthly subscription fees. **1688 Scraper by UnitBytes** completely solves these procurement roadblocks. It delivers results **in seconds** (streaming up to 27 items/sec) at **the lowest price on Apify (from $0.0015/item)** — delivering clean, spreadsheet-ready factory data with 100% working HD images into Excel, CSV, or Google Sheets with zero account or cookie setup needed. > 📸 **Want to search 1688 by product photo instead of keywords (`以图搜款 / 拍立淘`)?** > Have an Amazon, Shopify, AliExpress, or competitor product image and need to find the original Chinese factory? Use our dedicated [**1688 Reverse Image Search (Photo-to-Factory) Scraper**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem) — supports direct image file uploads, batch image URLs, Base64 photos, and a real-time `/v1/image-search` API!

⚡ UnitBytes · B2B Sourcing, E-Commerce Demand & Global Lead Intelligence Ecosystem
🇨🇳 1688 Factory Direct 📍 You are here Direct factory prices, SKU matrices & Amazon FBA specs	🌍 1688 Global & Arbitrage ✨ English Search & Margins English search, CE/FCC/RoHS filters, Amazon/TikTok margins & 15 currencies	📸 1688 Reverse Image Search ✨ Photo-to-Factory (以图搜款) Upload any product photo or URL to find the exact 1688 factory
🌐 Alibaba Wholesale Global B2B & MOQ Verified suppliers, inspection audits & tiered pricing	🛍️ Taobao & Tmall Products Retail, Reviews & 3-Axis DSR Consumer trends, buyer sentiment tags & flagship stores	🏪 Taobao & Tmall Seller Shops Storefront Catalogs (淘宝店铺) Full shop inventories, new arrivals & seller DSR audits
🐟 Goofish Search & Deals C2C Resale & Arbitrage Zero-login 闲鱼 search, price drops & liquidation	⭐ Goofish Sellers & Reviews Zhima Credit & Store Audits Active/sold seller catalogs & buyer unboxing photos	📈 Google Shopping Trends 🔥 Breakout Product Demand Rising e-commerce products, seasonal buying curves & regions
📊 Google Trends All-in-One 5-Surface Search Intelligence Web, YouTube, Shopping & News search breakouts from $0.30/1K	📍 Google Maps Email & Leads B2B Contacts & Tech Stack Verified business emails, phone numbers, social links & pixels	💬 Google Maps Reviews (10K) Customer Sentiment & ORM Up to 10,000 reviews per place by newest, rating or keyword
🖼️ Google Maps Photos & Menus 4K Place, Menu & Video Feeds Original =s0 photos, restaurant menus, MP4 videos & Local Guides	🇰🇷 Naver Place & Naver Map Korean B2B Leads & Menus South Korean local businesses, KRW menus, hours & reviews	⭐ Naver Place Reviews (네이버) Korean Receipt & Blog Reviews Receipt-verified visitor reviews, photo filters & Naver Blog links

*** ### ✨ Key Features - **⚡ Lightning-Fast Results in Seconds:** Stream up to 27 wholesale products per second. Extract thousands of listings in seconds instead of waiting minutes. - **💰 Lowest Price on Apify (From $0.0015 / item):** Pay only for what you extract—scrape 1,000 products for as little as $1.50 (save up to 70% compared to competitors). - **🖼️ 100% Working HD Images (Zero Broken 403 Links):** Image URLs are automatically delivered through reliable public image CDNs, guaranteeing they open and display properly in Excel, Google Sheets, Shopify, WooCommerce, and Airtable. - **📦 Amazon FBA Packaging Intelligence (Grams & Dimensions per SKU):** Physical package weights in grams (`weightGrams`) and dimensions (`lengthCm`, `widthCm`, `heightCm`, `volumeCm3`) per individual SKU variant to accurately calculate international shipping freight and Amazon FBA fulfillment fees. - **🏭 4 Specialized Wholesale Sourcing Channels (Skip Middlemen):** - `找工厂` (Direct Factory / OEM & ODM) — filters out middlemen, trading companies, and agents. - `超级工厂` (Super Factory) — restricted to Alibaba's elite certified mega-plants. - `跨境专供` (Cross-Border Export) — tailored for Amazon FBA, Temu, and TikTok Shop sellers with export certifications. - `现货批发` (Ready-to-Ship Spot Market) — in-stock items ready to ship in 24–48 hours. - **💰 Tiered Bulk Pricing Brackets:** Captures the full volume price schedule (e.g. 2–99 pcs, 100–499 pcs, 500+ pcs) for accurate cost modeling and supplier negotiation. - **🎨 Complete SKU Matrix with Spec Photos:** Collects every variation (color, size, packaging) along with variant-specific pricing, real-time stock levels, and matching high-res product photos. - **🛡️ Free Factory Due Diligence Badges:** Verify manufacturing capability instantly with **Super Factory (超级工厂)** flags, **SGS / BV third-party on-site audits (深度验厂)**, and repeat customer **Repurchase Rates (回头率)** without paid add-ons. - **🔄 Stateful Resumption Engine:** Checkpoints pagination state so you can resume multi-page scrapes seamlessly with **0 duplicate products across runs**. *** ### 💡 Practical Business Use Cases #### 1. 📦 Amazon FBA Private Label Sourcing Calculate landed product costs accurately before placing production orders. Combine extracted physical SKU package weights (grams) and dimensions with bulk volume tier prices to model international air/sea freight and Amazon FBA fulfillment size tiers. #### 2. 🛍️ Shopify, TikTok Shop & Dropshipping Product Discovery Uncover trending viral products before they reach Western marketplaces. Sort by total sales volume (`salesVolume` / Booked Orders) and enrich your product catalogs with high-res photo galleries, SKU matrices, and product demo videos. #### 3. 🏭 Direct Factory Procurement & Supply Chain Auditing Cut out export trading companies, domestic commission agents, and unnecessary markups. Filter strictly for verified **Super Factories (超级工厂)** and facilities with verified third-party on-site factory audits (**深度验厂**). #### 4. 📈 Competitor Price Benchmarking & Wholesale Arbitrage Benchmark real manufacturing costs in China against retail prices on Amazon, eBay, Mercari, and Walmart. Gain immediate leverage during price negotiations by showing suppliers their competitors' domestic 1688 wholesale prices. #### 5. 🏪 Yiwu Market Small Commodities Sourcing Directly target Zhejiang and Yiwu wholesale markets to source novelties, home organizers, stationery, and small accessories at fraction-of-a-cent factory rates. *** ### 🚨 1688 Price & Inventory Stock Monitor (The Amazon Seller & Dropshipper Life-Saver) Thousands of Amazon FBA merchants, Shopify store owners, and private label dropshippers source their core catalog directly from 1688.com. #### 😱 The Three Sourcing Nightmares This Solves: 1. **The Stealth Factory Price Hike:** The manufacturer suddenly increases the unit price from ¥15 to ¥25 without warning, instantly turning your winning Amazon listing into an unprofitable money pit. 2. **The Out-of-Stock Account Disaster:** The factory runs out of stock (`totalStock = 0`), but your Amazon or Shopify store keeps taking orders. Result: late shipment penalties, negative seller ratings, or Amazon account suspension. 3. **Discontinued SKU Variants:** A critical SKU variant (e.g. *Size L, Matte Black*) gets deleted or discontinued by the factory while your ads are actively running. Turn manual product searching into an **automated 24/7 price & stock watchdog** running on a background schedule. *** #### ⏰ Ready-to-Use Scheduled Automation Templates | Sourcing Objective | Frequency / Cron | Target Input | Automated Action / Destination | | :--- | :--- | :--- | :--- | | **🚨 Daily Price & Stock Watchdog** | Daily at 08:00 AM UTC
`0 8 * * *` | List of your active 1688 Offer IDs in `offerIds` (e.g. `["1060147507143", "1014641504196"]`) | Auto-appends fresh prices, MOQ, and variant stock to **Google Sheets**. Highlight price hikes in red. | | **⚡ 4-Hour High-Velocity Stock Sync** | Every 4 hours
`0 */4 * * *` | High-volume ASIN 1688 URLs in `startUrls` (`detailLevel: "full"`) | Sends a **Webhook** to Slack / Discord / Zapier / Make immediately if `totalStock == 0` or variant stock is low. | | **🏭 Weekly New Factory & Deal Radar** | Every Monday at 06:00 AM UTC
`0 6 * * 1` | `queries: ["phone case"]`, `sortBy: "booked"`, `verticalProductFlag: "superFactory"` | Delivers newly trending factory listings directly to your procurement team's inbox or Airtable. | *** #### 🚀 How to Set Up an Automated Daily Schedule in 3 Clicks (No Coding Required) 1. **Step 1: Save Your Monitor Input as a Task** - Open [1688 Scraper on Apify Console](https://console.apify.com/actors/M5S1OECxbMeNY8AzG/input). - Enter your target 1688 Offer IDs or Product URLs (e.g. in `offerIds` or `startUrls`), set `detailLevel: "full"`, then click **Save as task** (top right). 2. **Step 2: Add a Schedule** - In the left sidebar of the Apify Console, go to **Schedules** ➔ click **Create schedule**. - Select your saved 1688 Task and pick your schedule (e.g., select **Daily at 8:00 AM** or enter `0 8 * * *`). 3. **Step 3: Connect to Google Sheets or Webhook Alert** - In your Task settings, navigate to the **Integrations** tab: - **Google Sheets:** Select *Google Sheets* to automatically append updated prices, stock, and MOQ daily. - **Slack / Discord / Make / Zapier:** Select *Webhook* to trigger an instant alert whenever price changes or stock drops! *** ### 🔗 No-Code Integrations: Google Sheets, Make, Zapier & Webhooks Connect 1688 direct factory data directly into your business stack without writing a single line of code: | Destination | Integration Method | Use Case | | :--- | :--- | :--- | | **Google Sheets** | Apify Google Sheets Actor / Integration | Auto-sync factory price lists, SKU breakdowns, and supplier contacts directly to collaborative spreadsheets. | | **Make.com / Zapier** | Apify Webhooks (`RUN.SUCCEEDED`) | Trigger Slack/Discord notifications on price drops, or create draft items in Shopify / Airtable. | | **Airtable** | Apify Airtable Integration | Build a rich visual sourcing base with high-res product galleries, MOQ tiers, and factory audit certificates. | | **Custom Webhook / ERP** | HTTP POST Payload | Ingest structured JSON directly into your proprietary ERP, Amazon inventory planner, or private sourcing dashboard. | *** ### ⚡ Real-Time REST API (Server Interface) Need sub-2-second responses for live sourcing tools, AI agents, ERP integrations, or real-time dropshipping checkout checks? This Actor runs in **Apify Standby (Server Actor) Mode**, providing a persistent HTTP REST API with zero cold-start overhead on warm requests and automatic Pay-Per-Event billing. **Base URL:** `https://unitbytes--1688-scraper.apify.actor` **Authentication:** Pass `Authorization: Bearer ` header or `?token=` query parameter. | Endpoint | Description | Key Query Parameters | PPE Event Charged | | :--- | :--- | :--- | :--- | | **`GET /v1/search`** | Real-time 1688 wholesale & factory search | `keyword` (required), `page_size` (1–30), `detail_level` (`summary` | `full`), `sort_by` (`normal`, `booked`, `priceAsc`, `priceDesc`, `newest`), `price_min`, `price_max`, `province` (`广东`, `浙江`), `channel` (`factory`, `superFactory`, `kuajing`, `spot`, `all`) | `search-item` ($0.0015) or `detail-item` ($0.0025 when `detail_level=full`) | | **`GET /v1/offer`** | Real-time B2B offer detail, tiered prices, SKU matrix & Amazon FBA packaging specs | `offer_id` (or `url`), `detail_level` (`full` | `summary`) *(aliases: `/v1/item`, `/v1/product`)* | `detail-item` ($0.0025) or `search-item` ($0.0015 when `detail_level=summary`) | | **`GET /v1/offers/batch`** | Real-time concurrent batch price & SKU stock check (up to 10 offers) | `offer_ids` (comma-separated offer IDs or JSON array in POST body) | `detail-item` ($0.0025 per available offer) | | **`GET /health`** | Service health & endpoint discovery | None | **Free** ($0.00) | #### Quickstart Examples (cURL) ```bash ## 1. Real-Time Wholesale Factory Search (Summary Mode) curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \ "https://unitbytes--1688-scraper.apify.actor/v1/search?keyword=%E8%93%9D%E7%89%99%E8%80%B3%E6%9C%BA&page_size=5&sort_by=booked&channel=factory" ## 2. Real-Time Full B2B Offer Detail (Tiered Prices, MOQ, SKU Matrix & Amazon FBA Weights) curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \ "https://unitbytes--1688-scraper.apify.actor/v1/offer?offer_id=685176373959&detail_level=full" ## 3. Real-Time Batch Offer Price & Stock Check (Up to 10 Offers in Parallel) curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \ "https://unitbytes--1688-scraper.apify.actor/v1/offers/batch?offer_ids=685176373959,742819304112" ``` *** ### 🛠️ How to Use via API (Batch Runs) You can trigger runs directly in the [Apify Console](https://console.apify.com/actors/M5S1OECxbMeNY8AzG/input) or integrate programmatically into your Python, Node.js, or cURL pipeline. #### 🐍 Python Example ```bash pip install apify-client ``` ```python from apify_client import ApifyClient ## Initialize the client with your Apify API token client = ApifyClient("YOUR_APIFY_TOKEN") ## Configure search parameters run_input = { "queries": ["phone case"], "detailLevel": "summary", "maxItems": 50, "sortBy": "booked", "province": "广东", "priceMin": 5, "priceMax": 50, "verticalProductFlag": "factory", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"] } } ## Run the Actor and wait for completion print("🚀 Launching 1688 Factory Scraper...") run = client.actor("unitbytes/1688-scraper").call(run_input=run_input) ## Fetch scraped wholesale products from the dataset dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items print(f"✅ Successfully extracted {len(dataset_items)} wholesale products from 1688!") for item in dataset_items[:3]: print(f"\nTitle: {item.get('title')}") print(f"Base Price: ¥{item.get('price')} CNY") print(f"Price Range: {item.get('priceDisplay')}") print(f"MOQ: {item.get('minOrderQuantity')} units") print(f"Super Factory: {item.get('superFactory')}") print(f"Repurchase Rate: {item.get('repurchaseRate')}") print(f"Supplier: {item.get('supplier', {}).get('name')}") print(f"URL: {item.get('url')}") ``` *** #### 🟨 JavaScript / Node.js Example ```bash npm install apify-client ``` ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN', }); const runInput = { queries: ['hoodie'], detailLevel: 'summary', maxItems: 100, sortBy: 'priceAsc', priceMin: 20, priceMax: 60, province: '浙江', proxyConfiguration: { useApifyProxy: true, apifyProxyGroups: ['RESIDENTIAL'], }, }; console.log('🚀 Starting 1688 Scraper...'); const run = await client.actor("unitbytes/1688-scraper").call(runInput); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`✅ Extracted ${items.length} products from 1688!`); console.log(items.slice(0, 2)); ``` *** #### 🌐 cURL Example ```bash curl -X POST "https://api.apify.com/v2/acts/unitbytes~1688-scraper/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "queries": ["wireless earbuds"], "detailLevel": "summary", "maxItems": 30, "sortBy": "booked", "verticalProductFlag": "factory" }' ``` *** ### 📤 Sample Output Data Here is an example of an enriched B2B wholesale product record extracted in **Full Detail** mode: ```json { "id": "685176373959", "offerId": "685176373959", "url": "https://detail.1688.com/offer/685176373959.html", "title": "适用苹果x手机壳iPhoneX保护套iponex新款ipx液态硅胶ix外壳纯色", "page": 1, "position": 1, "nextPage": 2, "price": 1.8, "currency": "CNY", "priceDisplay": "1.40 - 1.80", "minOrderQuantity": 1, "totalStock": 43557, "salesVolume": "已售10万+件", "repurchaseRate": "38.5%", "superFactory": true, "factoryInspection": true, "tieredPrices": [ { "minQuantity": 1, "maxQuantity": 499, "price": 1.8, "unit": "件" }, { "minQuantity": 500, "maxQuantity": 999, "price": 1.6, "unit": "件" }, { "minQuantity": 1000, "maxQuantity": null, "price": 1.4, "unit": "件" } ], "pictureUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example_product_01.jpg", "images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01example_product_01.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN01example_product_02.jpg" ], "skuMatrix": [ { "skuId": "5066775858930", "specId": "5405c1ade1d9d2e9ba0c2ad101623132", "variant": "苹果X-XS【草紫色】", "price": 1.8, "stock": 4967, "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example_sku_01.jpg" }, { "skuId": "4893701804460", "specId": "2b4174c3e987a9eca9a9c741f3c495ad", "variant": "苹果X-XS【石墨黑】", "price": 1.8, "stock": 4389, "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example_sku_02.jpg" } ], "packaging": [ { "skuId": "4893701804460", "variant": "苹果X-XS【石墨黑】", "weightGrams": 30.0, "lengthCm": 15.0, "widthCm": 8.0, "heightCm": 1.2, "volumeCm3": 144.0 } ], "shipping": { "dispatchLocation": "广东省汕头市", "deliveryPromise": "承诺48小时发货", "dispatchTime": "预计2小时发货", "isFreeShipping": true }, "supplier": { "companyName": "东莞市示例电子配件制造厂", "name": "东莞市示例电子配件制造厂", "city": "东莞市", "province": "广东省", "trustPass": true, "shopUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-220000000000000001" }, "detailLevel": "full" } ``` *** ### ⚡ Real-Time REST API (Server Actor / Standby Mode) In addition to batch runs, **1688 Scraper** runs as an always-warm **Multi-Tenant REST API** (`https://unitbytes--1688-scraper.apify.actor`) returning live 1688 factory search results and full B2B offer details in **< 1 second** with zero cold-start delay. | Endpoint | Method | Key Parameters | Pricing | | :--- | :---: | :--- | :--- | | **`/v1/search`** | `GET`, `POST` | `keyword` (or `q` / `url`), `page`, `page_size` (`1–30`), `detail_level` (`summary` | `full`), `sort_by` (`normal`, `booked`, `repurchase`, `priceAsc`, `priceDesc`, `newest`), `price_min`, `price_max`, `province`, `channel`, `super_factory`, `factory_inspection` | `$0.0015` (`summary`) or `$0.0025` (`full`) per item | | **`/v1/offer`** | `GET`, `POST` | `offer_id` (or `url`), `detail_level` (`full` | `summary`) | `$0.0025` (`full`) or `$0.0015` (`summary`) | | **`/v1/offers/batch`** | `GET`, `POST` | `offer_ids` (comma-separated or JSON array, max `10` offers) | `$0.0025` per available offer | | **`/health`** | `GET` | Health & readiness check | **Free** | ```bash ## Search 1688 wholesale offers sorted by sales volume (booked) curl "https://unitbytes--1688-scraper.apify.actor/v1/search?keyword=蓝牙耳机&page_size=5&sort_by=booked&token=YOUR_APIFY_TOKEN" ## Fetch full B2B wholesale offer details, tiered prices, SKU matrix & Amazon FBA packaging specs curl "https://unitbytes--1688-scraper.apify.actor/v1/offer?offer_id=685176373959&token=YOUR_APIFY_TOKEN" ``` *** ### ⚙️ Input Parameters Reference | Parameter | Type | Default | Description | | :--- | :--- | :--- | :--- | | `queries` | `array` | `["phone case"]` | List of product search queries in English or Chinese (e.g. `["phone case", "smart watch"]`). Batch extracted in a single run. | | `keyword` | `string` | — | Single product search query (legacy fallback) or direct 1688 numeric offer ID. (e.g. `phone case`, `hoodie`, `wireless earbuds`, `瑜伽裤`). You can also paste direct 1688 URLs! | | `startUrls` | `array` | `[]` | Direct 1688 product offer URLs (`detail.1688.com/offer/...`), numeric offer IDs, or search result URLs. | | `detailLevel` | `string` | `"full"` | `"full"` (tiered pricing, SKU matrix, packaging weights, and factory audit badges) or `"summary"` (fast search scan). | | `maxItems` | `integer` | `100` | Maximum number of products to collect (supports large jobs up to 10,000 items). | | `sortBy` | `string` | `"normal"` | Sort order: `normal` (comprehensive relevance), `booked` (sales volume / best selling), `repurchase` (repeat buyer rate), `priceAsc`, `priceDesc`, or `newest`. | | `priceMin` | `integer` | — | Minimum wholesale price in Chinese Yuan (¥ CNY). 100% server-side filtered natively by 1688. | | `priceMax` | `integer` | — | Maximum wholesale price in Chinese Yuan (¥ CNY). 100% server-side filtered natively by 1688. | | `province` | `string` | — | Filter by manufacturing province (e.g. `广东` for electronics/apparel, `浙江` for Yiwu small commodities). 100% server-side filtered. | | `verticalProductFlag` | `string` | `"factory"` | Sourcing channel: `factory` (OEM/ODM direct factory), `superFactory` (top mega-factories), `kuajing` (cross-border export), `spot` (ready-to-ship), or `""` (all channels). | | `proxyConfiguration` | `object` | Residential | Apify Proxy configuration (residential proxies required for high throughput). | *** #### 📋 Copy-and-Paste Directive for AI Coding Assistants (Cursor, Windsurf & Claude Code) Give this direct prompt instruction to your AI assistant: > *"Use the `unitbytes/1688-scraper` Actor on Apify to extract 1688 direct factory listings, MOQ price tiers, and Amazon FBA carton specs. Example call: `client.actor('unitbytes/1688-scraper').call(run_input={'queries': ['phone case'], 'detailLevel': 'full', 'maxItems': 50})`"* *** #### 🔌 MCP Server Setup: Claude Code, Cursor & AI Agents Connect this scraper directly to **Claude Code**, **Claude Desktop**, **Cursor**, or any MCP-compatible AI agent via the hosted Apify MCP server: ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=actors,docs,unitbytes/1688-scraper" } } } ``` *No manual API token required in configuration if your client supports Apify OAuth sign-in. Alternatively, pass your Apify API Token in the authorization header.* *** ### ❓ Frequently Asked Questions (FAQ) #### Do I need a 1688 account, Alipay, or Chinese phone number? **No.** The scraper operates entirely autonomously without requiring an account, phone number (+86), or session cookies. #### Can I search 1688 by product photo / image (`以图搜款 / 拍立淘`)? **Yes!** Use our dedicated [**1688 Reverse Image Search (Photo-to-Factory) Scraper**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem) to upload any product photo directly, paste Amazon/Shopify/AliExpress image URLs, or pass Base64 images to find the exact Chinese manufacturer, MOQ price tiers, and Amazon FBA packaging specs. #### Can I search using English keywords? **Yes.** Standard English terms (e.g. `phone case`, `yoga pants`, `hoodie`, `earbuds`, `smart watch`) are supported. Sourcing teams often also search with native Chinese product terms (e.g. `手机壳`, `运动裤`, `蓝牙耳机`) for maximum supplier discovery. #### How do I use the Amazon FBA packaging weights and dimensions? Every record in **Full Detail** mode includes the physical `weightGrams` and dimensions (`lengthCm`, `widthCm`, `heightCm`) per variant. Use these numbers directly in your Amazon FBA revenue calculator to determine exact shipping and fulfillment fees. #### What is the difference between Super Factory and Factory Inspection? - **Super Factory (超级工厂):** Alibaba's highest verified certification tier awarded to large-scale manufacturers with substantial annual revenue, modern production lines, and direct factory management. - **Factory Inspection (深度验厂):** Facilities audited physically on-site by accredited third-party inspection firms (such as SGS or Bureau Veritas) to verify worker counts, factory square footage, and production machinery. #### How does pagination resumption work? Every exported item and run summary includes an encrypted **`resumptionToken`**. If you want to continue a massive scrape without re-extracting previous items, simply pass the token into your next run's input. *** ### 📞 Support & Issue Reporting Have a bug report or feature request? Please open an issue on the Apify Actor Issues tab: - **Apify Actor Store:** [1688 Wholesale & Factory Scraper](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=gh_1688) - **Bug Reports & Feature Requests:** [Apify Issues](https://apify.com/unitbytes/1688-scraper/issues) - **Author:** UnitBytes

*** ### 🌐 Related Chinese E-Commerce, Wholesale Sourcing & Social Commerce Actors Combine our specialized Chinese e-commerce and B2B procurement scrapers for end-to-end supplier discovery, retail benchmarking, and social trend validation: | Actor | Purpose & Superpowers | Pricing | | :--- | :--- | :--- | | [**1688 Factory Direct Scraper & Price Monitor**](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=ecosystem) *(📍 You are here)* | Direct manufacturer sourcing, true factory prices, full SKU matrices, stock monitoring & Amazon FBA packaging specs | From $0.0015 / item | | [**1688 Global Scraper & Arbitrage API (AliTrading)**](https://apify.com/unitbytes/1688-global-scraper?fpr=939u3w\&fp_sid=ecosystem) | English search, CE/FCC/RoHS/UL/CPC certification filters, 24h/48h dropshipping, 15 currencies & 9-market Amazon/TikTok Shop arbitrage leaderboards | From $0.0015 / item | | [**1688 Reverse Image Search (Photo-to-Factory)**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | Visual product search (`以图搜款 / 拍立淘`): upload any product photo, URL, or Base64 to find the exact 1688 factory | From $0.0015 / item | | [**Alibaba Wholesale Scraper**](https://apify.com/unitbytes/alibaba-scraper?fpr=939u3w\&fp_sid=ecosystem) | Global B2B product catalog, MOQ brackets, volume tiers, FBA carton specs & Verified Supplier audits | From $0.0015 / item | | [**Taobao & Tmall Product Scraper**](https://apify.com/unitbytes/taobao-tmall-scraper?fpr=939u3w\&fp_sid=ecosystem) | China's premier retail marketplace: customer reviews, 3-axis DSR scores, buyer sentiment tags & multi-currency prices | From $0.0015 / item | | [**Taobao & Tmall Seller Catalog & Shop Scraper**](https://apify.com/unitbytes/taobao-seller-shop-scraper?fpr=939u3w\&fp_sid=ecosystem) | Extract full Taobao & Tmall seller storefront catalogs (`淘宝店铺`), shop item counts, new arrivals & 3-axis DSR ratings | From $0.0015 / item | | [**Goofish / Xianyu Fast Search & Deals Scraper**](https://apify.com/unitbytes/goofish-xianyu-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | Alibaba's C2C resale market (`闲鱼`): liquidation deals, seller price-drop sniping & secondhand arbitrage | From $0.0015 / item | | [**Goofish / Xianyu Sellers, Inventory & Reviews Scraper**](https://apify.com/unitbytes/goofish-scraper?fpr=939u3w\&fp_sid=ecosystem) | Merchant due diligence, Zhima Credit (`芝麻信用`) ratings, active/sold store catalogs & buyer unboxing photos | From $0.001 / item | *** ### 📦 Other Published UnitBytes Actors (Global Marketplaces, Maps, Trends & Communities) Explore the rest of the **UnitBytes** data extraction fleet on the Apify Store: #### 📈 Search Trends, E-Commerce Demand & Community Intelligence | Actor | Purpose & Superpowers | Pricing | | :--- | :--- | :--- | | [**Google Trends Scraper & Data API (All-in-One)**](https://apify.com/unitbytes/google-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | All 5 endpoints (`interest_over_time`, `trending_now`, `interest_by_region`, `related_queries`, `related_topics`) across 5 Google properties | From $0.30 / 1K | | [**Google Trends Fast API**](https://apify.com/unitbytes/google-trends-api?fpr=939u3w\&fp_sid=ecosystem) | Low-latency programmatic search curves, real-time interest spikes & multi-year historical trend data | From $0.30 / 1K | | [**Google Trending Now & Realtime Trends Scraper**](https://apify.com/unitbytes/google-trending-now-scraper?fpr=939u3w\&fp_sid=ecosystem) | Real-time 4h/24h/48h/7d viral search breakouts, search volumes, growth % & context news articles | From $0.30 / 1K | | [**Google Shopping Trends Scraper**](https://apify.com/unitbytes/google-shopping-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | Breakout physical merchandise demand (`froogle`), seasonal buying curves & top shopper regions | From $0.30 / 1K | | [**YouTube Trends Scraper**](https://apify.com/unitbytes/youtube-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | Breakout YouTube video search queries, creator SEO topics & regional viewer demand | From $0.30 / 1K | | [**Reddit Scraper & Media API (All-in-One)**](https://apify.com/unitbytes/reddit-scraper?fpr=939u3w\&fp_sid=ecosystem) | Subreddit feeds, 5-tab search, user profiles, deep nested comment trees & permanent HD media links | From $0.50 / 1K | | [**Reddit Search Scraper: Brand Monitoring & B2B Leads**](https://apify.com/unitbytes/reddit-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | 5-surface keyword discovery across posts, communities, users, media & comments | From $0.50 / 1K | | [**Reddit Subreddit Scraper: Hot Posts & Subreddits**](https://apify.com/unitbytes/reddit-subreddits-scraper?fpr=939u3w\&fp_sid=ecosystem) | Community feed monitoring (`hot`, `new`, `top`, `rising`) & subreddit metadata | From $0.50 / 1K | | [**Reddit Comments Scraper: Comment Trees & Sentiment**](https://apify.com/unitbytes/reddit-comments-scraper?fpr=939u3w\&fp_sid=ecosystem) | Deep recursive comment reply trees (`depth`, `parentId`) for LLM/RAG & sentiment analysis | From $0.50 / 1K | #### 📍 Google Maps, Naver Place & Local Business Intelligence | Actor | Purpose & Superpowers | Pricing | | :--- | :--- | :--- | | [**Google Maps Email & Leads Scraper (B2B Contacts)**](https://apify.com/unitbytes/google-maps-leads-scraper?fpr=939u3w\&fp_sid=ecosystem) | Extract B2B business leads with verified website emails, phone numbers, social links, tech stack & ad pixels | From $0.50 / 1K | | [**Google Maps Reviews Scraper (All 10K Reviews)**](https://apify.com/unitbytes/google-maps-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem) | Extract up to 10,000 reviews per place sorted by newest/lowest rating, server-side keyword filter & policy report links | From $0.25 / 1K | | [**Google Maps Review Monitor & Change Tracker (Alerts & ORM)**](https://apify.com/unitbytes/google-maps-reviews-tracker?fpr=939u3w\&fp_sid=ecosystem) | Stateful cross-run monitoring for `NEW`, `REMOVED`, and `EDITED` customer reviews plus owner reply SLA tracking | $1.50 / 1K | | [**Google Maps Contributor & Local Guide Reviews Scraper**](https://apify.com/unitbytes/google-maps-contributor-scraper?fpr=939u3w\&fp_sid=ecosystem) | Reviewer profile audits, Local Guide levels (1–10), badges & lifetime review histories | Pay-Per-Event | | [**Google Maps Photos Scraper (Places, Menus & Local Guides)**](https://apify.com/unitbytes/google-maps-photos-scraper?fpr=939u3w\&fp_sid=ecosystem) | Original `=s0` full-resolution place & menu photos, playable MP4 videos, 360° & Local Guide photo feeds | Pay-Per-Event | | [**Naver Place & Map Scraper (네이버 플레이스·지도)**](https://apify.com/unitbytes/naver-place-scraper?fpr=939u3w\&fp_sid=ecosystem) | South Korean local business leads, KRW menus, 7-day hours, `0507` SmartCall phones, GPS & visitor/blog reviews | From $1.00 / 1K | | [**Naver Place Reviews Scraper (네이버 플레이스 리뷰)**](https://apify.com/unitbytes/naver-place-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem) | Receipt-verified Korean visitor reviews, server-side photo review filter, sentiment keywords & linked Naver Blog reviews | From $0.50 / 1K | | [**Naver Map Scraper: Korean Leads & Menus (네이버 지도)**](https://apify.com/unitbytes/naver-map-scraper?fpr=939u3w\&fp_sid=ecosystem) | Korean B2B business discovery, road addresses, subway directions, amenities & full menu pricing | From $1.00 / 1K | #### 🏷️ Global Classifieds, Automotive & Real Estate Marketplaces | Actor | Purpose & Superpowers | Pricing | | :--- | :--- | :--- | | [**Facebook Marketplace Scraper (All-in-One)**](https://apify.com/unitbytes/Facebook-Marketplace-Scraper?fpr=939u3w\&fp_sid=ecosystem) | Deep city pagination with 40+ structured fields: cars, rentals, local deals, seller profiles & HD galleries | From $0.60 / 1K | | [**Facebook Marketplace Vehicle & Car Scraper**](https://apify.com/unitbytes/facebook-marketplace-vehicle-scraper?fpr=939u3w\&fp_sid=ecosystem) | Used cars, trucks & motorcycles by city/ZIP with 17-digit VIN, odometer mileage & transmission | From $0.60 / 1K | | [**Facebook Marketplace Property & Rentals Scraper**](https://apify.com/unitbytes/facebook-marketplace-property-scraper?fpr=939u3w\&fp_sid=ecosystem) | Apartments & homes for rent or sale with bedrooms, bathrooms, sqft, pet policies & walk scores | From $0.60 / 1K | | [**Facebook Marketplace Details & Status Checker**](https://apify.com/unitbytes/facebook-marketplace-status-checker?fpr=939u3w\&fp_sid=ecosystem) | Bulk check listing URLs or IDs for live `ACTIVE`, `SOLD`, or `PENDING` status, price drops & seller catalogs | From $0.60 / 1K | | [**OfferUp Scraper: Marketplace Listings, Cars & Deals**](https://apify.com/unitbytes/offerup-scraper?fpr=939u3w\&fp_sid=ecosystem) | Local pickup & nationwide shipping listings, 19 vehicle specs, seller storefronts & price drops | From $0.60 / 1K | | [**OfferUp Used Cars, Vehicles & VIN Scraper**](https://apify.com/unitbytes/offerup-vehicles-cars-scraper?fpr=939u3w\&fp_sid=ecosystem) | 17-digit VIN, clean/salvage title, city/hwy MPG, drivetrain & Carfax/AutoCheck history issue counts | From $0.60 / 1K | | [**OfferUp Seller Inventory & Auto Dealer Leads Scraper**](https://apify.com/unitbytes/offerup-seller-inventory-scraper?fpr=939u3w\&fp_sid=ecosystem) | Full `/p/` storefront inventory plus verified dealer phone numbers, physical addresses & reviews | From $0.60 / 1K | | [**OfferUp Deal Monitor, Price Drop & Status Tracker**](https://apify.com/unitbytes/offerup-deal-monitor-scraper?fpr=939u3w\&fp_sid=ecosystem) | Real-time bargain hunting, exact `$` and `%` price drop calculations & batch `LISTED`/`SOLD` status checks | From $0.60 / 1K | | [**Craigslist Search Scraper (All-in-One)**](https://apify.com/unitbytes/craigslist-scraper?fpr=939u3w\&fp_sid=ecosystem) | 700+ cities worldwide across all categories: cars, housing, jobs, for sale, services & direct contact leads | From $0.50 / 1K | | [**Craigslist Cars & Vehicles Scraper (By Owner & VIN)**](https://apify.com/unitbytes/craigslist-cars-vehicles-scraper?fpr=939u3w\&fp_sid=ecosystem) | Filter by owner (`cto`) vs. dealer (`ctd`), 17-digit VIN, odometer mileage, title status & powersports | From $0.50 / 1K | | [**Craigslist Real Estate, Property & Housing Scraper (FSBO)**](https://apify.com/unitbytes/craigslist-real-estate-property-scraper?fpr=939u3w\&fp_sid=ecosystem) | Apartments, FSBO homes, rentals & sublets with bedrooms, bathrooms, sqft, pet policies & parking | From $0.50 / 1K | | [**Craigslist Jobs, Gigs & Services Scraper**](https://apify.com/unitbytes/craigslist-jobs-gigs-services-scraper?fpr=939u3w\&fp_sid=ecosystem) | 35+ job sectors, paid gigs & local services with compensation extraction and remote/telecommute filters | From $0.50 / 1K | *** ### 🔍 Keywords & Search Tags `1688` • `1688.com` • `1688-scraper` • `1688.com-scraper` • `1688-api` • `1688.com-api` • `1688-wholesale` • `1688.com-wholesale` • `1688-factory-sourcing` • `1688.com-factory-sourcing` • `scrape-1688` • `scrape-1688.com` • `alibaba-scraper` • `1688-crawler` • `1688.com-crawler` • `1688-product-scraper` • `1688爬虫` • `1688.com爬虫` • `1688数据采集` • `alibaba-1688-python` • `amazon-fba-sourcing` • `china-factory-scraper` • `dropshipping-sourcing-agent` • `super-factory-1688` • `yiwu-market-scraper` • `cross-border-ecommerce` • `apify-actor` • `oem-odm-china-manufacturers` • `1688-price-monitor` *** ### ⚖️ Compliance & Privacy This Actor extracts **strictly publicly available B2B product and supplier catalog data** from 1688.com. It does not log into private user accounts, bypass authentication walls, or collect private buyer messages. Personal data is protected by regulations such as GDPR and CCPA—see Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) and ensure your usage complies with applicable laws. #### Disclaimer This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Alibaba Group, 1688.com, or any of their subsidiaries. # Actor input Schema ## `queries` (type: `array`): List of product keywords to search on 1688.com (e.g., \['phone case', 'smart watch', '蓝牙耳机']). Scrapes multiple keywords in a single run. ## `keyword` (type: `string`): Single keyword in English or Chinese (e.g. 'phone case', '手机壳', '蓝牙耳机') or a numeric 1688 offer ID (e.g. '685176373959'). If provided, it is added to the search queries. Ignored if startUrls or offerIds are provided. ## `offerIds` (type: `array`): Optional list of numeric 1688 wholesale product offer IDs (e.g. '685176373959', '1015804349214'). Directly extracts full B2B details, tiered volume prices, and SKU matrices for each product without searching. ## `startUrls` (type: `array`): Paste any 1688 URLs directly from your browser: direct product offer links (e.g. 'https://detail.1688.com/offer/685176373959.html') or search listing URLs (e.g. 'https://s.1688.com/selloffer/offer_search.htm?keywords=hoodie'). You can also use 'Direct Offer IDs' to enter raw IDs. ## `searchUrls` (type: `array`): Optional list of 1688 search listing URLs. Note: you can also paste search URLs directly into 'Start URLs' above. ## `maxItems` (type: `integer`): Maximum number of wholesale offers to scrape (1 to 10,000). ## `resumptionToken` (type: `string`): Optional encrypted resumption token copied from a previous run, Key-Value store, or dataset item. Restores the exact session and continues scraping directly from where it left off without starting over. ## `detailLevel` (type: `string`): Choose 'Full B2B Mode' for complete wholesale tiered volume prices, full color/size SKU variations, MOQ, and verified factory audit badges, or 'Summary Mode' for fast product search card discovery. ## `sortBy` (type: `string`): Sorting order for listings. Note: To target products in a specific price bracket without losing search relevance, use 'Min Price' and 'Max Price' below. ## `priceMin` (type: `integer`): Minimum unit wholesale price in Chinese Yuan (CNY ¥). Server-side filtered natively by 1688. ## `priceMax` (type: `integer`): Maximum unit wholesale price in Chinese Yuan (CNY ¥). Server-side filtered natively by 1688. ## `province` (type: `string`): Filter by Chinese manufacturing province (e.g. '广东' for Guangdong/Shenzhen/Guangzhou, '浙江' for Zhejiang/Yiwu/Hangzhou, '江苏' for Jiangsu). ## `verticalProductFlag` (type: `string`): Select the 1688 wholesale channel to query directly at source: 'Direct Factory' for OEM/ODM manufacturers, 'Super Factory' for top mega-factories, 'Cross-Border' for Amazon FBA/export sellers, 'Ready-to-Ship' for in-stock spot items, or 'All Channels'. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration for fast worldwide access. Apify Residential proxy is recommended for high-volume extraction. ## Actor input object example ```json { "queries": [ "phone case" ], "maxItems": 30, "detailLevel": "full", "sortBy": "normal", "province": "", "verticalProductFlag": "factory", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): Extracted 1688 B2B wholesale offers, tiered pricing, and factory intelligence # 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 = { "queries": [ "phone case" ], "maxItems": 30, "detailLevel": "full", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("unitbytes/1688-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 = { "queries": ["phone case"], "maxItems": 30, "detailLevel": "full", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("unitbytes/1688-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 '{ "queries": [ "phone case" ], "maxItems": 30, "detailLevel": "full", "proxyConfiguration": { "useApifyProxy": true } }' | apify call unitbytes/1688-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/1688-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 ` 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/M5S1OECxbMeNY8AzG/builds/itqudtryXbvObdBUC/openapi.json