Yiwugo Listings Scraper

🚀 Yiwugo Listings Scraper

Easily extract product listings and supplier data from Yiwugo — the online storefront of Yiwu Small-Commodity City, the world's largest wholesale market. The Yiwugo Listings Scraper lets you pull structured product data, supplier contacts, and physical booth coordinates without dealing with the Vue SSR frontend or the CSRF handshake.

✨ Features

• 🏷️ Comprehensive Product Data – Titles, images, tiered prices, sales counts, MOQs, variants, fulfilment flags, and per-shop reputation.
• 📞 Direct Supplier Contacts – Mobile, WeChat, email, factory address, and shop credit for every listing (when details are enabled). This is the data that sourcing agents actually pay for.
• 🏪 Physical Booth Coordinates – Yiwugo's unique B2B angle: every shop's booth ID, market door, and street inside the Yiwu trade-city building. Walk straight to the booth on a sourcing trip.
• 🔍 Keyword and Direct-ID Modes – Search by free-text keyword (Chinese or English) or fetch specific product IDs you already know.
• ⚡ Fast & Cheap – Plain JSON API + Cheerio crawler. No browser, no proxy needed by default, no anti-bot fees.

🛠️ How It Works

1. Enter search keywords (or product IDs) – Free-text keywords work in any language Yiwugo's search supports.
2. Pick a depth – Listing-only for cheap price-tracking, or Include product details for full supplier contact + booth data.
3. Run the scraper – Structured JSON output streams into the dataset in seconds.

🧾 Input

Field	Type	Description	Default
keywords	string[]	Free-text keywords to search on Yiwugo. Chinese or English both work (e.g. "phone case" or "手机壳").	[]
productIds	string[]	List of Yiwugo product IDs to fetch directly, skipping the search step. Useful when you already know what you want.	[]
maxItems	integer	Global hard cap on the total number of products scraped across all keywords and product IDs. Yiwugo's API caps any single keyword at ~5,000 items.	50
includeDetails	boolean	When enabled, fetches the full product detail JSON (supplier phone, WeChat, email, factory address, booth coordinates, attributes) for every listing. Switches billing to the higher-priced item-detail event.	false
proxyConfiguration	object	Proxy settings. Yiwugo doesn't require a proxy in validation; Apify Proxy is opt-in for scale.	{ "useApifyProxy": false }

📊 Sample Output Data

Each item is a flat JSON record with nulls and empty fields stripped. Listing-only mode (includeDetails: false) returns the core product fields:

{
    "id": 970407473,
    "productUrl": "https://www.yiwugo.com/product/970407473.html",
    "title": "适用苹果17pro手机壳磁吸16promax防摔硬壳磨砂撞色亚克力保护套",
    "images": ["http://ywgimg.yiwugo.com/product/shop_285318/normal/0/20260418/kVASQ5pjUIe2bukj.jpg"],
    "sellPrice": 275,
    "priceType": "1",
    "metric": "个",
    "startNum": 1,
    "saleNumber": 3719415,
    "dealQuantity": 64,
    "deliveryPromise": 2,
    "onlineOrderFlag": 1,
    "marketInfo": "国际商贸城",
    "shopId": 775063,
    "shopName": "云想百货",
    "contacter": "多多",
    "mobile": "15669663507"
}

With includeDetails: true, the record is enriched with the supplier contact dump and physical booth coordinates:

{
    "id": 970407473,
    "productUrl": "https://www.yiwugo.com/product/970407473.html",
    "title": "适用苹果17pro手机壳磁吸16promax防摔硬壳磨砂撞色亚克力保护套",
    "sellPrice": 275,
    "unitprice": "3.13",
    "totalprice": "3.13",
    "metric": "个",
    "defaultfreight": "5.00",
    "saleNumber": 3719415,
    "dealQuantitys": "64",
    "propertyList": [
        { "pvalue": "颜色", "cvalueList": ["马卡龙磁吸-粉色", "马卡龙磁吸-黑色", "..."] }
    ],
    "shopId": 775063,
    "shopName": "云想百货",
    "years": 3,
    "shopCredit": 2,
    "shopIntegrityFraction": 7774,
    "contacter": "多多",
    "mobile": "15669663507",
    "safeMobile": "13335913818",
    "weixin": "15669663507",
    "email": "Lucy@gotoyiwu.com",
    "factoryAddress": "浙江省金华市义乌市江东街道",
    "marketCode": 14,
    "boothId": 761113,
    "boothOwners": "许海明"
}

💰 Pricing

Yiwugo Listings Scraper uses pay-per-event billing — you only pay for the products you successfully receive. No platform compute or proxy charges on top.

Event	When it fires	Price (USD)	Per 1,000 items
product-listing	Each product pushed to the dataset when includeDetails is off (default)	$0.001	$1
item-detail	Each product pushed to the dataset when includeDetails is on (full supplier contacts + booth)	$0.005	$5

Get started sourcing from Yiwu in minutes with Yiwugo Listings Scraper. 🚀