1688 Supplier & Factory Finder

Find public 1688 wholesale offer listings by product keyword and receive structured supplier shortlists, prices (when available), order-quantity signals, change comparisons, and scores for procurement research. A listing is not proof of factory status or supplier legitimacy. Verify manufacturers, samples, certificates, and contract terms directly before purchasing.

Quick start

Use a Chinese product term for the best match, for example:

{
  "queries": ["LED灯"],
  "maxResultsPerQuery": 2,
  "minMonthlySales": 0,
  "maxPriceCny": 0,
  "previousSnapshot": []
}

The default input needs no MCP connector. Live results are saved to the default Apify Dataset. An optional prior snapshot enables repeat-run comparisons.

Input

• queries: 1 to 5 product keywords (Chinese queries are recommended).
• maxResultsPerQuery: up to 30 qualified listings per keyword.
• minMonthlySales: filter threshold; zero may also mean the public source did not report a value.
• maxPriceCny: optional maximum price in Chinese yuan; zero disables filtering.
• previousSnapshot: optional list of past offers for price, MOQ, tag and volume change detection.
• Optional mcpConnectors and related fields: send results through a connector you authorize; a connector is not required for a normal run.

Dataset output

Each successfully retrieved listing contains searchQuery, offerId, title, offerUrl, sellerLoginId, and available price, MOQ, sales and service signals. supplierScore, sourcingScore and agentAction are heuristic prioritization aids, not certifications or verified claims. sourceConfidence measures available fields, not authenticity. No missing seller or commercial data are invented.

Reliability and diagnostics

This Actor queries live 1688 data. The upstream service may require user verification (RGV587_ERROR / FAIL_SYS_USER_VALIDATE), restrict automated access or time out. It tries direct access, an Apify proxy and, if necessary, one residential proxy request within a bounded retry budget. It does not solve CAPTCHAs or disguise a blocked result as a successful extraction.

Every run writes RUN_DIAGNOSTICS to the Apify Key-value store, including source errors and the count of retrieved queries. If no live qualifying listing can be collected, the run fails explicitly and charges no fabricated result rows. For multiple queries, valid results from available queries can still be returned with errors recorded for other queries.

Pricing

Pay Per Event. The factory's configured base is US$0.006 per decision-ready result; consult the Apify Store for the actual billing terms. Proxy and infrastructure consumption should be included in margin analysis.

Use cases

Supplier discovery, initial procurement shortlists, competitor offer tracking, price-change comparisons and scheduled sourcing research. Use from Apify Console, Tasks, API or agent workflows with human verification for high-value purchasing decisions.

Automation and AI

Structured results are suitable for API, scheduling, spreadsheets and MCP-connected workflows. Verify source completeness before acting on scores. No confirmed manufacturing relationship, certification, inventory or transaction guarantee is implied.

Limitations

Source availability and access rules are controlled by 1688, not by this Actor. Listings may be inaccessible or omit fields. Repeated verification challenges require an authorized alternative upstream access method, not extra retries or fabricated records.

Maintenance history

2026-10-22: bounded verification-aware retries, explicit upstream diagnostics, non-fabricated confidence scoring, and documentation clarification.