1688 Sourcing Intelligence — Search + Offer Details

Structured 1688.com (Alibaba China wholesale) sourcing data: keyword search and product offer details, no account required. Deterministic output — built for sourcing / dropshipping / margin workflows and AI agents.

Two data modes

🔎 Keyword search (mtop gateway — HTTP pure, no proxy)

Chinese wholesale search via 1688's own mobile gateway (signed mtop calls, guest token). Works from standard datacenter IPs — no browser, no captcha. Each returned row (charged search-result): offerId, clean title, price CNY, main image, province/city, seller memberId + name, verification flags (superFactory / business inspection / power merchant), sales proxy, offer URL.

{ "keywords": ["手机壳"], "maxResults": 50, "merchantType": "verifiedMerchant" }

📦 Offer details (best-effort — rotating residential nodes)

Full offer page for a list of offerIds (charged offer-detail per offer): title, start price CNY, price tiers, variant colors, sales count, supplier flags. 1688 rate-limits/anti-bot ("x5sec") is IP-reputation based: a failed fetch is retried on a NEW residential node, never on the same one (a blocked node stays blocked). maxOfferAttempts (default 2) = distinct nodes tried.

{ "offerIds": ["871022139800", "927875250705"] }

offerIds takes priority: when filled, keywords is ignored.

Pricing (pay-per-event)

Event	Price	Charged when
search-result	$0.002	One search result row pushed
offer-detail	$0.008	One offer detail row pushed (all node attempts included)

Runs returning nothing cost nothing. Filters (merchantType) only remove rows, never add charges.

Honest limitations

• Offer details depend on residential node quality for Alibaba's anti-bot: measured ~60-90 % per node class; node rotation on failure is built in, but a heavily flagged batch can still fail — failed offers are reported with fetchStatus (SLIDER/EMPTY/ERR) and are not charged.
• Search-level merchant flags are approximate; full badges require the offer row.
• Price tiers in v1 are best-effort from the mobile offer page; some offers only expose the starting price (priceStartCny).
• 1688 data is China-wholesale oriented; pricing in CNY. Comply with 1688/Alibaba Terms and your local regulations.

Output example (offer detail)

{
  "offerId": "871022139800",
  "title": "适用苹果18ProMax德甲磁吸隐藏式支架手机壳…",
  "priceStartCny": 9.5,
  "priceTiers": [],
  "variantColors": ["黑色", "灰色", "蓝色", "粉色"],
  "salesCount": 21,
  "supplierFlags": []
}

Roadmap

• v1.2: richer SKU/quantity-ladder parse, supplier score unification
• v2: Sourcing Margin Calculator (landed-cost + resale margin, explicit disclaimer)