Scraper Temu: extraia produtos e preços via API

Um scraper Temu transforma páginas públicas de busca e de produto da Temu em dados estruturados para análise. Em vez de copiar preços, avaliações e informações de sellers manualmente, sua aplicação envia uma palavra-chave ou URL e recebe JSON pronto para alimentar um banco, planilha, dashboard, ETL ou agente de IA.

O desafio não é apenas “ler uma página”. Catálogos, moedas, disponibilidade e ofertas mudam conforme o país; páginas de listagem e páginas de produto também têm dados diferentes. Um bom scraper da Temu precisa preservar esse contexto, lidar com paginação, modelar campos ausentes e manter uma saída estável mesmo quando a apresentação do site muda.

Neste guia, você verá como usar o scraper Temu da GeckoAPI para pesquisar produtos e consultar detalhes no Brasil, nos Estados Unidos e no Reino Unido. A integração cobre busca (PLP) e produto (PDP), custa 5 créditos por request e devolve dados normalizados sem exigir que você mantenha navegador headless, rotação de proxy ou parser próprio.

A GeckoAPI é uma plataforma independente para extração de dados de páginas públicas. Não é afiliada, patrocinada ou endossada pela Temu.

O que é um scraper Temu?

Um scraper Temu, também chamado de Temu scraper, web scraper da Temu, crawler ou raspador Temu, automatiza a coleta de informações exibidas no marketplace. O objetivo é converter uma interface feita para navegação humana em registros que um software consiga consultar, armazenar e comparar.

Há dois pontos de entrada principais:

Página	Tipo na GeckoAPI	Entrada	Uso recomendado
Busca ou listagem	`plp`	Palavra-chave ou URL de busca	Descobrir produtos, preços, posições e sinais de demanda
Detalhe do produto	`pdp`	URL pública do produto	Obter variações, seller, frete, estoque, especificações e avaliações

PLP significa Product Listing Page e PDP, Product Detail Page. Na prática, a PLP encontra oportunidades e a PDP aprofunda os produtos selecionados.

Uma pipeline comum segue este fluxo:

keyword + região
  → scraper Temu PLP
  → produtos normalizados
  → filtro e deduplicação
  → scraper Temu PDP das URLs prioritárias
  → snapshots no banco
  → alertas, dashboards ou automações

Essa separação evita consultar centenas de PDPs sem critério. Primeiro você descobre o catálogo relevante; depois investe chamadas nos itens que realmente importam para sua análise.

Quais dados o scraper Temu extrai?

O retorno depende do tipo de página e do que a origem exibe naquele momento. Na busca, o scraping Temu pode retornar:

nome, URL, productId, SKU e posição do produto;
preço atual, preço de referência e moeda;
imagem principal e outras imagens do cartão;
avaliação média e número de reviews, quando disponíveis;
quantidade vendida ou texto aproximado de vendas;
seller (mallId) e indicação de anúncio, quando informados;
contexto da consulta, página, região e timestamp da extração.

No detalhe do produto, a resposta pode acrescentar descrição, imagens, especificações, faixa de preço, disponibilidade, estoque, dados do seller, frete, avaliações e combinações de variantes com seus respectivos SKUs.

Campos opcionais podem ser null. Isso é importante: ausência de um valor não significa preço zero, estoque esgotado ou avaliação negativa. Seu modelo deve preservar a diferença entre “não informado” e um valor conhecido.

Scraper Temu por API ou automação própria?

É possível construir um crawler Temu com Playwright, Puppeteer ou Selenium. Essa abordagem dá controle total sobre navegação e parsing, mas também transfere toda a manutenção para sua equipe. Você precisa operar o navegador, controlar concorrência e timeouts, revisar seletores, normalizar moedas, detectar respostas incompletas e acompanhar mudanças de layout.

Uma API de scraper gerenciado troca essa infraestrutura por um contrato de dados:

Critério	Scraper próprio	Scraper Temu via GeckoAPI
Saída	HTML ou dados definidos por você	JSON normalizado
Navegador e proxy	Sua equipe mantém	Gerenciados pela API
Mudanças na origem	Exigem correção do parser	Absorvidas no conector
Busca e produto	Fluxos separados por você	PLP e PDP no mesmo endpoint
Regiões	Exigem controle geográfico	`br`, `us` e `uk` explícitos
Custo operacional	Infraestrutura + engenharia	5 créditos por chamada

O scraper próprio pode fazer sentido quando a extração exige uma interação exclusiva que uma API não oferece. Para monitoramento de produtos, pesquisa de catálogo e integração de dados, a saída estruturada costuma reduzir o tempo até a primeira análise e o custo de manutenção.

Como usar o scraper Temu da GeckoAPI

Todas as consultas usam este endpoint:

POST https://api.geckoapi.com.br/v1/extract

Crie uma chave no dashboard da GeckoAPI e envie-a no header Authorization. Mantenha a chave no backend ou em uma variável de ambiente; nunca a publique em JavaScript do navegador, logs ou repositórios.

1. Pesquise produtos da Temu por palavra-chave

O exemplo abaixo executa uma busca no catálogo brasileiro:

curl --fail-with-body --max-time 120 \
  --request POST 'https://api.geckoapi.com.br/v1/extract' \
  --header "Authorization: Bearer ${GECKOAPI_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "target": "temu.com",
    "type": "plp",
    "region": "br",
    "keyword": "mouse sem fio",
    "page": 1
  }'

Na PLP, keyword é obrigatória quando você não envia uma URL. Ela aceita de 1 a 200 caracteres. page aceita inteiros positivos, sem limite fixo de páginas, e cada request retorna uma página. Páginas distantes podem exceder o tempo limite da chamada. Também é possível passar uma URL pública search_result.html que contenha search_key.

Um retorno resumido segue este formato:

{
  "requestId": "11111111-1111-4111-8111-111111111111",
  "data": {
    "query": "mouse sem fio",
    "region": "br",
    "page": 1,
    "hasMore": true,
    "nextPage": 2,
    "items": [
      {
        "position": 1,
        "productId": "604898057923527",
        "name": "Mouse sem fio",
        "currency": "BRL",
        "price": 15.39,
        "priceDisplay": "R$15,39",
        "aggregateRating": {
          "rating": 4.8,
          "reviewCount": 751
        }
      }
    ]
  }
}

O exemplo é ilustrativo. Em produção, armazene também a URL, o horário de extração, requestId e executionId para rastrear cada coleta.

2. Consulte a página de um produto

Depois de escolher uma URL da busca, use type: "pdp":

curl --fail-with-body --max-time 120 \
  --request POST 'https://api.geckoapi.com.br/v1/extract' \
  --header "Authorization: Bearer ${GECKOAPI_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "target": "temu.com",
    "type": "pdp",
    "region": "br",
    "url": "https://www.temu.com/br/product-g-604898057923527.html"
  }'

O scraper de produto aceita URLs HTTPS com product-g-<id> e também goods.html?goods_id=<id>. Use a PDP quando precisar associar preço a uma variante, consultar especificações ou enriquecer os cartões encontrados na busca.

3. Percorra os resultados sem duplicar produtos

Use hasMore e nextPage em vez de presumir que toda busca tem dez páginas. O código a seguir consulta até três páginas e deduplica por productId:

const apiKey = process.env.GECKOAPI_KEY;
if (!apiKey) throw new Error("Configure GECKOAPI_KEY.");

const products = new Map();
let page = 1;

for (let request = 0; request < 3; request += 1) {
  const response = await fetch("https://api.geckoapi.com.br/v1/extract", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      target: "temu.com",
      type: "plp",
      region: "br",
      keyword: "mouse sem fio",
      page,
    }),
    signal: AbortSignal.timeout(120_000),
  });

  if (!response.ok) throw new Error(`HTTP ${response.status}`);

  const { data } = await response.json();
  for (const item of data.items) products.set(item.productId, item);

  if (!data.hasMore || !Number.isInteger(data.nextPage)) break;
  if (data.nextPage <= page || data.nextPage > 10) break;
  page = data.nextPage;
}

console.log([...products.values()]);

Para coletas recorrentes, aplique limite de concorrência e retentativas com backoff apenas para falhas transitórias. Um HTTP 400 por URL ou região inválida deve ser corrigido, não repetido.

Scraping Temu no Brasil, EUA e Reino Unido

A região não é um detalhe decorativo. Ela define o contexto do catálogo e a moeda retornada:

`region`	Mercado	Moeda
`br`	Brasil	BRL
`us`	Estados Unidos	USD
`uk`	Reino Unido	GBP

Sem region, o conector tenta inferir o país pelo prefixo da URL. URLs neutras e buscas apenas por keyword usam o Brasil como padrão. A região precisa coincidir com a URL: uma URL /us/ com region: "br" é rejeitada.

Para comparar países, salve sempre region, currency, preço original, URL e timestamp. Não compare R$ 50 com US$ 50 como se fossem o mesmo valor e não descarte a moeda depois de uma conversão cambial.

Casos de uso para dados da Temu

Monitoramento de preços

Agende o scraper Temu para salvar snapshots do mesmo productId, região e variante. Compare capturas equivalentes e considere preço, disponibilidade, seller, frete e promoção antes de disparar um alerta. Isso ajuda equipes de pricing e inteligência de mercado a acompanhar mudanças sem revisão manual.

Pesquisa de produtos e sortimento

Pesquise categorias ou termos de interesse, ordene o retorno por regras próprias e envie apenas os itens selecionados para PDP. Posição, avaliações e texto de vendas são sinais úteis para priorização, mas não devem ser tratados isoladamente como prova de demanda ou faturamento.

Enriquecimento e matching de catálogo

Use nome, imagem, especificações, medidas, modelo e variante para relacionar um item a registros internos ou a outros marketplaces. Título sozinho produz muitos falsos positivos. Preserve a URL de origem e os identificadores para revisar o matching depois.

Dashboards, planilhas e agentes de IA

O JSON pode alimentar PostgreSQL, BigQuery, planilhas, ferramentas de automação ou um agente conectado por API. Inclua o timestamp nos dados apresentados ao usuário para deixar claro quando preço e disponibilidade foram observados.

Para comparar outras fontes, combine esta integração com as APIs de Shopee, AliExpress, Amazon e Mercado Livre.

Boas práticas para um scraper da Temu confiável

Comece pela PLP. Descubra produtos antes de consumir chamadas de detalhe.
Preserve país e moeda. Eles fazem parte da identidade comercial do snapshot.
Modele valores nulos. “Ausente” não é sinônimo de zero ou indisponível.
Salve histórico. Não sobrescreva o preço anterior se o objetivo é monitorar mudanças.
Deduplicate por contexto. Combine produto, região e SKU quando houver variante.
Limite a paginação. Continue apenas com hasMore e nextPage válidos.
Proteja a credencial. Chame a API no servidor e não exponha a chave no cliente.
Use os dados com responsabilidade. Respeite a legislação, os termos aplicáveis e uma frequência proporcional ao caso de uso. Consulte a página de uso responsável.

Perguntas frequentes sobre scraper Temu

Como criar um scraper Temu?

Você pode manter um navegador automatizado e um parser próprios ou usar uma API gerenciada. Com a GeckoAPI, envie target: "temu.com" e type: "plp" para busca, ou type: "pdp" com uma URL de produto. A resposta chega em JSON estruturado.

O scraper Temu extrai preços e avaliações?

Sim. A PLP pode retornar preço, moeda, preço de referência, avaliação, contagem de reviews e texto de vendas quando esses dados aparecem na origem. A PDP acrescenta detalhes como variações, seller, estoque, frete e especificações conforme disponíveis.

É possível fazer scraping da Temu por palavra-chave?

Sim. Envie uma keyword, region e page em uma consulta PLP. A palavra-chave aceita até 200 caracteres e a paginação suportada vai da página 1 à 10.

Quais países o Temu scraper suporta?

O conector da GeckoAPI suporta Brasil (br, BRL), Estados Unidos (us, USD) e Reino Unido (uk, GBP). Preços e disponibilidade podem variar entre esses catálogos.

Quanto custa usar o scraper Temu?

Cada request Temu PLP ou PDP custa 5 créditos. Uma busca de uma página seguida pela consulta de quatro produtos realiza cinco requests e consome 25 créditos.

Preciso configurar proxy ou Selenium?

Não ao usar a GeckoAPI. Você envia a busca ou URL por HTTP e recebe JSON. A infraestrutura de extração e a normalização são gerenciadas pelo serviço.

Posso exportar os dados para Excel ou CSV?

Sim. A API retorna JSON, que pode ser transformado em CSV ou XLSX pela sua aplicação, ferramenta de ETL ou automação. Preserve objetos aninhados, como variantes e avaliações, em tabelas relacionadas ou colunas JSON.

Teste o scraper Temu

Comece com uma palavra-chave, uma região e a primeira página. Valide os campos retornados, selecione algumas URLs para PDP e só então aumente a frequência ou o volume da coleta.

Veja a página da API Temu, consulte a documentação Temu PLP e a documentação Temu PDP ou crie uma conta na GeckoAPI para testar o scraper Temu com créditos iniciais gratuitos.