// docs

Temu PLP

Busca produtos da Temu no Brasil, nos Estados Unidos e no Reino Unido por palavra-chave ou URL, com paginação. Custo: 5 créditos por request.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Consulte o schema e a descrição de cada campo para tratar valores ausentes; os exemplos mostram uma resposta possível.

Quando a entidade consultada não existe na origem, o extract e a tool MCP retornam 200 com data: null e notFound: true. Esse caso é tratado como resposta concluída, não como erro de servidor.

Chamada HTTP

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "temu.com",
  "type": "plp",
  "keyword": "Mouse",
  "page": 1
}'

Chamada MCP

A mesma seam também aparece no MCP hospedado como uma tool dedicada. Os argumentos reaproveitam os campos do extract, mas target e type já ficam fixos pela tool.

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

temu_com_plp

Auth

Bearer ou X-API-Key

temu_com_plp tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "temu_com_plp",
    "arguments": {
      "keyword": "Mouse",
      "page": 1,
      "executionId": "exec_example_123"
    }
  }
}

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo	Tipo	Status	Regra	Default	Exemplo
url URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.	string (URL)	Opcional	URL HTTPS da Temu para /search_result.html, /br/search_result.html, /us/search_result.html ou /uk/search_result.html com search_key. Se keyword também for enviada, deve coincidir com search_key.	-	https://www.temu.com/br/search_result.html?search_key=garrafa+de+agua&page=1
keyword Palavra-chave para buscas PLP. Em Google Search ela representa a query enviada ao Google; em Booking PLP é obrigatória; em outros PLPs pode substituir a URL.	string	Condicional	Obrigatória sem URL: de 1 a 200 caracteres. Use region para selecionar o país. Filtros e ordenação não são aceitos.	-	Mouse
region Região da consulta. O formato depende da API; Temu PDP e PLP aceitam br (Brasil), us (Estados Unidos) e uk (Reino Unido), com br como padrão sem país na URL e OLX aceita uma região textual.	string	Opcional	Aceita br (Brasil, BRL), us (Estados Unidos, USD) e uk (Reino Unido, GBP). Sem region, infere o país pelo host ou prefixo /br/, /us/ ou /uk/ da URL; URLs neutras e buscas sem URL usam br. O campo region deve coincidir com o país da URL; conflitos e outros países retornam HTTP 400. Disponibilidade e preços variam por país.	Inferido pela URL; br sem país	us
page Paginacao. Em PLP, inclusive Trivago, e no Reclame AQUI ILP inicia em 1; em review (MercadoLivre, Booking e Hoteis) inicia em 0. O Reclame AQUI ILP aceita ate a pagina 100.	integer	Opcional	Inteiro de 1 a 10; padrão 1. Cada chamada retorna uma página. O campo page tem prioridade sobre a página da URL.	1	1

Exemplos de request

Busca por palavra-chave

Retorna uma página de produtos da Temu no Brasil.

Busca por palavra-chave

{
  "target": "temu.com",
  "type": "plp",
  "keyword": "Mouse",
  "page": 1
}

Próxima página

Mantenha a mesma busca e region e use nextPage da resposta anterior. nextPageUrl também preserva o país.

Próxima página

{
  "target": "temu.com",
  "type": "plp",
  "keyword": "Mouse",
  "page": 2
}

Busca por URL

Aceita search_result.html com search_key; page explícito tem prioridade sobre o parâmetro da URL.

Busca por URL

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

Estados Unidos

Consulta o catálogo dos Estados Unidos; os valores são retornados em USD.

Estados Unidos

{
  "target": "temu.com",
  "type": "plp",
  "region": "us",
  "keyword": "wireless mouse",
  "page": 1
}

Reino Unido

Consulta o catálogo do Reino Unido; os valores são retornados em GBP. Use uk no campo region.

Reino Unido

{
  "target": "temu.com",
  "type": "plp",
  "region": "uk",
  "keyword": "wireless mouse",
  "page": 1
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema

{
  "source": "string",
  "type": "string",
  "url": "string",
  "requestUrl": "string",
  "extractedAt": "string",
  "query": "string",
  "region": "string",
  "totalResults": "number | null",
  "primaryResults": "number",
  "page": "number",
  "resultsPerPage": "number",
  "offset": "number",
  "hasMore": "boolean | null",
  "nextPage": "number | null",
  "nextPageUrl": "string | null",
  "items": "TemuPlpItem[]",
  "items[].position": "number",
  "items[].productId": "string",
  "items[].sku": "string",
  "items[].url": "string",
  "items[].name": "string",
  "items[].mallId": "string | null",
  "items[].currency": "string | null",
  "items[].currencyRaw": "string | null",
  "items[].price": "number | null",
  "items[].priceDisplay": "string | null",
  "items[].regularPrice": "number | null",
  "items[].regularPriceDisplay": "string | null",
  "items[].prices": "object",
  "items[].soldQuantity": "number | null",
  "items[].soldQuantityText": "string | null",
  "items[].aggregateRating.rating": "number | null",
  "items[].aggregateRating.reviewCount": "number | null",
  "items[].thumbnail": "string | null",
  "items[].images": "{ url: string }[]",
  "items[].sponsored": "boolean | null"
}

Exemplo de response

responseExample

{
  "source": "temu.com",
  "type": "plp",
  "url": "https://www.temu.com/br/search_result.html?search_key=Mouse&page=1",
  "requestUrl": "https://www.temu.com/br/search_result.html?search_key=Mouse&page=1",
  "extractedAt": "2026-09-09T23:05:17.585429+00:00",
  "query": "Mouse",
  "region": "br",
  "totalResults": null,
  "primaryResults": 2,
  "page": 1,
  "resultsPerPage": 20,
  "offset": 0,
  "hasMore": true,
  "nextPage": 2,
  "nextPageUrl": "https://www.temu.com/br/search_result.html?search_key=Mouse&page=2",
  "items": [
    {
      "position": 1,
      "productId": "604898057923527",
      "sku": "604898057923527",
      "url": "https://www.temu.com/br/product-g-604898057923527.html",
      "name": "Mouse Gamer Sem Fio para Escritório com Iluminação LED Vermelha, Mouse com Rastreamento, Sem Fio 2.4GHz, Alcance de 10m",
      "mallId": "635517740007167",
      "currency": "BRL",
      "currencyRaw": "R$",
      "price": 15.39,
      "priceDisplay": "R$15,39",
      "regularPrice": 28.63,
      "regularPriceDisplay": "28,63",
      "prices": {
        "price": 1539,
        "price_str": "R$15,39",
        "price_schema": "15.39",
        "market_price": 2863,
        "market_price_str": "28,63",
        "currency": "BRL"
      },
      "soldQuantity": null,
      "soldQuantityText": "2.8K+ vendidos",
      "aggregateRating": {
        "rating": 4.8,
        "reviewCount": 751
      },
      "thumbnail": "https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg",
      "images": [
        {
          "url": "https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg"
        }
      ],
      "sponsored": null
    },
    {
      "position": 2,
      "productId": "604579425058232",
      "sku": "604579425058232",
      "url": "https://www.temu.com/br/product-g-604579425058232.html",
      "name": "Mouse com Fio H'maston MS01, Mouse com Fio Superleve para PC, 1000-1600 DPI para PC",
      "mallId": "635517737924371",
      "currency": "BRL",
      "currencyRaw": "R$",
      "price": 11.71,
      "priceDisplay": "R$11,71",
      "regularPrice": 11.79,
      "regularPriceDisplay": "11,79",
      "prices": {
        "price": 1171,
        "price_str": "R$11,71",
        "price_schema": "11.71",
        "market_price": 1179,
        "market_price_str": "11,79",
        "currency": "BRL"
      },
      "soldQuantity": null,
      "soldQuantityText": "29 vendidos",
      "aggregateRating": {
        "rating": 5,
        "reviewCount": 3
      },
      "thumbnail": "https://img.kwcdn.com/local-image/s132/21137b22512/55d408bd-3e7e-4d33-b8db-eb078598d042_1200x1200.png.format.jpg",
      "images": [
        {
          "url": "https://img.kwcdn.com/local-image/s132/21137b22512/55d408bd-3e7e-4d33-b8db-eb078598d042_1200x1200.png.format.jpg"
        }
      ],
      "sponsored": null
    }
  ]
}

Referência completa de campos

Path	Tipo	Descrição	Exemplo
extractedAt	string	Timestamp ISO-8601 da extração.	2026-09-09T23:05:17.585429+00:00
hasMore	boolean \| null	Indica se a Temu informou haver mais resultados.	true
items	TemuPlpItem[]	Lista normalizada de produtos encontrados na busca.	[{"position":1,"productId":"604898057923527","sku":"604898057923527","url":"https://www.temu.com/br/product-g-604898057923527.html","name":"Mouse Gamer Sem Fio para Escritório com Iluminação LED Vermelha, Mouse com Rastreamento, Sem Fio 2.4GHz, Alcance de 10m","mallId":"635517740007167","currency":"BRL","currencyRaw":"R$","price":15.39,"priceDisplay":"R$15,39","regularPrice":28.63,"regularPriceDisplay":"28,63","prices":{"price":1539,"price_str":"R$15,39","price_schema":"15.39","market_price":2863,"market_price_str":"28,63","currency":"BRL"},"soldQuantity":null,"soldQuantityText":"2.8K+ vendidos","aggregateRating":{"rating":4.8,"reviewCount":751},"thumbnail":"https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg","images":[{"url":"https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg"}],"sponsored":null},{"position":2,"productId":"604579425058232","sku":"604579425058232","url":"https://www.temu.com/br/product-g-604579425058232.html","name":"Mouse com Fio H'maston MS01, Mouse com Fio Superleve para PC, 1000-1600 DPI para PC","mallId":"635517737924371","currency":"BRL","currencyRaw":"R$","price":11.71,"priceDisplay":"R$11,71","regularPrice":11.79,"regularPriceDisplay":"11,79","prices":{"price":1171,"price_str":"R$11,71","price_schema":"11.71","market_price":1179,"market_price_str":"11,79","currency":"BRL"},"soldQuantity":null,"soldQuantityText":"29 vendidos","aggregateRating":{"rating":5,"reviewCount":3},"thumbnail":"https://img.kwcdn.com/local-image/s132/21137b22512/55d408bd-3e7e-4d33-b8db-eb078598d042_1200x1200.png.format.jpg","images":[{"url":"https://img.kwcdn.com/local-image/s132/21137b22512/55d408bd-3e7e-4d33-b8db-eb078598d042_1200x1200.png.format.jpg"}],"sponsored":null}]
items[].aggregateRating.rating	number \| null	Nota média do produto, quando disponível.	4.8
items[].aggregateRating.reviewCount	number \| null	Quantidade exata de avaliações, quando informada.	751
items[].currency	string \| null	Código da moeda informado pela Temu, quando disponível.	BRL
items[].currencyRaw	string \| null	Símbolo da moeda, quando identificado.	R$
items[].images	{ url: string }[]	Imagens presentes nos cartões da busca.	[{"url":"https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg"}]
items[].mallId	string \| null	Identificador da loja, quando informado.	635517740007167
items[].name	string	Título do produto.	Mouse Gamer Sem Fio para Escritório com Iluminação LED Vermelha, Mouse com Rastreamento, Sem Fio 2.4GHz, Alcance de 10m
items[].position	number	Posição do cartão na lista original, incluindo cartões que não representam produtos.	1
items[].price	number \| null	Preço numérico normalizado quando disponível.	15.39
items[].priceDisplay	string \| null	Preço formatado exibido pela Temu.	R$15,39
items[].prices	object	Campos de preço do upstream, sem dados de sessão ou rastreamento.	{"price":1539,"price_str":"R$15,39","price_schema":"15.39","market_price":2863,"market_price_str":"28,63","currency":"BRL"}
items[].productId	string	Identificador do produto na Temu.	604898057923527
items[].regularPrice	number \| null	Preço de referência informado pela Temu, quando disponível; não implica preço de venda anterior.	28.63
items[].regularPriceDisplay	string \| null	Preço de referência formatado informado pela Temu.	28,63
items[].sku	string	Mesmo identificador de productId.	604898057923527
items[].soldQuantity	number \| null	Contagem exata quando informada; não converte textos aproximados como 2.8K+ em contagens exatas.	null
items[].soldQuantityText	string \| null	Texto de vendas exibido pela Temu, quando disponível.	2.8K+ vendidos
items[].sponsored	boolean \| null	true ou false apenas quando o upstream informa o sinal; null quando ausente.	null
items[].thumbnail	string \| null	URL HTTPS da imagem principal, quando disponível.	https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg
items[].url	string	URL pública do produto.	https://www.temu.com/br/product-g-604898057923527.html
nextPage	number \| null	Próxima página disponível, limitada ao intervalo suportado de 1 a 10; null no fim ou ao atingir esse limite.	2
nextPageUrl	string \| null	URL pública da próxima página, que pode ser enviada em uma nova chamada.	https://www.temu.com/br/search_result.html?search_key=Mouse&page=2
offset	number	Posição inicial na lista upstream. Inclui cartões extras e pode não ser igual a (page - 1) × 20.	0
page	number	Página solicitada.	1
primaryResults	number	Quantidade de produtos únicos retornados nesta página. Pode variar em relação ao tamanho solicitado.	2
query	string	Keyword pesquisada.	Mouse
region	string	País consultado: br, us ou uk. Preços em BRL, USD ou GBP, respectivamente.	br
requestUrl	string	Mesmo valor de `url`; nunca expõe o endpoint interno consultado.	https://www.temu.com/br/search_result.html?search_key=Mouse&page=1
resultsPerPage	number	Tamanho de página usado no request upstream.	20
source	string	Fonte da API.	temu.com
totalResults	number \| null	null quando o upstream não informa o total; não é estimado a partir da página.	null
type	string	Tipo de seam extraído.	plp
url	string	URL pública/canônica da busca solicitada.	https://www.temu.com/br/search_result.html?search_key=Mouse&page=1

Erros comuns

Respostas com notFound: true não entram nesta tabela, porque retornam sucesso HTTP 200.

Status	errorCode	Quando acontece
400	INVALID_PAYLOAD	JSON inválido ou violação das regras de validação do payload.
401	UNAUTHORIZED	Header Authorization ausente ou token/chave inválida.
402	INSUFFICIENT_CREDITS	Saldo de créditos insuficiente para a API solicitada.
403	FORBIDDEN	Usuário sem acesso ou API temporariamente desabilitada.
409	EXECUTION_CONFLICT	executionId conflita com uma execução em estado incompatível.
429	RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS	Limite de taxa ou limite de requisições em voo excedido.
5xx	UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR	Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.