CNFans — Taobao Products via Purchase Agent / Produtos do Taobao

English below. Português mais abaixo.

---

English

CNFans is a Chinese "purchase agent" (daigou) platform: it buys on Taobao on behalf of overseas customers and consolidates/ships the parcel. This Actor uses CNFans' own public search API to pull Taobao products directly — original Chinese title, a free English translation (already done by CNFans itself), price in CNY, sales count and minimum order quantity. It's a second, independent China-sourcing source alongside this developer's Yiwugo — Wholesale Products from Yiwu, covering Taobao's much larger and more consumer-oriented catalog instead of Yiwu's small-commodities wholesale market.

As a bonus for Brazilian buyers, it can also translate the (already English) title to Portuguese for free and estimate Brazilian import tax (Remessa Conforme) — see below.

What you get, per product

• id / urlProduto — product identifier and page link (on CNFans)
• titulo — original product name, in Chinese
• tituloIngles — English translation, done for free by CNFans itself
• tituloPt — title translated to Portuguese (free machine translation via MyMemory, see traduzirTitulo in the input)
• precoCny — price in CNY (RMB)
• vendas — accumulated sales count reported by Taobao (often 0 even for popular products — not always populated by the source)
• pedidoMinimoQuantidade — minimum order quantity
• imagemUrl — main product image
• impostoEstimado — estimated Brazilian Import Tax + ICMS (Remessa Conforme regime), only with calcularImposto: true — see dedicated section below

Example output

{
  "termoBuscado": "led lamp",
  "id": "0000K71AUmrqSBWAefuUbbG0_dcFIxY1eOoRl7Lvl2a4X20",
  "titulo": "美的台灯宿舍磁吸灯大学生充电护眼灯学习超长续航酷毙灯阅读灯",
  "tituloIngles": "Midea Desk Lamp Dormitory Magnetic Lamp College Student Rechargeable Eye Protection Lamp Study Ultra-Long Battery Life Cool Lamp Reading Lamp",
  "precoCny": 49,
  "vendas": 0,
  "pedidoMinimoQuantidade": 1,
  "imagemUrl": "https://img.alicdn.com/imgextra/i1/2095418680/O1CN01hEUcf7DVxmG1chua_!!4611686018427383096-0-item_pic.jpg",
  "urlProduto": "https://cnfans.com/product?id=0000K71AUmrqSBWAefuUbbG0_dcFIxY1eOoRl7Lvl2a4X20&platform=TAOBAO",
  "tituloPt": "Lâmpada de mesa Midea Dormitório Lâmpada magnética Estudante universitário Lâmpada de proteção ocular recarregável",
  "impostoEstimado": {
    "quantidadeConsiderada": 1,
    "valorDeclaradoBrl": 37.59,
    "aliquotaIi": 0,
    "ii": 0,
    "icms": 7.70,
    "valorTotalComImpostos": 45.29,
    "cotacaoDolarUsada": 5.1527,
    "cotacaoCnyUsada": 0.767,
    "fonteParametros": "receita_federal_ao_vivo"
  }
}

Input

Field	Required	Description
termosBusca	Yes	List of search terms, in English (CNFans translates from Chinese automatically, and search itself also accepts English). Brand/IP-related terms may be blocked by CNFans itself as "sensitive" — that term simply fails and the Actor moves on to the rest.
maxResultadosPorTermo	No	Max products per term (default 20, max 240 — 20 per page).
paginasPorTermo	No	How many search pages to fetch per term (default 1, max 12).
ordenacao	No	Result order: default (relevance), price_asc or price_desc. Confirmed live that CNFans has no sales/popularity sort on this endpoint — price is the only real sort available.
precoMinCny / precoMaxCny	No	Filters products by price range in CNY. Applied by this Actor (CNFans' API has no server-side price filter on this endpoint) — a product with no numeric price is dropped when either filter is set.
traduzirTitulo	No	Translates the (English) title to Portuguese via MyMemory (free). Default true.
calcularImposto	No	Estimates Brazilian Import Tax + ICMS (Remessa Conforme) for each product found. Default false.

Data source

CNFans' real search API (cnfans.com/search-api/detail/keywords-search-list, platform=TAOBAO) — found via live network inspection of the actual site (Chrome DevTools), confirmed to work over plain HTTP with no browser fingerprint headers, no cookies, no login. Price comes directly in CNY/RMB from Taobao — CNFans' own currency-conversion parameter does not affect this specific search endpoint. Only platform=TAOBAO is supported for keyword search; CNFans returns an explicit "unsupported platforms" error for 1688 or Weidian on this endpoint.

Title translation to Portuguese uses MyMemory (free machine translation, no generative AI, no cost to anyone) — same mechanism as this developer's Yiwugo Actor. It's a shared daily quota across all users of this Actor; if it runs out, tituloPt comes back empty for that item and the search continues normally.

Import tax estimate (Brazil-specific: Remessa Conforme)

Identical calculation to the Yiwugo Actor: Brazil's own Receita Federal formula (Import Tax 0% up to US$50, 60% with a US$30 deduction above that; ICMS "gross-up" style, 17% default), with the two numbers that change most often (the US$50 threshold and the ICMS rate) fetched live from Receita Federal's own public calculator JavaScript on every run, and USD/CNY exchange rates fetched live from the Central Bank of Brazil (PTAX) and a free CNY-BRL rate. Falls back to the last manually-confirmed value if any live lookup fails (see fonteParametros: "fallback").

This is not customs/tax advice. Same caveats as the Yiwugo Actor: the quantity used is the product's minimum order quantity, ICMS varies 17%–20% by state (17% default used here), and freight/clearance fees are not included — declared merchandise value only.

Known limitations

• tituloPt is machine translation of a machine translation (Chinese→English by CNFans, then English→Portuguese by MyMemory) — treat it as a screening aid, not resale-ready copy.
• vendas (sales count) is frequently 0 even for clearly popular products — Taobao/CNFans doesn't always populate it; don't treat it as a reliable popularity signal.
• Search terms tied to trademarks or brand names can be blocked outright by CNFans ("sensitive word") — this is a restriction from the source platform, not a bug in this Actor.
• No supplier vetting — Taobao sellers vary widely in reliability; this is catalog extraction, not due diligence.

Related Actors

From the same developer: Yiwugo — Wholesale Products from Yiwu, China (smaller-commodities wholesale market, a complementary source to this one), SP Alvarás de Obras — Building Permits São Paulo, CRF-SP — Pharmacist License, PROCON-SP — Company Fines, PROCON-PR — Supplier Complaints, ReBEC — Clinical Trials Registry and Curitiba — Business Licenses.

---

Português

CNFans é uma plataforma chinesa de "agente de compras" (daigou): compra no Taobao em nome de clientes de fora da China e consolida/despacha o pacote. Este Actor usa a própria API de busca pública da CNFans pra extrair produtos do Taobao direto: título original em chinês, tradução gratuita pra inglês (já feita pela própria CNFans), preço em CNY, contador de vendas e pedido mínimo. É uma segunda fonte de sourcing chinês, independente do Yiwugo — Produtos do Mercado de Yiwu deste mesmo desenvolvedor, cobrindo o catálogo muito maior e mais voltado a consumidor final do Taobao, em vez do mercado atacadista de pequenos itens de Yiwu.

Como bônus pra comprador brasileiro, também traduz o título (que já vem em inglês) pra português de graça e estima o imposto de importação (Remessa Conforme) — ver abaixo.

O que você recebe, por produto

• id / urlProduto — identificador e link da página do produto (na CNFans)
• titulo — nome original do produto, em chinês
• tituloIngles — tradução pra inglês, feita de graça pela própria CNFans
• tituloPt — título traduzido pra português (tradução automática gratuita via MyMemory, ver traduzirTitulo no input)
• precoCny — preço em CNY (RMB)
• vendas — contador de vendas acumuladas reportado pelo Taobao (frequentemente 0 mesmo pra produto popular — nem sempre preenchido pela fonte)
• pedidoMinimoQuantidade — quantidade mínima de pedido
• imagemUrl — imagem principal do produto
• impostoEstimado — estimativa de Imposto de Importação + ICMS (Remessa Conforme), só com calcularImposto: true — ver seção própria abaixo

Exemplo de saída

{
  "termoBuscado": "led lamp",
  "id": "0000K71AUmrqSBWAefuUbbG0_dcFIxY1eOoRl7Lvl2a4X20",
  "titulo": "美的台灯宿舍磁吸灯大学生充电护眼灯学习超长续航酷毙灯阅读灯",
  "tituloIngles": "Midea Desk Lamp Dormitory Magnetic Lamp College Student Rechargeable Eye Protection Lamp Study Ultra-Long Battery Life Cool Lamp Reading Lamp",
  "precoCny": 49,
  "vendas": 0,
  "pedidoMinimoQuantidade": 1,
  "imagemUrl": "https://img.alicdn.com/imgextra/i1/2095418680/O1CN01hEUcf7DVxmG1chua_!!4611686018427383096-0-item_pic.jpg",
  "urlProduto": "https://cnfans.com/product?id=0000K71AUmrqSBWAefuUbbG0_dcFIxY1eOoRl7Lvl2a4X20&platform=TAOBAO",
  "tituloPt": "Lâmpada de mesa Midea Dormitório Lâmpada magnética Estudante universitário Lâmpada de proteção ocular recarregável",
  "impostoEstimado": {
    "quantidadeConsiderada": 1,
    "valorDeclaradoBrl": 37.59,
    "aliquotaIi": 0,
    "ii": 0,
    "icms": 7.70,
    "valorTotalComImpostos": 45.29,
    "cotacaoDolarUsada": 5.1527,
    "cotacaoCnyUsada": 0.767,
    "fonteParametros": "receita_federal_ao_vivo"
  }
}

Input

Campo	Obrigatório	Descrição
termosBusca	Sim	Lista de termos de busca, em inglês (a CNFans traduz do chinês automaticamente, e a busca também aceita inglês). Termos ligados a marca/propriedade intelectual podem ser bloqueados pela própria CNFans ("sensitive word") — o termo simplesmente falha e o Actor segue pros outros.
maxResultadosPorTermo	Não	Máximo de produtos por termo (padrão 20, máx. 240 — 20 por página).
paginasPorTermo	Não	Quantas páginas de busca varrer por termo (padrão 1, máx. 12).
ordenacao	Não	Ordem dos resultados: default (relevância), price_asc ou price_desc. Confirmado ao vivo que a CNFans não tem ordenação por vendas/popularidade nesse endpoint — só existe ordenação por preço.
precoMinCny / precoMaxCny	Não	Filtra produtos por faixa de preço em CNY. Filtro feito por este Actor (a API da CNFans não tem filtro de preço no servidor nesse endpoint) — produto sem preço numérico é descartado quando algum desses filtros está ativo.
traduzirTitulo	Não	Traduz o título (já em inglês) pra português via MyMemory (grátis). Padrão true.
calcularImposto	Não	Estima Imposto de Importação + ICMS (Remessa Conforme) pra cada produto encontrado. Padrão false.

Fonte dos dados

API real de busca da CNFans (cnfans.com/search-api/detail/keywords-search-list, platform=TAOBAO) — achada por inspeção de rede ao vivo no site de verdade (Chrome DevTools), confirmada funcionando por HTTP puro, sem headers de fingerprint do navegador, sem cookie, sem login. O preço já vem em CNY/RMB direto do Taobao — o parâmetro de conversão de moeda da própria CNFans não afeta esse endpoint específico de busca. Só platform=TAOBAO funciona pra busca por palavra-chave; a CNFans devolve erro explícito ("unsupported platforms") pra 1688 ou Weidian nesse endpoint.

A tradução do título pra português usa a MyMemory (tradução automática gratuita, sem IA generativa, sem custo pra ninguém) — mesmo mecanismo do Actor Yiwugo deste desenvolvedor. É uma cota diária compartilhada entre todos os usuários deste Actor; se estourar, tituloPt vem vazio nesse item e a busca continua normal.

Cálculo de imposto (Remessa Conforme)

Cálculo idêntico ao do Actor Yiwugo: fórmula da própria Receita Federal (Imposto de Importação 0% até US$50, 60% com desconto de US$30 acima disso; ICMS "por dentro", padrão 17%), com os dois números que mais mudam (limite de US$50 e alíquota de ICMS) buscados ao vivo do próprio JavaScript público da calculadora da Receita Federal a cada execução, e cotação de dólar/yuan buscada ao vivo (Banco Central, PTAX oficial, e uma cotação CNY-BRL gratuita). Cai pro último valor confirmado manualmente se alguma busca ao vivo falhar (ver fonteParametros: "fallback").

Isto não é aconselhamento aduaneiro. Mesmas ressalvas do Actor Yiwugo: a quantidade considerada é o pedido mínimo do produto, o ICMS varia de 17% a 20% conforme o estado (usamos 17% como padrão), e não inclui frete internacional nem taxa de despacho — só o valor declarado da mercadoria.

Limitações conhecidas

• tituloPt é tradução automática de uma tradução automática (chinês→ inglês pela CNFans, depois inglês→português pela MyMemory) — trate como apoio pra triagem, não como texto pronto pra revenda.
• vendas (contador de vendas) frequentemente vem 0 mesmo pra produto claramente popular — Taobao/CNFans nem sempre preenche esse dado; não trate como sinal confiável de popularidade.
• Termos de busca ligados a marca registrada podem ser bloqueados diretamente pela CNFans ("sensitive word") — é restrição da própria plataforma de origem, não bug deste Actor.
• Sem verificação de idoneidade de vendedor — vendedores do Taobao variam muito em confiabilidade; isto é extração de catálogo, não due diligence.

Actors relacionados

Do mesmo desenvolvedor: Yiwugo — Produtos do Mercado de Yiwu (mercado atacadista de itens pequenos, fonte complementar a este), SP Alvarás de Obras — Building Permits São Paulo, CRF-SP — Consulta de Farmacêutico, PROCON-SP — Empresas Autuadas, PROCON-PR — Reclamações contra Fornecedor, ReBEC — Ensaios Clínicos e Curitiba — Alvarás Comerciais.