1688 Wholesale Scraper Pro 📦

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

---

✅ Current status — returning live offers

1688.com is reached through a Web Unlocker with a China exit IP. The source still throws its slider challenge on part of the attempts, so each run retries up to 4 times: measured delivery is ~91% of runs, and a run that never gets through ends with a diagnostic and is not charged.

Status verified 2026-09-10.

🇺🇸 English

Overview

Queries the 1688.com search page for a keyword and returns the wholesale offers on it: product title, price in CNY, supplier company, units sold, buyer repeat rate, image and the canonical offer URL. Every field is read from the response — nothing is derived, converted or filled in.

Features

• Product title — the full listing name, reassembled from the highlighted fragments 1688 splits it into
• Price in CNY — including the decimals, which the page renders in a separate element from the integer part
• Supplier company — the manufacturer or trading company behind the offer
• Units sold & repeat rate — the platform's own sales counter and share of returning buyers, when the card shows them
• Chinese keywords supported — search terms are encoded in GBK, which is what 1688 actually decodes; a UTF-8 encoded term silently returns an unrelated category
• Honest failure: when 1688 answers with its anti-bot page the run ends with a diagnostic record and charges nothing

Input Example

{
  "keyword": "蓝牙耳机",
  "maxItems": 20
}

Output Example

Exactly the fields the Actor writes — there are no other keys.

{
  "productId": "898449197083",
  "title": "26新款华强北7代蓝牙耳机运动降噪耳机蓝牙长续航高音质无线耳机",
  "priceCny": 15.86,
  "supplier": "深圳市信业禾科技有限公司",
  "soldCount": "2.6万+",
  "repeatRatePct": null,
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01OsYCbj1gBE6BDL24j_!!2218904704103-0-cib.jpg_460x460q100.jpg_.webp",
  "productUrl": "https://detail.1688.com/offer/898449197083.html",
  "keyword": "蓝牙耳机",
  "dataSource": "1688-search",
  "scrapedAt": "2026-09-10T06:31:03.310Z"
}

When the source blocks the request, the run succeeds with a single diagnostic record instead (not charged):

{
  "setup_status": "DIAGNOSTIC_GUIDE",
  "_dataQuality": "diagnostic",
  "message": "[DIAGNÓSTICO] O 1688 bloqueou a requisição — nenhuma oferta real pôde ser lida.",
  "potential_causes": ["..."],
  "remediations": ["..."],
  "keyword": "wireless earbuds",
  "blockEvidence": "anti-bot markers in 5183-byte response",
  "proxyEnabled": true,
  "scrapedAt": "2026-08-27T18:32:11.482Z"
}

Input Parameters

Parameter	Type	Description
keyword	string	Required. Product keyword to search (English or Chinese)
maxItems	integer	Max offers to return (default: 20). Canonical name; maxProducts is accepted as a legacy alias
proxyConfiguration	object	Apify Proxy options
unlockerProxyUrl	string	Web Unlocker proxy URL; overrides Apify Proxy when set
brightDataApiToken	string	Bright Data API token — used together with the zone below
brightDataZone	string	Bright Data Web Unlocker zone name

Tips

• Search in Chinese for far better recall: 蓝牙耳机 returns the domestic listings a wholesaler actually sees, while an English term matches only the sellers who translated their title
• soldCount and repeatRatePct come from the card and are null when 1688 does not show them — measured on ~35% and ~81% of cards respectively
• Use productUrl as the join key to open each offer or feed your own enrichment step

Use Cases

• Supplier Sourcing — Find Chinese manufacturing partners for private label products

✅ Capabilities & Limits

Stated up front, so you do not pay a run to find out. Derived from this Actor's own input schema.

Input / feature	Supported	Notes
keyword — required	✅	Product keyword to search, in Chinese (蓝牙耳机) or English (wireless earbuds). Encoded in GBK, which is what 1688 decodes.
Result volume (maxItems)	✅	Hard cap on how many offers the run returns; the search page carries up to 60. Legacy alias maxProducts still accepted.
Title, price, supplier	✅	Measured on 351 cards: title 100%, price 100%, supplier 97%.
Units sold / repeat rate	⚠️	Present only when the card shows them — measured 35% and 81% of cards. null otherwise, never guessed.
Minimum order quantity (MOQ)	❌	Not published on the search page. Requires the offer detail page.
Pagination beyond page 1	❌	One search page per run (up to 60 offers).
Proxy	⚠️	Reaching 1688 needs a China exit IP; a Web Unlocker route is used. Plain Apify Proxy is refused by the source.

FAQ

Q: Does the output include prices and supplier names? A: Yes — priceCny and supplier are read from the search result card. MOQ is not included: 1688's search page does not publish a minimum order quantity (the 起批 marker appears zero times on it), so reading MOQ would require opening each offer page. A field that claimed otherwise would be invented.

Q: Can I search in Chinese? A: Yes, and you should. 1688 decodes the search term as GBK, so this Actor encodes it that way. Latin keywords work too and pass through unchanged.

Q: Why did my run return no offers? A: 1688 throws a slider challenge on part of the requests. Each run retries up to 4 times, which delivers on ~91% of runs; the remainder end with a diagnostic record and are not charged. Re-running usually succeeds.

Q: What does maxItems do? A: It caps how many offers a single run returns. It is the name the Actor reads; maxProducts from older task configurations is still honoured.

---

🇧🇷 Português

✅ Status atual — devolvendo ofertas reais

O 1688.com é alcançado via Web Unlocker com IP de saída na China. A origem ainda lança o desafio de deslize em parte das tentativas, então cada run repete até 4 vezes: a entrega medida é de ~91% dos runs, e um run que não passa termina com diagnóstico e não é cobrado.

Status verificado em 2026-09-10.

Visão Geral

Consulta a página de busca do 1688.com para uma palavra-chave e devolve as ofertas de atacado encontradas: título do produto, preço em CNY, empresa fornecedora, quantidade vendida, taxa de recompra, imagem e a URL canônica da oferta. Todo campo é lido da origem — nada é derivado, convertido ou preenchido.

Funcionalidades

• Título do produto — o nome completo do anúncio, remontado a partir dos fragmentos em que o 1688 o divide ao destacar a busca
• Preço em CNY — com os centavos, que a página renderiza em um elemento separado da parte inteira
• Empresa fornecedora — o fabricante ou trading por trás da oferta
• Quantidade vendida e taxa de recompra — o contador da própria plataforma e o percentual de compradores que voltaram, quando o card os exibe
• Busca em chinês — o termo é codificado em GBK, que é o que o 1688 realmente decodifica; um termo em UTF-8 devolve, silenciosamente, outra categoria de produto
• Falha honesta: quando o 1688 responde com a página anti-bot, o run termina com um registro de diagnóstico e não cobra nada

Exemplo de Entrada

{
  "keyword": "蓝牙耳机",
  "maxItems": 20
}

Exemplo de Saída

Exatamente os campos que o Actor grava — não existem outras chaves.

{
  "productId": "898449197083",
  "title": "26新款华强北7代蓝牙耳机运动降噪耳机蓝牙长续航高音质无线耳机",
  "priceCny": 15.86,
  "supplier": "深圳市信业禾科技有限公司",
  "soldCount": "2.6万+",
  "repeatRatePct": null,
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01OsYCbj1gBE6BDL24j_!!2218904704103-0-cib.jpg_460x460q100.jpg_.webp",
  "productUrl": "https://detail.1688.com/offer/898449197083.html",
  "keyword": "蓝牙耳机",
  "dataSource": "1688-search",
  "scrapedAt": "2026-09-10T06:31:03.310Z"
}

Quando a origem bloqueia a requisição, o run termina com um único registro de diagnóstico (sem cobrança):

{
  "setup_status": "DIAGNOSTIC_GUIDE",
  "_dataQuality": "diagnostic",
  "message": "[DIAGNÓSTICO] O 1688 bloqueou a requisição — nenhuma oferta real pôde ser lida.",
  "potential_causes": ["..."],
  "remediations": ["..."],
  "keyword": "wireless earbuds",
  "blockEvidence": "anti-bot markers in 5183-byte response",
  "proxyEnabled": true,
  "scrapedAt": "2026-08-27T18:32:11.482Z"
}

Parâmetros de Entrada

Parâmetro	Tipo	Descrição
keyword	string	Obrigatório. Palavra-chave do produto (inglês ou chinês)
maxItems	integer	Máximo de ofertas por run (padrão: 20). Nome canônico; maxProducts é aceito como alias legado
proxyConfiguration	object	Opções do Apify Proxy
unlockerProxyUrl	string	URL de proxy de desbloqueio; substitui o Apify Proxy quando preenchido
brightDataApiToken	string	Token da API Bright Data — usado junto com a zona abaixo
brightDataZone	string	Nome da zona Web Unlocker na Bright Data

Dicas

• Busque em chinês para um alcance muito maior: 蓝牙耳机 devolve os anúncios domésticos que um atacadista realmente vê, enquanto um termo em inglês só alcança quem traduziu o título
• soldCount e repeatRatePct vêm do card e são null quando o 1688 não os exibe — medidos em ~35% e ~81% dos cards
• Use productUrl como chave para abrir cada oferta ou alimentar sua etapa de enriquecimento

Casos de Uso

• Sourcing de Fornecedores — Encontre parceiros industriais para marcas próprias

Perguntas Frequentes

P: A saída traz preço e nome do fornecedor? R: Sim — priceCny e supplier são lidos do card do resultado. MOQ não vem: a página de busca do 1688 não publica pedido mínimo (o marcador 起批 aparece zero vezes nela), então obter MOQ exigiria abrir cada oferta. Um campo que afirmasse o contrário seria inventado.

P: Posso buscar em chinês? R: Sim, e é o recomendado. O 1688 decodifica o termo como GBK, e é assim que este Actor o codifica. Termos latinos também funcionam e passam inalterados.

P: Por que meu run não devolveu ofertas? R: O 1688 lança um desafio de deslize em parte das requisições. Cada run repete até 4 vezes, o que entrega em ~91% dos runs; o restante termina com um registro de diagnóstico e não é cobrado. Repetir o run costuma resolver.

P: Para que serve o maxItems? R: Limita quantas ofertas um run devolve. É o nome que o Actor lê; maxProducts de configurações antigas continua sendo respeitado.

---

💰 Pricing

This actor uses Pay Per Event (PPE) pricing — you pay per product scraped, plus a small Actor-start event. Runs that end with a diagnostic (_dataQuality: "diagnostic") are never charged, so a blocked run costs you nothing.

Apify platform usage (compute units and proxy) is billed to your own account on top of the event price. See the current event names and prices on the Pricing panel of this actor's Apify Store page.

---

🔗 Related Actors

• Reclame Aqui Scraper
• iFood Restaurant Intelligence
• Instagram Reels Scraper
• TikTok Viral Scanner
• Google Maps BR Scraper
• Mercado Livre Scraper

---

📝 Changelog

• v2.3.0 (2026-09-10) — Search terms are now encoded in GBK, the charset 1688 actually decodes. Measured over 6 runs per route: with UTF-8, none of the result pages contained the searched term (a search for bluetooth earphones returned insecticides); with GBK, all 6 did. Affects non-ASCII keywords only. Extractor rewritten against the current card markup: product titles are reassembled from the fragments 1688 splits them into (clean titles went from 51% to 100% of cards), prices keep their decimals, and soldCount coverage went from 2% to 35%. minOrder was removed — it was reporting the supplier's service score from the hover panel, not a minimum order; 1688's search page publishes no MOQ.
• v2.2.1 (2026-08-27) — Docs/schema alignment: the volume limit is maxItems (the name the code reads); maxProducts kept as a legacy alias. Output examples replaced with the fields actually emitted.
• v2.0.0 (2026-08-26) — Data-integrity rewrite: the Actor now contacts 1688 directly and reports a diagnostic when blocked, instead of returning fabricated catalogue data.
• v1.0.0 (2026-08-20) — Initial release

---

License

ISC © 2026 Viral Analyzer Platform

---

💡 Need AI analysis on top of this data — sentiment, trend detection and a dashboard, with no API keys to manage?
ViralAnalyzer runs this actor + 42 more data sources with built-in AI. JSON + insights in one call.