1688 Wholesale Products Scraper

Export public 1688 wholesale product search results by keyword: offer IDs, titles, visible prices, minimum order quantities (MOQ), sales signals, supplier details, images, and product URLs. Use the dataset for sourcing spreadsheets or API-based product research.

This build supports keyword search, not direct offer-URL or offer-ID lookups. Supplier and product details vary with what 1688 exposes. Empty optional fields are not verified supplier information.

Quick start

Enter one product keyword, preferably in Chinese, and start with a small result limit:

{ "keywords": ["手机壳"], "maxResults": 2 }

Download the dataset as CSV, Excel or JSON, or read it through the API. No 1688 login or cookies are required. Public access can be challenged and fewer results, including zero, are possible. The default connection uses managed residential bandwidth. A started run can incur charges even without products.

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

Ready-to-run examples

Choose a public example to see its settings before starting a run:

• Find Low Cost 1688 USB Cable Offers
• Compare 1688 Bluetooth Earbud Suppliers
• Export 1688 Phone Case Products

What you get

One product row per unique offer found by your keyword searches. Rows include the offer identity and source link, with visible CNY price, MOQ, supplier and sales signals where available. See Output data for the exact fields and their availability.

Who is it for?

• Ecommerce buyers preparing a phone-case or accessory sourcing shortlist before contacting suppliers.
• Procurement analysts comparing visible prices and order quantities while keeping unknown values separate.
• Sourcing agencies delivering product sheets with original offer links for a client's manual review.
• Marketplace researchers comparing repeated keyword exports in their own spreadsheet or database.

How you can use the data

• Build a phone-case offer sheet. Search 手机壳, then export offerId, title, priceText, moqText and detailUrl. Buyers can open each source offer to check the terms before requesting a quote.
• Review a quantity-limited shortlist. Set minOrderQuantity to your maximum acceptable MOQ. Separate rows with missing moq before deciding which offers meet the requirement: unknown values survive the filter.
• Compare your own snapshots. Save offerId, sourceKeyword and scrapedAt with each export, then join later exports by offer ID to review visible price or supplier changes. The comparison is a separate step in your workflow.
• Check source-reported signals. Keep soldText, supplier badges and supplier links beside the offer. Treat them as starting points for manual checks, rather than audited sales or verified supplier credentials.

Input settings

{
  "keywords": ["手机壳", "蓝牙耳机"],
  "maxResults": 20
}

More input settings

Field	Type	Description
keywords	string[]	Product search terms. Chinese terms usually produce the strongest 1688 matches.
maxResults	integer	Maximum unique products to save across all keywords.
priceMin, priceMax	number	Optional local price filters after price extraction.
minOrderQuantity	integer	Maximum acceptable MOQ (despite the field name), applied locally when MOQ is visible.
province, city	string	Optional exact supplier location filters when location is visible.
proxyConfiguration	object	Advanced connection settings. See field help for supported choices and the existing default.
maxConcurrency	integer	Accepted but inactive. Searches remain sequential.
offerIds, offerUrls	array	Accepted but inactive. keywords remains required.
includeSkuDetails, includeDescriptionHtml	boolean	Accepted but inactive. These do not add detail extraction.

Small keyword search

{ "keywords": ["手机壳"], "maxResults": 2 }

Two-keyword product research

{ "keywords": ["手机壳", "蓝牙耳机"], "maxResults": 50 }

Output data

Illustrative output shape only, not a current offer or a verified price. Optional values may be null.

{
  "offerId": "1912412526",
  "title": "定制硅胶手机套 创意手机软胶保护套 滴胶卡通公仔手机壳厂家定制",
  "detailUrl": "https://detail.1688.com/offer/1912412526.html",
  "sourceKeyword": "手机壳",
  "searchPage": 1,
  "position": 2,
  "price": 5,
  "priceText": "￥5.0 成交1笔",
  "currency": "CNY",
  "moq": null,
  "moqText": null,
  "soldText": "成交1笔",
  "bookedCount": 1,
  "imageUrl": "https://...",
  "images": ["https://..."],
  "supplier": { "name": null, "url": null, "location": null, "badges": [], "yearsActive": null, "isVerified": null },
  "serviceTags": ["深度验厂"],
  "canonicalUrl": "https://detail.1688.com/offer/1912412526.html",
  "scrapedAt": "2026-08-02T16:37:22.934Z",
  "error": null
}

More output fields

Data	Fields	Availability
Product identity	offerId, title, detailUrl, canonicalUrl	Public product identity and URLs.
Search context	sourceKeyword, searchPage, position, scrapedAt	Keyword, position and collection time.
Price and order size	price, priceText, currency, moq, moqText, priceTiers	Visible CNY prices and quantity tiers. Unknown values are null or empty.
Sales signals	soldText, bookedCount	Source-reported text/count when available, not audited sales.
Supplier and sourcing	supplier, province, city, serviceTags, productBadges, category, attributes	Varies by public search response. Not independently verified.
Images	imageUrl, images	Visible product image URLs when available.
Reserved detail fields	videoUrl, skuDetails, shipping, services, coupons, descriptionText, descriptionHtml, error	Currently null or empty. No detail-enrichment promise.

Price, MOQ, and location filters retain rows whose corresponding source value is unknown. Inspect those values before treating a row as meeting a sourcing requirement. Results retain the source's order. There is no sorting input or guarantee of lowest-price or best-selling coverage.

Download your results

Open your run's dataset, choose Export and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See Apify's download and export guide for the available formats and field options.

Pricing

This Actor uses pay-per-event pricing: the one-time start event is charged when a run starts, and an item event is charged for each saved product row.

An empty run can still incur the start charge. maxResults bounds the total unique products across keywords, not a guaranteed yield.

See the live Pricing tab for current rates and plan discounts before starting a run.

Extracted product prices are in CNY and are separate from Actor fees.

Tips for best results

• Start with a specific Chinese product term. Try 手机壳 with maxResults: 2, then inspect the returned offers before increasing the limit.
• Check unknown values before accepting a match. Price, MOQ and location filters keep rows where the corresponding source value is missing.
• Keep original offer links in your sourcing sheet. Open them to confirm visible terms and supplier information before making a purchasing decision.
• Read RUN-SUMMARY after an unexpectedly small export. Its per-keyword counts and stop reasons help distinguish an empty search from challenged access.

Limits and caveats

• Submit 1–20 keywords of up to 200 characters each. Prices and maximum MOQ must be nonnegative, and minimum price cannot exceed maximum price.
• Search cards may omit supplier, MOQ or location information. Source-reported sales and badges are not independently verified.
• Result limits are maximums. Narrow filters or challenged access can return fewer products or none. Results keep the source's order, with no lowest-price or best-selling coverage guarantee.
• Unavailable or challenged searches can finish empty. That does not establish that a product is private or deleted. Execution or essential storage failures still fail the run.
• Restarting or resurrecting a cloud run will not repeat extraction. Start a new run instead.
• Direct offer lookup and detail enrichment are inactive. Reserved switches do not add SKU details, shipping information or product descriptions.

Automation and integrations

Save your settings for next time

Once you have an input that works for you, save it as an Apify task. This keeps your settings together so you can use them again without filling in the form from scratch.

Run on a schedule

Need fresh results regularly? You can schedule the Actor or a saved task to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

Send results to your other tools

Use n8n, Make or Zapier to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the Apify integration guides for your chosen tool.

For a custom connection, an Apify webhook can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

API usage

Want to collect this data from your own app or automation? The examples below send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its defaultDatasetId to fetch the results.

For setup instructions, see Apify's JavaScript client guide, Python client guide and Actor runs API reference.

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~1688-wholesale-products-scraper/runs' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  --data @- <<'JSON'
{
  "keywords": [
    "手机壳"
  ],
  "maxResults": 2
}
JSON

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/1688-wholesale-products-scraper').call({
  "keywords": [
    "手机壳"
  ],
  "maxResults": 2
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/1688-wholesale-products-scraper').call(run_input={'keywords': ['手机壳'], 'maxResults': 2})
print(client.dataset(run['defaultDatasetId']).list_items().items)

MCP and AI agents

You can ask your AI assistant to collect data with 1688 Wholesale Products Scraper and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the Apify MCP server. MCP gives your assistant a way to find this scraper, run it and read the results. Follow the official setup and sign-in guide for your app.

Easier setup with an Apify plugin

If you use a supported coding assistant, the official Apify plugin can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

Use Apify AI in Console

Prefer to keep everything in Apify? Open Apify AI in Console and ask it to find Fetch Cat's 1688 Wholesale Products Scraper. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

Choose your assistant

• Claude and Claude Code (Anthropic): Apify setup guide.
• ChatGPT and Codex (OpenAI): Apify setup guides.
• Grok Bot (xAI): Apify plugin guide.
• Gemini CLI (Google): MCP server setup guide. Use the server URL below with the HTTP configuration supported by Gemini CLI.

Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/1688-wholesale-products-scraper"
    }
  }
}

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

Use Apify's general server

Already connected to the general Apify MCP server at https://mcp.apify.com? You can use it to find this scraper without adding another server. Ask your assistant to use 1688 Wholesale Products Scraper by Fetch Cat, or give it the identifier fetch_cat/1688-wholesale-products-scraper.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

Example requests

• “Use Fetch Cat’s 1688 Wholesale Products Scraper to search 手机壳 with a maximum of 5 products. Make a table of titles, price text, MOQ text and offer links, marking missing values.”
• “Search 蓝牙耳机 with this scraper and save up to 5 offers. Show the supplier names, visible sales signals and source links, and distinguish missing information from verified facts.”
• “Collect up to 3 手机壳 offers with a maximum acceptable MOQ of 100. Separate offers with unknown MOQ so I can check them manually before treating them as matches.”

Normal Apify charges apply. Check the live Pricing tab before asking your assistant to run a larger batch.

Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through x402. This experimental option lets an agent use Apify without a conventional account.

Apify AGI provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

Other ways for agents to pay

Apify also supports MPP for prepaid access through AGI and Skyfire for eligible Actors. If your agent already uses one of these, see the agentic payment guide to choose the right setup.

FAQ

What data can I export with 1688 wholesale products scraper?

You can export offer IDs, product titles, visible prices, MOQ text when shown, transaction text, supplier/location signals, images, badges, search position, and product URLs from public 1688 product search pages.

Can I run 1688 Wholesale Products Scraper through an API, schedule, or MCP client?

Yes. Run it from the Apify API, schedule repeat jobs in Apify Console, or connect it to agents through Apify MCP using the examples above.

How much does it cost to use 1688 Wholesale Products Scraper?

A start event is charged when a run starts and an item event for each saved product. An empty run can still incur the start charge. Check the live Pricing tab for current rates before running.

Why are some fields empty?

Available price, location, supplier and image values depend on the public search results. Detail-only fields such as skuDetails, shipping, videoUrl and descriptions are not extracted in this build and remain null or empty, regardless of the reserved input switches.

Related Actors

• Amazon Products & Search Scraper — Collect public Amazon search results and available product metadata, or look up known ASINs and product URLs.
• Walmart Products Scraper — Collect Walmart search listings and available product details for retail assortment comparisons.
• Costco Products Scraper — Collect bounded public Costco product records and available price and availability signals, rather than warehouse-specific inventory.
• eBay Marketplace Scraper — Collect active public eBay listings and available prices and seller fields, rather than sold-price history.
• Shopify Products Scraper — Collect readable public Shopify storefront catalogs with available prices, variants and product metadata.

Support and feedback

For custom additions or integrations, email hello@fetchcat.dev.

Found an error or have a feature request? Open an issue with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See Apify’s guide to sharing a run when reporting an issue. Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. Leave a review to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥