# 1688 wholesale products 1688.com (Alibaba's China-domestic wholesale market) products for a keyword, each with CNY unit price and quantity price tiers, minimum order, sales. Needs keywords. Served by Apify. 1688.com (Alibaba's China-domestic wholesale market) products for a keyword, each with CNY unit price and quantity price tiers, minimum order, sales and repurchase rates, stock, shipping origin and the supplier's verification, optionally the SKU variant matrix and dropship and certification data. Use it for sourcing and dropship research; Chinese keywords return more results. Price: up to $0.00499 per product, plus $0.00299 per product carrying supplier intelligence (includeSupplierIntelligence) and $0.00001 per dataset item, plus up to $0.0049 per run. Billed at the run's actual cost, never more than max_cost_usd (default $0.25), which is enforced upstream as the run's charge limit. Returns { run, items } when the run ends within 40 s, otherwise a run id: fetch the items with apify/run-results (free, tool "1688-wholesale-products"). A run that times out or reaches the limit returns and bills its partial items. - Tool ID: `apify/1688-wholesale-products` - Provider: [Apify](/providers/apify.md) - Capability: [E-commerce](/tools/ecommerce.md) - Price: usage based, the maximum is shown before a run - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract Billed at the cost the provider reports for the call, never above $5. Your agent sees the maximum before running. ```json { "model": "reported", "costPath": "data.usageTotalUsd", "requireCost": true, "maxUsdField": "max_cost_usd", "maxUsdDefault": 0.25, "maxUsdCap": 5, "headroom": 1 } ``` Pricing source: [https://apify.com/zen-studio/1688-wholesale-scraper/pricing](https://apify.com/zen-studio/1688-wholesale-scraper/pricing). Pay-per-event rate card of zen-studio/1688-wholesale-scraper, read from the public Apify API (api.apify.com/v2/acts/zen-studio~1688-wholesale-scraper): every event and tier price, the pricing model, who pays platform usage and the minimal charge limit.. Price verification date: 2026-11-03. ## Complete input schema ```json { "type": "object", "properties": { "keywords": { "type": "array", "minItems": 1, "maxItems": 3, "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "description": "Search keywords, one search each (1 to 3), e.g. ['phone case'] or ['手机壳']" }, "maxResults": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20, "description": "Products per keyword, 1 to 100 (each product is billed), e.g. 20" }, "sortBy": { "type": "string", "enum": [ "relevance", "bestSelling", "priceAsc", "priceDesc" ], "default": "relevance", "description": "Order of the results, e.g. 'bestSelling'" }, "priceMin": { "type": "integer", "minimum": 0, "maximum": 1000000, "description": "Lowest unit price in CNY, e.g. 5" }, "priceMax": { "type": "integer", "minimum": 0, "maximum": 1000000, "description": "Highest unit price in CNY, e.g. 50" }, "minOrderQuantity": { "type": "integer", "minimum": 1, "maximum": 1000000, "description": "Only suppliers whose minimum order is at most this, e.g. 50" }, "merchantType": { "type": "string", "enum": [ "any", "superFactory", "verifiedMerchant" ], "default": "any", "description": "Supplier tier: any, Super Factory (verified manufacturers) or Verified Merchant, e.g. 'superFactory'" }, "province": { "type": "string", "minLength": 1, "maxLength": 20, "description": "Supplier province in Chinese, e.g. '广东' (Guangdong) or '浙江' (Zhejiang)" }, "city": { "type": "string", "minLength": 1, "maxLength": 20, "description": "Supplier city in Chinese, e.g. '深圳市' (Shenzhen) or '义乌市' (Yiwu)" }, "excludeKeywords": { "type": "array", "maxItems": 10, "items": { "type": "string", "minLength": 1, "maxLength": 40 }, "description": "Drop products whose title contains any of these words (not billed), e.g. ['包']" }, "includeSkuDetails": { "type": "boolean", "default": false, "description": "Add the SKU variant matrix (colours, sizes, models with price and stock), no extra charge, e.g. true" }, "includeSupplierIntelligence": { "type": "boolean", "default": false, "description": "Add distributor count, dropship order volume, authorised channels, compliance labels and package sizes (billed per product that has them), e.g. true" }, "max_cost_usd": { "type": "number", "minimum": 0.01, "maximum": 5, "default": 0.25, "description": "Charge limit for this run in USD, reserved from your balance and enforced upstream as the run's charge limit (default $0.25, at most $5). The run stops charging there." } }, "required": [ "keywords" ], "additionalProperties": false } ``` ## Published example This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection. ```json { "tool_id": "apify/1688-wholesale-products", "input": { "keywords": [ "phone case" ], "maxResults": 2, "max_cost_usd": 0.05 } } ``` ## Execute and retrieve Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative. This tool uses deferred settlement. Follow its returned task/run instructions; preserve the existing reservation until the result is reconciled. A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md). [REST inspection](https://api.agentik.cc/v1/tools/apify/1688-wholesale-products) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/apify/1688-wholesale-products) · [Agent index](/llms.txt)