1688 Supplier Finder — Bulk Supplier Shortlist & Comparison
Pricing
from $2.10 / 1,000 delivered supplier shortlist rows
Compare 1688 suppliers across your whole product list: a ranked, deduplicated shortlist per product with prices, MOQ and estimated landed cost, plus a free rollup of the suppliers that cover several of your SKUs.
Docs and Store text only; runtime behavior is identical to 0.1.10.
Private candidate; pricing, capacity and resources are unchanged.
Private candidate; pricing, the 100-product limit, enrichment defaults, memory and timeout are unchanged. Supersedes build 0.1.11 (code 0.1.8), which was not sent to QA.
Private candidate; pricing, the 100-product limit, enrichment defaults, memory and timeout are unchanged.
Private candidate; pricing, the 100-product limit, enrichment defaults, memory and timeout are unchanged.
Private candidate; pricing, the 100-product limit, enrichment defaults, memory and timeout are unchanged.
Private candidate; FREE prices, the 100-product limit, memory and timeout are unchanged. Apify builds 0.1.6 and 0.1.7 both contain code version 0.1.5; build 0.1.7 includes the complete SDK budget-edge correction.
Private candidate for independent QA; no pricing or resource changes.
Private candidate; no pricing, resource or input-cap changes.
Private candidate; no price, input-capacity, memory or timeout changes.
Private candidate only; capacity must be re-measured before publishing. No price, memory or platform-timeout changes.
Private build for internal testing; not published to the Store. The four pay-per-event events were registered with effect from 2026-10-14T14:34:42.224Z; the runtime checks their presence before charging. Capacity limits are pending calibration: no reliable per-run product limit is advertised yet.
Migration checkpoints preserve finished searches, shortlisted candidates and enrichment without storing session credentials. Dataset-backed reconciliation avoids duplicate rows and charges after reboot.
External image downloads validate and pin public DNS destinations, enforce redirect checks and a streamed 1 MiB limit, and preserve TLS certificate verification. Browser setup operations are bounded.
Individual identities and unverified keyword storefront names are omitted. Empty or invalid prices cannot become verified prices; source flags retain unknown/null and parse Y/N correctly.
CSV parsing rejects malformed quotes, duplicate alias columns and ragged rows, and protects serialized arrays from formula injection. Coverage follows minimum-match filtering; final ranks use current enriched values.
Product list in, flat supplier shortlist out. Input is products (JSON items with imageUrl or title, plus optional asin and clientSku) or productsCsv (a pasted CSV with a header row; image/title/asin/sku column aliases are accepted). Each dataset item is one input product × one 1688 offer, with inputIndex, clientSku and inputAsin echoed for joins. The ASIN is a label only and is never looked up.
Supplier consolidation view (free). SUPPLIER_ROLLUP (JSON) and SUPPLIER_ROLLUP.csv group delivered rows by supplier across the whole list: matchedProductCount, matchedProductIndexes, offerCount, unit-price range, lowest landed-cost estimate, avgMatchScore, bestRank and catalogCoverage. Every row also carries supplierCatalogCoverage. The rollup lives in the key-value store, never in the dataset, so it adds no billable rows.
Per-product status (free). INPUT_STATUS (JSON) and INPUT_STATUS.csv list every input with its status (OK, INVALID_PRODUCT, IMAGE_FETCH_FAILED, NO_MATCH, RISK_CONTROL, NETWORK, DEADLINE_SKIPPED, SKIPPED_QUOTA) and the rows it delivered. Products without rows are not charged.
Shortlist controls. shortlistSize (1–10, default 5), enrichDepth (0 to shortlistSize; defaults to 1 through enrichDetails: true), maxResultsPerProduct (1–20, default 20), sortBy (landedCost by default, or price, supplierYears, matchScore, supplierCoverage), minMatchScore (default 0), supplierDedupe (default on), excludeSupplierIds and targetMarket. With sortBy: "landedCost", enriched rows come first by landed cost and the rest follow by unit price; rankBasis records the key that placed each row.
Matching. Photos use 1688's reverse image search. Titles use English→Chinese keyword mapping plus 1688's keyword search; this path is experimental and less precise than photos. matchScore is a relative position score (1.0 = 1688's first result), not a similarity value.
Trust and disclosure. Every row carries enriched, priceVerified (true only when the detail page confirmed the price), detailLevel (list / detail / partial), scrapedAt and sourceUrl. Decision fields (landed cost, weight, suggested retail, margin estimate, dropship score), compliance hints and the price ladder are filled on enriched rows only, by design. Known gaps are disclosed: no reviewCount/rating, responseRate usually null, categoryId without a category path. Personal data is excluded, and individual sellers have companyName/supplierUrl blanked.
Planned pricing (pay per event). run-base-fee $0.01 (once, only when at least one row is delivered), product-matched $0.010 (per product with at least one row), shortlist-row $0.003 (per row) and supplier-enriched $0.002 (per row with a full detail). No start fee and no platform-usage pass-through. maxTotalChargeUsd defaults to $20 (minimum $0.04); products the cap cannot fully cover are skipped up front as SKIPPED_QUOTA and never charged. Worked example: 10 products × 5 offers with enrichDepth 1 = $0.28.
Zero-charge validation errors. NO_INPUT, INPUT_TOO_LONG, CSV_PARSE_FAILED (echoes the detected columns) and ENRICH_CAP_EXCEEDED (products × enrichDepth above 400; the message suggests a valid configuration). Runtime outcomes are QUOTA_BLOCKED, RISK_CONTROL_CANARY, CIRCUIT_BREAKER and PARTIAL_DEADLINE (products skipped by the time budget are free).
Pipeline. Built on the 1688 image-search pipeline, with a wave-aware search time budget, a detail budget sized to products × enrichDepth, and a hardened detail browser: if removing the bandwidth guard fails, it is retried once, and on a second failure the group fails as guard_stuck instead of fetching with the guard still attached.
Schemas and run options. Dataset, key-value store (SUMMARY, OUTPUT, SUPPLIER_ROLLUP, SUPPLIER_ROLLUP.csv, INPUT_STATUS, INPUT_STATUS.csv) and output schemas are declared. Default run options: 2,400 s timeout and 1,024 MB of memory (fixed).
