# Chinagoods Scraper 中国小商品城: Booth Monitor (`getascraper/chinagoods-booth-monitor`) Actor Monitor public Chinagoods products, MOQ, stock, supplier shops and Yiwu booth locations. Built for recurring sourcing and supplier-change workflows. - **URL**: https://apify.com/getascraper/chinagoods-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 ## 🏪 Chinagoods Scraper 中国小商品城: Yiwu booth monitor
Track Yiwu sourcing opportunities before a supplier change gets missed.
Search public Chinagoods listings and receive product, price, MOQ, stock, supplier, and booth information in a ready-to-use dataset. 搜索中国小商品城公开商品，获取价格、起订量、库存、商户和摊位信息。
🔎 Search products
Find public wholesale listings by English or Chinese keywords.		 🏷️ Compare terms
Bring price, MOQ, stock, and supplier details into one sheet.		 📍 Find booths
Keep the public Yiwu booth location when the source provides it.		 🔔 Watch changes
Schedule repeat runs and return only new or changed records.
Chinagoods, also known as 中国小商品城, is a public sourcing marketplace for Yiwu wholesale goods. This Actor turns the public listing data into a clean sourcing feed. Use it for supplier shortlists, price checks, inventory review, and scheduled change monitoring. ### 🎯 Who uses it - **Sourcing teams** compare multiple Yiwu suppliers before sending an enquiry. 采购团队可先比较义乌商户，再发起询盘。 - **Importers and wholesalers** keep a watchlist of product terms, minimum orders, and available stock. 进口商和批发商可追踪商品条件与库存。 - **Market researchers** build a repeatable view of a product category and its suppliers. 市场研究人员可建立可重复的数据集。 - **Operations teams** schedule a change-only run instead of reviewing the same records repeatedly. 运营团队可只接收新增或变化的数据。 ### 📦 What you receive Each result is one public Chinagoods product record. Fields are included only when the public listing provides them. Every result retains its source URL and collection time for traceability. 每条结果对应一个中国小商品城公开商品。只有公开页面提供的字段才会输出，并保留来源链接和采集时间，方便核对。 ```json { "productId": "1694540341174677506", "title": "3D moon lamp Night light", "price": 1500, "minimumOrderQuantity": 1, "stock": 17861, "supplierName": "Minggao Gift Shop", "boothLocation": "District 1 - International Trade Market", "sourceUrl": "https://en.chinagoods.com/search?keyword=led%20light", "scrapedAt": "2026-07-23T15:35:28.782Z" } ```` ### 🚀 How to use it
STEP 1
Describe the product
Type product words in English or Chinese, such as LED lights or 收纳盒. A Chinagoods link is optional. 输入中英文商品词，例如 LED lights 或收纳盒，链接并非必需。		 STEP 2
Set the limit
Choose how many unique product records you need. 设置本次需要的唯一商品数量。		 STEP 3
Review or schedule
Export the dataset, or schedule change-only runs for your watchlist. 导出数据集，或安排只返回变化记录的定时运行。
### 🧾 Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `searchKeywords` | array of strings | No | Describe the products you want to source in English or Chinese. This is the easiest way to start and requires no marketplace URL. | | `startUrls` | array of URLs | No | Optional public Chinagoods search or product pages to add when you already have saved sourcing pages. | | `onlyChanged` | boolean | No | Return only records that are new or changed since the prior run. Defaults to enabled. | | `includeProductImages` | boolean | No | Include the public product image URL when it is 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 Chinagoods product identifier. | | `title` | string | Product title as published by the listing. | | `price` | number | Public listing price when present. | | `minimumOrderQuantity` | number | Public minimum order quantity when present. | | `stock` | number | Public stock value when present. | | `supplierName` | string | Supplier or shop name shown on the listing. | | `supplierId` | string | Public supplier identifier when present. | | `boothLocation` | string | Yiwu booth or market location when shown publicly. | | `boothStatus` | string | Public booth status when shown on the listing. | | `imageUrl` | string | Public product image URL when requested and available. | | `sourceUrl` | string | Source page used for the record. | | `scrapedAt` | string | ISO timestamp for the collection time. | ### 💡 Sourcing tips Use Chinese keywords when you know the category wording used by local suppliers. Keep `onlyChanged` enabled for scheduled runs. Disable it when you need a complete fresh export. Public listings can change or omit fields, so confirm commercial terms with the supplier before ordering. 建议使用本地商户常用的中文关键词。定时监控时保持 `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 Chinagoods Scraper 中国小商品城: Yiwu booth monitor?
⭐ ⭐ ⭐ ⭐ ⭐
Found a supplier or caught a useful product change before it became a sourcing problem?
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 search in Chinese? Yes. Add Chinese or English terms to `searchKeywords`. This is useful when a category is better known by its local supplier wording. ##### 中国小商品城商品数据怎么采集？ Enter public Chinagoods search terms or listing URLs, set a record limit, and run the Actor. It returns the fields that the public listing provides. ##### Does it return private contacts or supplier-only data? No. The Actor returns public listing information only. It does not collect private contact details or data behind a login. ##### How do scheduled change-only runs work? Run the same input on a schedule with `onlyChanged` enabled. Unchanged records are skipped, so the dataset focuses on new or changed public information. ### 🔗 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 ## `searchKeywords` (type: `array`): Add one or more product ideas, such as LED lights, hair accessories, or 收纳盒. English and Chinese both work. ## `startUrls` (type: `array`): Paste public search or product pages only when you already have them. These are added to the product searches above. ## `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 { "searchKeywords": [ "LED lights" ], "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 = { "searchKeywords": [ "LED lights" ], "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/chinagoods-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 = { "searchKeywords": ["LED lights"], "startUrls": [], "onlyChanged": True, "includeProductImages": True, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/chinagoods-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 '{ "searchKeywords": [ "LED lights" ], "startUrls": [], "onlyChanged": true, "includeProductImages": true, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call getascraper/chinagoods-booth-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/chinagoods-booth-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Chinagoods Scraper 中国小商品城: Booth Monitor", "description": "Monitor public Chinagoods products, MOQ, stock, supplier shops and Yiwu booth locations. Built for recurring sourcing and supplier-change workflows.", "version": "0.1", "x-build-id": "CedUUdUYd0golkxWR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~chinagoods-booth-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-chinagoods-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~chinagoods-booth-monitor/runs": { "post": { "operationId": "runs-sync-getascraper-chinagoods-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~chinagoods-booth-monitor/run-sync": { "post": { "operationId": "run-sync-getascraper-chinagoods-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": { "searchKeywords": { "title": "What products do you want to source?", "type": "array", "description": "Add one or more product ideas, such as LED lights, hair accessories, or 收纳盒. English and Chinese both work.", "default": [ "LED lights" ], "items": { "type": "string" } }, "startUrls": { "title": "Saved Chinagoods pages (optional)", "type": "array", "description": "Paste public search or product pages only when you already have them. These are added to the product searches above.", "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 } } } } } } } } } } ```