1688 Scraper — Product & Supplier Search, MOQ & Landed Cost
Pricing
from $3.50 / 1,000 search result cards
Watch a shortlist of 1688 offers for price drops and stock changes — daily snapshots, alerts, weekly trend report. Or scrape any category from one English keyword: English titles, MOQ price ladders, landed cost, dropship scores, compliance hints. Failed runs are never charged.
Offer ID
offerId
Optional
Unique 1688 product ID. Use it with the 'offerIds' input to re-fetch this exact product.
Title (English)
titleEn
Optional
AI-translated English product title.
Title (Chinese)
titleCn
Optional
Original Chinese product title as listed on 1688.
Product URL
detailUrl
Optional
Canonical 1688 product page link (desktop URL, no tracking parameters).
Images
images
Optional
Product image URLs from the listing.
Video URL
videoUrl
Optional
Product video URL when the listing includes one; null otherwise.
Price range
price
Optional
Headline wholesale price range in CNY. Needs fetched detail data — null on search-card-level rows.
Quantity-break price ladder
quantityPrices
Optional
Tiered wholesale pricing: unit price at each minimum quantity. Deduplicated and strictly ascending by minQuantity. Empty on search-card-level rows.
MOQ
moq
Optional
Minimum order quantity in units. 1 = supports single-piece orders (dropship-friendly). Null when details could not be fetched.
Stock
stock
Optional
Reported inventory. Sentinel values above 10,000,000 are reported as null (unknown) rather than misleading mega-numbers.
Weight (kg)
weightKg
Optional
Product weight in kilograms, rounded to 3 decimals; null when the source reports no weight (common on card-level rows without pack info). Used for the landed-cost shipping estimate.
Total sales
salesTotal
Optional
Cumulative sales count reported by the platform (demand signal); null when the listing shows no transaction count.
Transaction count (text)
transactionCountText
Optional
Platform-displayed transaction text, e.g. '100+ transactions'.
Booked count (text)
bookedCountText
Optional
Platform-displayed repeat-booking text when present (best-selling signal).
Repurchase rate
repurchaseRate
Optional
Supplier repurchase rate over 3 months (0-1, quality signal). Null when unavailable.
Supplier
supplier
Optional
Supplier trust profile from the detail page. Null on search-card-level rows.
Supplier name
supplierName
Optional
Supplier company name (top-level convenience copy; Chinese, raw source data).
Supplier city
supplierCity
Optional
Supplier city translated to English where known.
Supplier province
supplierProvince
Optional
Supplier province (Chinese).
Shipping
shipping
Optional
Domestic (China-side) shipping signals from the detail page. Null on search-card-level rows.
Dropship signals
dropship
Optional
Raw dropship-related signals from the detail page. Null on search-card-level rows.
Dropship status
dropshipStatus
Optional
null = verified dropship-enabled or filter off; 'unknown' = delivered without a verifiable dropship verdict (fail-open). Filter strictly by dropping 'unknown' rows if needed.
Dropship-Ready Score
dropshipReadyScore
Optional
0-100 weighted score over 7 factors (dropship support, MOQ, 48h pickup rate, distributor count, supplier score, 30-day orders, repurchase rate).
Dropship grade
dropshipGrade
Optional
Letter grade (A+ to F) derived from the Dropship-Ready Score. '+' variants indicate a one-level downgrade due to insufficient scoring data; F = score below 35.
Score confidence
scoreConfidence
Optional
'ok' = score rests on enough real data; 'insufficient_data' = most scoring factors missing (grade downgraded one level).
Estimated landed cost (USD)
estLandedCostUsd
Optional
Heuristic per-unit landed cost for your target market: product + international shipping + duty + platform fees. Uses a fixed FX rate (7.2) — verify before committing.
Compliance hints
compliance
Optional
Heuristic certification hints for the target market (FDA/CE/CPSC/Prop 65 etc). Always verify with a compliance expert.
Source factory
isSuperFactory
Optional
True when the supplier is a certified source factory (1688 'superFactory' classification).
Paid placement
isP4P
Optional
True when the listing is a paid placement (P4P ad) in search results.
Product flags & guarantees
productFlags
Optional
Listing flags: service guarantees (e.g. 7-day return), one-piece order support, supplier type. Null on search-card-level rows.
SKU details
skuDetails
Optional
Per-SKU specs, prices and stock. Empty array unless 'includeSkuDetails' was enabled.
Category path (Chinese)
categoryPath
Optional
1688 category path in Chinese (raw source data).
Category (English)
categoryEn
Optional
Category label: the raw 1688 category path when available (General when unknown).
Data quality tier
dataQuality
Optional
'full'/'partial' = fetched detail layer; 'minimal' = search-card-level delivery (reduced fields). SUMMARY.qualityMix counts each tier.
Source keyword
sourceKeyword
Optional
The English search keyword (or 'offerIds') that produced this row.
Translation method
translationMethod
Optional
How the English title was produced ('dictionary' / 'none').
Scraped at
scrapedAt
Optional
ISO-8601 timestamp of when this exact row was scraped — recency is verifiable per row.
Row type
type
Optional
Discriminator for non-product rows. Absent on product rows; 'monitorReport' for a price-monitoring snapshot row, 'trendReport' for the weekly aggregate.
Snapshot at
snapshotAt
Optional
ISO-8601 timestamp of the monitoring snapshot (monitorReport rows only).
Watchlist size
watchlistSize
Optional
Number of offers snapshotted this run (monitorReport / trendReport rows).
Snapshots
snapshots
Optional
Per-offer current snapshot, history window, changes and alert flag (monitorReport rows).
Alerts
alerts
Optional
Threshold-crossing alerts fired this run: offerId, type, value, threshold (monitorReport rows).
Error code
errorCode
Optional
Degradation/validation code for the run. Present only when set.
Generated at
generatedAt
Optional
ISO-8601 timestamp of the trend aggregate (trendReport rows only).
Offers tracked
offersTracked
Optional
Number of offers included in the trend aggregate (trendReport rows).
Window (days)
windowDays
Optional
History window in days used for the trend aggregate (trendReport rows).
