# Yiwugo Scraper 义乌购: Supplier & Market Monitor (`getascraper/yiwugo-booth-monitor`) Actor Monitor public Yiwugo products, prices, minimum orders, supplier shops and Yiwu market areas for recurring sourcing workflows. - **URL**: https://apify.com/getascraper/yiwugo-booth-monitor.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.66 / 1,000 product records 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## 🛍️ Yiwugo Scraper 义乌购: Supplier & market monitor
Turn Yiwu market listings into a supplier watchlist you can use.
Collect public Yiwugo products with price, MOQ, supplier, market area, and image information. 从义乌购公开商品中获取价格、起订量、商户、市场区域和图片信息。
🏪 Supplier view
Keep supplier names and public IDs with each product.		 💰 Buying terms
Compare public price and minimum order quantities.		 📍 Market area
Focus each run on a public Yiwu market area.		 🔔 Change feed
Repeat the same watch and receive new or changed records.
Yiwugo, or 义乌购, publishes public product listings from the Yiwu market. This Actor gives sourcing teams a practical dataset for reviewing suppliers and commercial signals without manually copying individual listings. ### 🎯 Who uses it - **Buyers** build a shortlist before visiting Yiwu or contacting a supplier. 买家可在到义乌或联系商户前建立候选清单。 - **Wholesale teams** compare price and MOQ across a selected market area. 批发团队可比较指定市场区域的价格和起订量。 - **Product researchers** map a category to public supplier names and product offerings. 产品研究人员可将品类与公开商户和商品对应起来。 - **Sourcing operators** schedule repeat checks and focus on material changes. 采购运营人员可安排重复检查并聚焦变化。 ### 📦 What you receive Each result is one public Yiwugo product record. The Actor includes only fields present in the public response. `marketArea` identifies the selected market area. It is not a claim of an exact physical booth number. 每条结果对应一个义乌购公开商品。Actor 只输出公开响应中存在的字段。`marketArea` 是选定的市场区域，不代表精确的实体摊位号。 ```json { "productId": "933864266", "title": "纱袋喜糖袋网纱袋化妆品束口袋礼品袋", "price": 10, "minimumOrderQuantity": 100, "supplierName": "添喜制袋厂", "supplierId": "730751", "marketArea": "1001", "imageUrl": "http://img1.yiwugo.com/i004/2021/04/09/87/c06fde37a61c2de0569fa63cab5d1da1.jpg", "sourceUrl": "https://www.yiwugo.com/product_list/i_1_1001.html", "scrapedAt": "2026-07-23T15:43:03.564Z" } ```` ### 🚀 How to use it
STEP 1
Start with the recommended market
No Yiwugo link or market code is needed. The default starts in Yiwu International Trade City, District 1. 无需链接或市场代码，默认从义乌国际商贸城一区开始。		 STEP 2
Set a record limit
Choose the amount of product evidence needed for the run. 设置本次需要的商品记录数量。		 STEP 3
Export or monitor
Download the data, or schedule change-only checks for recurring sourcing. 导出数据，或安排只返回变化记录的定时监控。
### 🧾 Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `startUrls` | array of URLs | No | Optional public Yiwugo market pages you have already saved. Leave blank to use the recommended Yiwu International Trade City, District 1 starting point. A pasted page selects its own market area automatically. | | `onlyChanged` | boolean | No | Return only records that are new or changed since the previous run. Defaults to enabled. | | `includeProductImages` | boolean | No | Include public product image URLs when available. Defaults to enabled. | | `maxItems` | integer | No | Maximum number of unique product records to return. The form defaults to 100. | | `proxyConfiguration` | object | No | Connection settings for public pages. The default option is suitable for ordinary runs. | ### 📊 Data table | Field | Type | Description | | --- | --- | --- | | `productId` | string | Public Yiwugo product identifier. | | `title` | string | Product title published on the listing. | | `price` | number | Public product price when present. | | `minimumOrderQuantity` | number | Public minimum order quantity when present. | | `supplierName` | string | Supplier or shop name shown publicly. | | `supplierId` | string | Public supplier or shop identifier. | | `marketArea` | string | Market area selected for the run. | | `imageUrl` | string | Public product image URL when requested and available. | | `sourceUrl` | string | Source market page used for the record. | | `scrapedAt` | string | ISO timestamp for the collection time. | ### 💡 Sourcing tips Leave the saved-page field blank for a simple first run. When you already have a public Yiwugo market page, paste it to monitor that page's market area without finding a technical code. Keep `onlyChanged` enabled for scheduled monitoring. Public catalog data is useful for research, but confirm final product terms with the supplier. 如需保持监控结果可比，请使用相同的市场代码、区域和页码。定时监控时保持 `onlyChanged` 开启。公开目录数据适合研究，但最终商品条款仍应与商户确认。 ### 💰 Pricing This Actor uses pay-per-result pricing. You pay for returned product records, not for empty runs. There is no subscription. 本 Actor 按结果计费，空运行不收费，也没有订阅费用。 ### ⭐ Enjoying Yiwugo Scraper 义乌购: Supplier & market monitor?
⭐ ⭐ ⭐ ⭐ ⭐
Did this Actor make a Yiwu supplier comparison easier to act on?
A 5-star rating takes 10 seconds and helps other sourcing teams find this Actor. Your feedback also guides the next improvement.
★  Rate this Actor on Apify
### ❓ FAQ ##### Can I monitor a different Yiwu market area? Yes. Paste a public Yiwugo market page you already use. The Actor reads its market-area identifier automatically, so you do not need to find a market code or area ID. ##### 义乌购商品数据怎么采集？ Leave the page field blank to use the recommended market, or paste a public market page you already have, then start the run. The Actor returns the product and supplier fields available in the public response. ##### Does `marketArea` provide an exact booth number? No. `marketArea` identifies the selected market area. It should not be treated as an exact physical booth number. ##### Does it collect private supplier contacts? No. The Actor returns public product and supplier fields only. It does not collect private contact information or data behind a login. ### 🔗 Other actors - [Gmarket Korea Scraper](https://apify.com/getascraper/gmarket-scraper) ↗ - Collect public Korean marketplace product listings. - [Mercari Japan Scraper: Price, Condition & Seller](https://apify.com/getascraper/mercari-japan-scraper) ↗ - Research Japanese resale listings and sellers. - [Rakuten Price Monitor: 楽天価格モニター (Ichiba)](https://apify.com/getascraper/rakuten-jp-price-monitor) ↗ - Monitor public Rakuten product pricing. - [Poizon Scraper](https://apify.com/getascraper/poizon-scraper) ↗ - Research public Dewu product listings and resale signals. # Actor input Schema ## `startUrls` (type: `array`): Leave blank to start with Yiwu International Trade City, District 1. Paste a public Yiwugo market page only when you already have one, and its market area will be selected automatically. ## `onlyChanged` (type: `boolean`): Keep this on for scheduled monitoring, or turn it off when you need a complete current snapshot. ## `includeProductImages` (type: `boolean`): Include public product image URLs when the listing provides them. ## `maxItems` (type: `integer`): Choose the maximum number of unique public products to return in this run. ## `proxyConfiguration` (type: `object`): The cost-efficient default is ready to use. Change this only if your organization has its own proxy requirements. ## Actor input object example ```json { "startUrls": [], "onlyChanged": true, "includeProductImages": true, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [], "onlyChanged": true, "includeProductImages": true, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/yiwugo-booth-monitor").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 = { "startUrls": [], "onlyChanged": True, "includeProductImages": True, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/yiwugo-booth-monitor").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 '{ "startUrls": [], "onlyChanged": true, "includeProductImages": true, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call getascraper/yiwugo-booth-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/yiwugo-booth-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Yiwugo Scraper 义乌购: Supplier & Market Monitor", "description": "Monitor public Yiwugo products, prices, minimum orders, supplier shops and Yiwu market areas for recurring sourcing workflows.", "version": "0.1", "x-build-id": "GgTloUfSByoV90ZH3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~yiwugo-booth-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-yiwugo-booth-monitor", "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/getascraper~yiwugo-booth-monitor/runs": { "post": { "operationId": "runs-sync-getascraper-yiwugo-booth-monitor", "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/getascraper~yiwugo-booth-monitor/run-sync": { "post": { "operationId": "run-sync-getascraper-yiwugo-booth-monitor", "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": { "startUrls": { "title": "Saved Yiwugo market pages (optional)", "type": "array", "description": "Leave blank to start with Yiwu International Trade City, District 1. Paste a public Yiwugo market page only when you already have one, and its market area will be selected automatically.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "onlyChanged": { "title": "Show only new or changed products", "type": "boolean", "description": "Keep this on for scheduled monitoring, or turn it off when you need a complete current snapshot.", "default": true }, "includeProductImages": { "title": "Include product image links", "type": "boolean", "description": "Include public product image URLs when the listing provides them.", "default": true }, "maxItems": { "title": "How many products should I check?", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Choose the maximum number of unique public products to return in this run.", "default": 100 }, "proxyConfiguration": { "title": "Connection settings", "type": "object", "description": "The cost-efficient default is ready to use. Change this only if your organization has its own proxy requirements.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```