API Temu: extraia produtos, preços e buscas no Brasil, EUA e Reino Unido

Uma API Temu é útil quando sua operação precisa transformar o catálogo público do marketplace em dados que possam ser pesquisados, comparados e armazenados. Com a GeckoAPI, você consulta buscas e páginas de produto da Temu por HTTP e recebe JSON estruturado para usar em pricing, pesquisa de sortimento, enriquecimento de catálogo, dashboards e automações.

O conector da GeckoAPI cobre três contextos de catálogo: Brasil (br, BRL), Estados Unidos (us, USD) e Reino Unido (uk, GBP). Isso permite investigar a mesma categoria em mercados diferentes, desde que cada coleta preserve a região e a moeda retornadas. Preço, disponibilidade e oferta podem variar entre países; uma comparação internacional séria deve registrar esse contexto em cada snapshot.

Neste guia, você verá como usar a API de produtos Temu para pesquisar listagens, consultar detalhes de um item, percorrer páginas, organizar os campos retornados e criar uma rotina de monitoramento. Abra a página da API Temu para ver a visão geral ou use a documentação Temu PLP e a documentação Temu PDP como referência técnica do contrato.

O que a API Temu da GeckoAPI faz

A GeckoAPI oferece dois tipos de extração para a Temu. Ambos usam o mesmo endpoint e a mesma autenticação Bearer; o que muda é o type enviado no corpo da requisição.

Extração	`type`	Entrada	Melhor uso
Busca e listagem	`plp`	Palavra-chave ou URL pública de busca	Descobrir produtos, preços, posições e sinais disponíveis na busca
Página de produto	`pdp`	URL pública do produto	Consultar preço, faixa de preço, variações, frete, seller, estoque e avaliações

PLP significa Product Listing Page: a listagem que aparece ao pesquisar uma palavra-chave. PDP significa Product Detail Page: a página detalhada de um produto.

Em uma rotina de dados, a combinação costuma ser:

keyword por país
  -> Temu PLP
  -> filtro e deduplicação dos resultados
  -> Temu PDP das URLs prioritárias
  -> snapshot no banco
  -> alertas, dashboard, análise ou automação

A PLP funciona como radar do mercado. A PDP adiciona profundidade aos itens relevantes. Consultar só PDP dificulta descobrir novos concorrentes; consultar só PLP pode deixar de fora atributos e variações que aparecem no detalhe do produto.

Esta é uma integração da GeckoAPI para dados de páginas públicas e não uma API de operação de conta da Temu. A GeckoAPI é independente e não é afiliada, patrocinada ou endossada pela Temu.

Países, regiões e moedas suportados na API Temu

A região é parte da consulta. Use region quando a busca for por palavra-chave ou quando quiser deixar o país explícito no request. Em URLs regionais, o país também pode ser identificado pelo prefixo da própria URL.

Região no request	Mercado	Moeda retornada	Exemplo de URL regional
`br`	Brasil	`BRL`	`https://www.temu.com/br/...`
`us`	Estados Unidos	`USD`	`https://www.temu.com/us/...`
`uk`	Reino Unido	`GBP`	`https://www.temu.com/uk/...`

Sem region, a GeckoAPI infere o país a partir do host ou do prefixo /br/, /us/ ou /uk/ da URL. Uma URL neutra ou uma busca somente por keyword usa Brasil (br) como padrão.

O valor de region precisa coincidir com o país da URL. Por exemplo, não envie uma URL /us/ com region: "br": o contrato rejeita conflitos de região com HTTP 400. Outros países também não fazem parte deste conector no momento.

Para análise internacional, não converta tudo para uma única moeda e descarte o original. Armazene ao menos region, currency, price, priceDisplay, URL e o horário da extração. Assim, uma mudança de preço em dólares não será confundida com uma mudança em reais, e os dados permanecem auditáveis.

Faça a primeira busca de produtos da Temu por API

O endpoint é:

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

Crie uma chave no dashboard da GeckoAPI e mantenha-a apenas no seu backend ou em variáveis de ambiente. Não exponha a chave em JavaScript entregue ao navegador, repositórios públicos ou logs.

O exemplo abaixo busca a primeira página de wireless mouse no catálogo dos Estados Unidos:

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": "us",
    "keyword": "wireless mouse",
    "page": 1
  }'

Para consultar o Brasil, troque a busca e use region: "br" — ou omita region em uma busca por palavra-chave, pois br é o padrão. Para o Reino Unido, use region: "uk".

Parâmetros da Temu PLP

Campo	Como usar
`target`	Use sempre `"temu.com"`.
`type`	Use `"plp"` para busca e listagem.
`keyword`	Obrigatória quando não há URL. Aceita de 1 a 200 caracteres.
`url`	Alternativa à keyword: URL HTTPS de `search_result.html` com `search_key`.
`region`	Opcional: `br`, `us` ou `uk`. Deve coincidir com a URL regional, quando houver URL.
`page`	Opcional, de 1 a 10. O padrão é 1 e cada chamada retorna uma página.

A busca por URL é útil quando seu sistema já armazena uma página Temu pública, como:

{
  "target": "temu.com",
  "type": "plp",
  "url": "https://www.temu.com/br/search_result.html?search_key=garrafa+de+agua&page=1"
}

Se você enviar page no corpo, ele tem prioridade sobre o número de página que estiver na URL. Se enviar keyword e url juntas, a palavra-chave precisa coincidir com search_key da URL. O conector não aceita filtros nem ordenação como parâmetros de entrada; aplique seus critérios ao JSON retornado pelo seu sistema.

Quais dados a busca de produtos retorna

A API de busca Temu entrega metadados da pesquisa e uma coleção de itens. Alguns campos são nulos quando a origem não os exibe para uma oferta específica, por isso seu modelo deve tratar os campos opcionais como opcionais.

Grupo	Campos úteis	Uso no produto
Contexto da consulta	`query`, `region`, `page`, `resultsPerPage`, `extractedAt`	Reproduzir e auditar a coleta
Paginação	`hasMore`, `nextPage`, `nextPageUrl`	Decidir se a rotina deve consultar outra página
Identificação	`items[].productId`, `items[].sku`, `items[].url`, `items[].position`	Deduplicar e registrar a posição observada
Preço	`price`, `priceDisplay`, `regularPrice`, `prices`	Comparar oferta atual e preço de referência quando disponível
Tração	`soldQuantity`, `soldQuantityText`, `aggregateRating`	Priorizar itens para análise, sem inferir faturamento ou período
Mídia e contexto	`thumbnail`, `images`, `sponsored`	Criar cartões, revisar resultados e separar o contexto exibido

Um recorte ilustrativo da resposta tem esta forma:

{
  "requestId": "11111111-1111-4111-8111-111111111111",
  "executionId": "22222222-2222-4222-8222-222222222222",
  "data": {
    "query": "wireless mouse",
    "region": "us",
    "page": 1,
    "hasMore": true,
    "nextPage": 2,
    "items": [
      {
        "position": 1,
        "productId": "601234567890123",
        "sku": "AB123456",
        "url": "https://www.temu.com/us/product-g-601234567890123.html",
        "name": "Wireless ergonomic mouse",
        "currency": "USD",
        "price": 19.99,
        "priceDisplay": "$19.99",
        "regularPrice": 29.99,
        "soldQuantity": 1200,
        "aggregateRating": {
          "rating": 4.7,
          "reviewCount": 156
        },
        "sponsored": false
      }
    ]
  }
}

Os IDs e valores do exemplo são ilustrativos. Em produção, guarde requestId e executionId junto do snapshot para rastrear uma execução específica. totalResults, hasMore e nextPage podem ser nulos, portanto uma rotina não deve presumir que sempre haverá continuação.

Como percorrer as páginas de uma busca Temu

Cada chamada PLP consulta uma página. Comece com page: 1 e use nextPage somente quando hasMore for verdadeiro e o próximo valor estiver entre 1 e 10.

Este exemplo em JavaScript consulta até três páginas do Reino Unido, preserva a região e evita incluir o mesmo produto duas vezes na mesma execução:

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

const keyword = "wireless mouse";
const region = "uk";
const maxPages = 3;
const productsById = new Map();
let page = 1;

for (let request = 0; request < maxPages; 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,
      keyword,
      page,
    }),
    signal: AbortSignal.timeout(120_000),
  });

  if (!response.ok) {
    throw new Error(`Falha na página ${page}: HTTP ${response.status}`);
  }

  const { data } = await response.json();
  for (const item of data.items) {
    if (!productsById.has(item.productId)) {
      productsById.set(item.productId, {
        ...item,
        query: data.query,
        region: data.region,
        extractedAt: data.extractedAt,
      });
    }
  }

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

console.log(JSON.stringify([...productsById.values()], null, 2));

O limite de páginas é 10. Faça poucas consultas adicionais e pare quando a resposta indicar que não há continuação. Uma busca que acaba na primeira página não precisa consumir crédito em páginas inexistentes.

Consulte uma página de produto com Temu PDP

Depois de selecionar produtos na busca, use type: "pdp" para aprofundar uma URL. O Temu PDP aceita URLs HTTPS com product-g-<id> ou a URL desktop goods.html?goods_id=<id>.

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": "uk",
    "url": "https://www.temu.com/uk/product-g-606858391703781.html"
  }'

O region é opcional quando a URL já identifica o país, mas deixá-lo explícito ajuda a validar a sua pipeline. Uma URL neutra usa Brasil como padrão. Nunca reaproveite uma URL de um país com a região de outro.

Dados disponíveis no detalhe do produto

A PDP tem uma visão mais completa do item que a listagem. Conforme a disponibilidade dos dados na página consultada, a resposta pode incluir:

Área	Campos para considerar
Produto	`productId`, `itemId`, `name`, `description`, `canonicalUrl`, imagens e especificações
Oferta	`price`, `priceDisplay`, `prices.min`, `prices.max`, `availability`, `stock`, `status`
Variações	`variants[].skuId`, `variants[].specs`, `variants[].price`, `variants[].stockQuantity`
Logística	`shipping.text`, `shipping.promiseText`, empresas e intervalo de dias quando exposto
Seller e reputação	`seller.mallId`, `seller.name`, `review.rating`, `review.reviewCount`
Sinais de demanda	`soldQuantity`, `soldQuantityText`

Em produtos com faixa de preço, use os valores mínimo e máximo ao invés de escolher arbitrariamente uma variação. Quando a análise exigir uma opção específica de cor, tamanho ou kit, associe o preço a variants[].specs e ao identificador daquela variante.

Também trate estoque, frete, avaliações e contagens de vendas como dados observados naquele momento e região. Eles podem mudar com a localização, a variante selecionada ou uma atualização da oferta.

Use casos para dados da Temu

Monitoramento de preços e oferta internacional

Você pode acompanhar uma lista de keywords por país, salvar as listagens da Temu e consultar PDP apenas para os produtos que atendem a uma regra. Por exemplo: pesquisar organizer box nos EUA, no Reino Unido e no Brasil, filtrar os itens que se encaixam na categoria e registrar preço, moeda, seller, posição, avaliações e horário.

Um alerta útil compara snapshots equivalentes: mesmo productId, mesma region e mesma variante, quando aplicável. Não compare diretamente um preço em BRL com outro em USD sem uma regra cambial explícita e sem considerar frete, promoção e disponibilidade.

Para um processo mais amplo, combine a Temu com as APIs de AliExpress, Shopee, Amazon e Mercado Livre. O guia de monitoramento de preços de concorrentes mostra como separar descoberta por PLP de enriquecimento por PDP.

Pesquisa de sortimento e catálogo

Uma busca de produtos Temu pode revelar o conjunto de ofertas visíveis para uma keyword. Organize os itens por preço, sinal de avaliações, quantidade vendida quando disponível, posição e categoria inferida por sua regra interna. Em seguida, selecione URLs para PDP e obtenha imagens, descrições, especificações e variações para revisar o sortimento com mais contexto.

Isso é útil para pesquisa de mercado, curadoria de catálogo e preparação de dados para o time comercial. O resultado da API é matéria-prima para a sua análise: ele não substitui a validação de equivalência entre produtos de marcas, capacidades ou variações diferentes.

Enriquecimento de catálogo e matching

Se sua base já conhece um produto, a PDP ajuda a anexar dados públicos como título, imagens, atributos, faixa de preço e variações. Para relacionar esse registro com outro marketplace, use mais de um sinal: modelo, marca quando disponível, medidas, quantidade, versão e atributos de variante. Título sozinho gera falsos positivos com facilidade.

Mantenha a URL original e a canonicalUrl quando vierem no retorno. Isso melhora a auditoria e permite voltar à fonte ao investigar uma mudança no matching.

Dashboards, ETLs e agentes de IA

Como o formato é JSON, a resposta pode entrar em um ETL, banco relacional, data warehouse ou ferramenta de automação. Uma tabela de snapshots simples pode conter:

{
  "source": "temu.com",
  "region": "us",
  "currency": "USD",
  "query": "wireless mouse",
  "productId": "601234567890123",
  "url": "https://www.temu.com/us/product-g-601234567890123.html",
  "price": 19.99,
  "sellerName": "Loja Exemplo",
  "rating": 4.7,
  "reviewCount": 156,
  "collectedAt": "2026-09-14T12:00:00.000Z"
}

Seu dashboard pode calcular variação de preço, presença por keyword e frequência de sellers a partir dessas capturas. Um agente de IA pode receber apenas os campos relevantes e a data de extração para responder perguntas como “quais mouses sem fio apareceram hoje no catálogo do Reino Unido?”. O agente deve trabalhar com o resultado da consulta, e não apresentar dados observados em outro país como se fossem locais.

Quanto custa a API Temu

As extrações Temu PLP e Temu PDP custam 5 créditos por request. Uma página de busca é uma requisição; cada URL de produto consultada é outra.

Rotina	Requests	Créditos
Uma keyword, primeira página PLP	1	5
A mesma keyword em Brasil, EUA e Reino Unido	3	15
Uma PLP e cinco páginas de produto priorizadas	6	30
Três páginas PLP e dez PDPs	13	65

Comece com um piloto: escolha poucas keywords, rode em uma frequência razoável, meça a quantidade de itens úteis e só então aumente páginas ou PDPs. Isso reduz chamadas redundantes e facilita dimensionar o orçamento. Consulte a documentação Temu PLP, a documentação Temu PDP e os planos da GeckoAPI antes de escalar a rotina.

Boas práticas para uma integração Temu confiável

Guarde a região e a moeda. br, us e uk descrevem contextos de catálogo distintos.
Use PLP antes de PDP. Descubra ofertas por keyword e aprofunde somente as URLs que atendem à sua regra.
Preserve snapshots. Insira uma nova captura com timestamp em vez de sobrescrever o preço anterior.
Modele nulos. Nem toda oferta exibe preço de referência, estoque, avaliações, seller ou continuação de página.
Deduplicate por identificador e contexto. Combine productId, região e, quando necessário, SKU ou variante.
Pare a paginação corretamente. Use hasMore e nextPage; não ultrapasse a página 10.
Proteja a chave. Faça a chamada no servidor e use retentativas limitadas para falhas transitórias. Requests inválidos ou conflitos de país exigem correção da entrada, não repetição automática.
Use dados públicos de forma responsável. Respeite a legislação aplicável, os termos relevantes e as regras do seu caso de uso. Veja a página de uso responsável da GeckoAPI.

Perguntas frequentes sobre a API Temu

Como buscar produtos da Temu por API?

Envie um POST para https://api.geckoapi.com.br/v1/extract com a chave Bearer, target: "temu.com", type: "plp", uma keyword ou URL de busca e, opcionalmente, region e page. Os resultados chegam em data.items.

Quais países a API Temu suporta?

O conector atual suporta Brasil (br, BRL), Estados Unidos (us, USD) e Reino Unido (uk, GBP). A região pode ser indicada no corpo ou inferida da URL regional. Buscas sem país usam Brasil como padrão.

Posso consultar uma página de produto Temu?

Sim. Use target: "temu.com", type: "pdp" e uma URL pública HTTPS com product-g-<id> ou goods.html?goods_id=<id>. O detalhe pode retornar preço, faixa de preço, variações, frete, seller, estoque, imagens e avaliações conforme a página expõe esses dados.

A API Temu aceita paginação?

Sim, na extração PLP. Informe page de 1 a 10. Após cada resposta, continue somente quando hasMore estiver verdadeiro e nextPage contiver um valor válido.

Qual é o custo de uma consulta Temu?

Cada request Temu PLP ou PDP custa 5 créditos. Uma rotina com duas páginas de busca e quatro produtos em detalhe realiza seis requests e consome 30 créditos.

Posso usar a API para monitorar preços da Temu?

Sim. Agende buscas e PDPs, salve cada resultado com region, moeda, produto, preço, variante e horário de extração, e compare snapshots equivalentes. Para uma leitura comercial confiável, considere também disponibilidade, frete e promoção quando esses dados estiverem presentes.

Teste a API Temu da GeckoAPI

Comece com uma keyword e uma região, confira o JSON recebido e escolha os campos que representam a sua regra de negócio. Depois, adicione as páginas e PDPs necessários para criar um histórico ou uma automação.

Abra a API Temu para conhecer os casos de uso, acesse a documentação da busca Temu para o contrato completo ou crie sua conta na GeckoAPI para testar a integração.