// docs

Temu PDP

Extrai dados de produtos da Temu no Brasil, nos Estados Unidos, no Reino Unido e na Colômbia. 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 '{
  "url": "https://m.temu.com/product-g-601099588578152.html",
  "target": "temu.com",
  "type": "pdp"
}'

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_pdp

Auth

Bearer ou X-API-Key

temu_com_pdp tools/call
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "temu_com_pdp",
    "arguments": {
      "url": "https://m.temu.com/product-g-601099588578152.html",
      "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) Obrigatório URL HTTPS da Temu com product-g-<id> ou goods_id. Aceita URLs neutras e regionais de Brasil, Estados Unidos, Reino Unido e Colômbia. - https://m.temu.com/product-g-601099588578152.html
region
Região da consulta. O formato depende da API; Temu PDP aceita br (Brasil), us (Estados Unidos), uk (Reino Unido) e co (Colômbia); PLP aceita br, us e uk. O padrão da Temu sem país na URL é br e OLX aceita uma região textual.
string Opcional Aceita br (Brasil, BRL), us (Estados Unidos, USD), uk (Reino Unido, GBP) e co (Colômbia, COP). Sem region, infere o país pelo host ou prefixo /br/, /us/, /uk/ ou /co/ da URL; URLs neutras usam br. O campo region deve coincidir com o país da URL; conflitos e outros países retornam HTTP 400. Colômbia está disponível somente para PDP; PLP aceita br, us e uk. Disponibilidade e preços variam por país. Inferido pela URL; br sem país us
target
Fonte alvo da extração.
enum Obrigatório Sempre obrigatorio no payload e deve combinar com o seam. - temu.com
type
Tipo da extração: pdp, idp, plp, ilp, quote, review ou places.
enum Obrigatório Sempre obrigatorio no payload e deve combinar com o seam. - pdp

Exemplos de request

PDP por URL mobile

Consulta basica para pagina de produto da Temu.

PDP por URL mobile
{
  "url": "https://m.temu.com/product-g-601099588578152.html",
  "target": "temu.com",
  "type": "pdp"
}

PDP por goods.html

Tambem aceita URLs desktop da Temu com goods_id.

PDP por goods.html
{
  "url": "https://www.temu.com/goods.html?goods_id=601099588578152",
  "target": "temu.com",
  "type": "pdp"
}

Estados Unidos

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

Estados Unidos
{
  "target": "temu.com",
  "type": "pdp",
  "region": "us",
  "url": "https://www.temu.com/us/product-g-601101379301276.html"
}

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

Colômbia

Consulta um produto do catálogo colombiano, com valores em COP. Colômbia está disponível somente para PDP.

Colômbia
{
  "target": "temu.com",
  "type": "pdp",
  "region": "co",
  "url": "https://www.temu.com/co/product-g-606151617962210.html"
}

Schema de response (leaf paths)

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

responseSchema
{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.productId": "string",
  "data.itemId": "string",
  "data.region": "string",
  "data.canonicalUrl": "string",
  "data.url": "string",
  "data.name": "string",
  "data.description": "string | null",
  "data.currency": "string",
  "data.currencyRaw": "string",
  "data.price": "number",
  "data.priceDisplay": "string",
  "data.priceFormat.currency_code": "string",
  "data.priceFormat.symbol": "string",
  "data.priceFormat.decimal_separator": "string",
  "data.priceFormat.grouping_separator": "string",
  "data.priceFormat.decimals": "number",
  "data.prices.min.amountMinor": "number",
  "data.prices.min.amount": "number",
  "data.prices.min.display": "string",
  "data.prices.max.amountMinor": "number",
  "data.prices.max.amount": "number",
  "data.prices.max.display": "string (optional)",
  "data.prices.rangeDisplay": "string",
  "data.soldQuantity": "number",
  "data.soldQuantityText": "string",
  "data.availability": "string",
  "data.stock": "number",
  "data.status.text": "string",
  "data.status.isOnSale": "boolean",
  "data.categoryIds[]": "number",
  "data.mainImage.url": "string",
  "data.images[].url": "string",
  "data.detailImages[]": "string",
  "data.additionalProperties[].name": "string",
  "data.additionalProperties[].value": "string",
  "data.additionalProperties[].values[]": "string",
  "data.shipping.text": "string (optional)",
  "data.shipping.promiseText": "string (optional)",
  "data.shipping.companies[].name": "string",
  "data.shipping.companies[].trackingText": "string (optional)",
  "data.shipping.timeDistribution.days": "number (optional)",
  "data.shipping.timeDistribution.minDays": "number (optional)",
  "data.shipping.timeDistribution.maxDays": "number (optional)",
  "data.variants[].skuId": "number",
  "data.variants[].goodsId": "number",
  "data.variants[].specs": "object",
  "data.variants[].imageUrl": "string",
  "data.variants[].stockQuantity": "number",
  "data.variants[].soldQuantity": "number",
  "data.variants[].isOnSale": "boolean",
  "data.variants[].price.amount": "number",
  "data.variants[].price.display": "string",
  "data.variants[].normalPrice.amount": "number",
  "data.variants[].normalPrice.display": "string",
  "data.variants[].linePrice.amount": "number (optional)",
  "data.variants[].linePrice.display": "string (optional)",
  "data.variants[].discountBps": "number (optional)",
  "data.variants[].measurements[]": "string",
  "data.seller.mallId": "number",
  "data.seller.name": "string",
  "data.seller.salesTip": "string",
  "data.review.rating": "number | null",
  "data.review.reviewCount": "number | null",
  "data.descriptionContent.images[]": "string",
  "data.descriptionContent.videos[]": "string (optional)",
  "data.descriptionContent.properties": "object",
  "data.referencePrices[].skuId": "string",
  "data.referencePrices[].amountMinor": "number",
  "data.referencePrices[].amount": "number",
  "data.referencePrices[].display": "string",
  "data.referencePrices[].currency": "string",
  "data.referencePrices[].symbol": "string",
  "data.referencePrices[].label": "string | null",
  "data.referencePrices[].kind": "string",
  "data.referencePrices[].explanations[]": "string",
  "data.rankTag": "string | null",
  "data.seller.rating": "number | null",
  "data.seller.followers": "number | null",
  "data.seller.followersText": "string | null",
  "data.seller.productCount": "number | null",
  "data.seller.productCountText": "string | null",
  "data.seller.joinDate": "string | null",
  "data.seller.tenure": "object | null",
  "data.seller.tenure.text": "string",
  "data.seller.tenure.description": "string | null",
  "data.preOrder": "object | null",
  "data.preOrder.isPreOrder": "boolean",
  "data.preOrder.title": "string",
  "data.preOrder.message": "string | null",
  "data.preOrder.terms[]": "string",
  "data.preOrder.scope": "string",
  "data.deliveryGuarantee": "object | null",
  "data.deliveryGuarantee.title": "string",
  "data.deliveryGuarantee.description": "string | null",
  "data.deliveryGuarantee.terms[].title": "string",
  "data.deliveryGuarantee.terms[].description": "string | null",
  "data.deliveryGuarantee.terms[].policyPath": "string | null",
  "data.categories[].optId": "string",
  "data.categories[].name": "string",
  "data.categories[].parentOptId": "string | null",
  "data.enrichment.seller.status": "string",
  "data.enrichment.seller.reason": "string (optional)",
  "data.enrichment.categories.status": "string",
  "data.enrichment.categories.reason": "string (optional)",
  "data.descriptionContent.text": "string | null",
  "data.variants[].discountPercent": "number (optional)",
  "data.variants[].discountText": "string (optional)",
  "data.breadcrumb[].optId": "string",
  "data.breadcrumb[].name": "string",
  "data.breadcrumb[].parentOptId": "string | null",
  "data.returnPolicy": "object | null",
  "data.returnPolicy.title": "string",
  "data.returnPolicy.terms[]": "string",
  "data.returnPolicy.policyPath": "string | null",
  "data.fulfillment.isLocalGoods": "boolean | null",
  "data.fulfillment.label": "string | null",
  "data.enrichment.breadcrumb.status": "string",
  "data.enrichment.breadcrumb.reason": "string (optional)",
  "data.seller.information": "object | null",
  "data.seller.information.title": "string | null",
  "data.seller.information.name": "string | null",
  "data.seller.information.address": "string | null",
  "data.seller.information.email": "string | null",
  "data.seller.information.fields[].type": "string | null",
  "data.seller.information.fields[].label": "string | null",
  "data.seller.information.fields[].value": "string",
  "data.enrichment.sellerInformation.status": "string",
  "data.enrichment.sellerInformation.reason": "string (optional)"
}

Exemplo de response

responseExample
{
  "requestId": "77777777-7777-4777-8777-777777777777",
  "executionId": "88888888-8888-4888-8888-888888888888",
  "data": {
    "productId": "601099588578152",
    "itemId": "RF152745",
    "region": "br",
    "name": "Sapatos Mary Jane Franceses para Meninas Primavera/Outono 2024 Novos Sapatos de Tule de Laço de Pérola Estilo Fada Mocassins",
    "description": null,
    "currency": "BRL",
    "priceFormat": {
      "currency_code": "BRL",
      "symbol": "R$",
      "decimal_separator": ",",
      "grouping_separator": ".",
      "decimals": 2
    },
    "prices": {
      "min": {
        "amountMinor": 10050,
        "amount": 100.5,
        "display": "R$100,50",
        "currency": "BRL",
        "symbol": "R$"
      },
      "max": {
        "amountMinor": 10050,
        "amount": 100.5,
        "currency": "BRL",
        "symbol": "R$"
      },
      "rangeDisplay": "R$100,50"
    },
    "soldQuantity": 4100,
    "soldQuantityText": "4,1mil vendidos",
    "status": {
      "code": 1,
      "text": "NORMAL",
      "isOnSale": true
    },
    "categoryIds": [
      27011,
      29550,
      29717,
      29720,
      29723
    ],
    "images": [
      {
        "url": "https://img.kwcdn.com/product/fancy/f2c1c4e3-80c3-4fd4-9b3c-789d73440d4d.jpg",
        "width": 800,
        "height": 800
      }
    ],
    "detailImages": [
      "https://img.kwcdn.com/product/fancy/bf74d132-b162-4273-b679-3d919d6a74da.jpg"
    ],
    "additionalProperties": [
      {
        "name": "Padronizado",
        "value": "Aleatório",
        "values": [
          "Aleatório"
        ]
      },
      {
        "name": "Estação",
        "value": "Primavera/Outono",
        "values": [
          "Primavera/Outono"
        ]
      },
      {
        "name": "Idade aplicável para sapatos infantis",
        "value": "14 anos ou menos",
        "values": [
          "14 anos ou menos"
        ]
      },
      {
        "name": "Material da sola",
        "value": "PU",
        "values": [
          "PU"
        ]
      },
      {
        "name": "Material da palmilha",
        "value": "PU",
        "values": [
          "PU"
        ]
      },
      {
        "name": "Material superior",
        "value": "PU",
        "values": [
          "PU"
        ]
      },
      {
        "name": "Material Interno",
        "value": "PU",
        "values": [
          "PU"
        ]
      },
      {
        "name": "Pessoas aplicáveis",
        "value": "Garotas",
        "values": [
          "Garotas"
        ]
      },
      {
        "name": "Tipo de fechamento",
        "value": "Outro",
        "values": [
          "Outro"
        ]
      },
      {
        "name": "Biqueira",
        "value": "Biqueira redonda",
        "values": [
          "Biqueira redonda"
        ]
      },
      {
        "name": "ocasião",
        "value": "Ar livre, Street, Inglaterra",
        "values": [
          "Ar livre",
          "Street",
          "Inglaterra"
        ]
      },
      {
        "name": "Estilo",
        "value": "Bonitinho, Estilo Doce, Moda",
        "values": [
          "Bonitinho",
          "Estilo Doce",
          "Moda"
        ]
      },
      {
        "name": "Elementos Populares",
        "value": "Laço, Com missangas",
        "values": [
          "Laço",
          "Com missangas"
        ]
      },
      {
        "name": "ID do item",
        "value": "RF152745",
        "values": [
          "RF152745"
        ]
      },
      {
        "name": "Origem",
        "value": "Zhejiang, China",
        "values": [
          "Zhejiang, China"
        ]
      }
    ],
    "shipping": {
      "title": "R$15,00 de frete, frete grátis acima de R$69,00",
      "dayNum": 8,
      "deliveryType": 1,
      "content": "Envio",
      "deliveryTime": "23 de Set.-17 de Out.",
      "companies": [
        {
          "name": "Correios",
          "logoUrl": "https://aimg.kwcdn.com/upload_aimg/br/44dd817b-fd41-470f-9761-97c05ce8402a.png.slim.png"
        },
        {
          "name": "J&T express",
          "logoUrl": "https://aimg.kwcdn.com/upload_aimg/mkt/bddb4a1c-0113-4fcc-a09f-792ccd76b417.png.slim.png"
        },
        {
          "name": "AnjunExpress",
          "logoUrl": "https://aimg.kwcdn.com/upload_aimg/br/ab55ee92-90fc-4ad5-89e1-ecc5f7709aa5.png.slim.png"
        }
      ],
      "timeDistribution": [
        {
          "name": "≤8 dias",
          "percentage": 530,
          "percentageText": "5,3%"
        },
        {
          "name": "9 dias",
          "percentage": 640,
          "percentageText": "6,4%"
        },
        {
          "name": "10 dias",
          "percentage": 910,
          "percentageText": "9,1%"
        },
        {
          "name": "11 dias",
          "percentage": 1120,
          "percentageText": "11,2%"
        },
        {
          "name": "12 dias",
          "percentage": 1180,
          "percentageText": "11,8%"
        },
        {
          "name": "13 dias",
          "percentage": 1150,
          "percentageText": "11,5%"
        },
        {
          "name": "14 dias",
          "percentage": 1020,
          "percentageText": "10,2%"
        },
        {
          "name": "15 dias",
          "percentage": 840,
          "percentageText": "8,4%"
        },
        {
          "name": "16 dias",
          "percentage": 660,
          "percentageText": "6,6%"
        },
        {
          "name": "17 dias",
          "percentage": 480,
          "percentageText": "4,8%"
        },
        {
          "name": "18 dias",
          "percentage": 360,
          "percentageText": "3,6%"
        },
        {
          "name": "19 dias",
          "percentage": 260,
          "percentageText": "2,6%"
        },
        {
          "name": "20 dias",
          "percentage": 190,
          "percentageText": "1,9%"
        },
        {
          "name": "21 dias",
          "percentage": 130,
          "percentageText": "1,3%"
        },
        {
          "name": "22 dias",
          "percentage": 100,
          "percentageText": "1,0%"
        },
        {
          "name": "23 dias",
          "percentage": 70,
          "percentageText": "0,7%"
        },
        {
          "name": "24 dias",
          "percentage": 60,
          "percentageText": "0,6%"
        },
        {
          "name": "25 dias",
          "percentage": 40,
          "percentageText": "0,4%"
        },
        {
          "name": "26 dias",
          "percentage": 40,
          "percentageText": "0,4%"
        },
        {
          "name": "27 dias",
          "percentage": 30,
          "percentageText": "0,3%"
        },
        {
          "name": "28 dias",
          "percentage": 20,
          "percentageText": "0,2%"
        },
        {
          "name": "29 dias",
          "percentage": 20,
          "percentageText": "0,2%"
        },
        {
          "name": "30 dias",
          "percentage": 20,
          "percentageText": "0,2%"
        },
        {
          "name": "31 dias",
          "percentage": 10,
          "percentageText": "0,1%"
        },
        {
          "name": "32 dias",
          "percentage": 10,
          "percentageText": "0,1%"
        },
        {
          "name": ">32 dias",
          "percentage": 110,
          "percentageText": "1,1%"
        }
      ],
      "rawDescriptions": [
        "Transportadora: Correios J&T express AnjunExpress"
      ]
    },
    "variants": [
      {
        "skuId": 17592492785911,
        "goodsId": 601099588578152,
        "specs": {
          "Cor": "【Bege】",
          "Tamanho": "BR 24.5"
        },
        "imageUrl": "https://img.kwcdn.com/product/fancy/48a5aad4-151f-45de-84b7-87b5a802dbd4.jpg",
        "urlId": "4972158314171319415",
        "stockQuantity": 6,
        "soldQuantity": 129,
        "isOnSale": true,
        "limitQuantity": 6,
        "price": {
          "amountMinor": 10050,
          "amount": 100.5,
          "display": "R$100,50",
          "currency": "BRL",
          "symbol": "R$"
        },
        "normalPrice": {
          "amountMinor": 10050,
          "amount": 100.5,
          "display": "R$100,50",
          "currency": "BRL",
          "symbol": "R$"
        },
        "linePrice": {
          "amountMinor": 23368,
          "amount": 233.68,
          "display": "233,68",
          "currency": "BRL",
          "symbol": "R$"
        },
        "measurements": [
          "Comprimento do pé: 16 cm"
        ]
      }
    ],
    "seller": {
      "mallId": 4785488442765,
      "name": "Yuanqing children shoe",
      "salesTip": "(45mil vendidos)",
      "rating": 4.8,
      "followers": 203,
      "followersText": "203 Seguidores",
      "productCount": 43,
      "productCountText": "43 Itens",
      "joinDate": null,
      "tenure": {
        "text": "Começou a vender na TEMU há 3 anos",
        "description": "A loja começou a vender produtos na TEMU há mais de 3 anos."
      },
      "information": {
        "title": "Informações sobre a Loja",
        "name": "Lixiaoming",
        "address": "Block 8, Jinshuiyuan, Zeguo Town\nWenling City\n317500\nZhejiang Province, Taizhou\nChina",
        "email": "459394199@qq.com",
        "fields": [
          {
            "type": "NAME",
            "label": "Nome",
            "value": "Lixiaoming"
          },
          {
            "type": "ADDRESS",
            "label": "Endereço",
            "value": "Block 8, Jinshuiyuan, Zeguo Town\nWenling City\n317500\nZhejiang Province, Taizhou\nChina"
          },
          {
            "type": "EMAIL",
            "label": "Endereço de e-mail",
            "value": "459394199@qq.com"
          }
        ]
      }
    },
    "review": {
      "rating": 4.8,
      "reviewCount": 428
    },
    "url": "https://www.temu.com/br/product-g-601099588578152.html",
    "canonicalUrl": "https://www.temu.com/goods.html?goods_id=601099588578152",
    "price": 100.5,
    "priceDisplay": "R$100,50",
    "currencyRaw": "R$",
    "mainImage": {
      "url": "https://img.kwcdn.com/product/fancy/f2c1c4e3-80c3-4fd4-9b3c-789d73440d4d.jpg",
      "width": 800,
      "height": 800
    },
    "stock": 120,
    "availability": "InStock",
    "referencePrices": [
      {
        "skuId": "17592492785911",
        "amountMinor": 23368,
        "amount": 233.68,
        "display": "233,68",
        "currency": "BRL",
        "symbol": "R$",
        "label": "PVR",
        "kind": "recommended_retail_price",
        "explanations": [
          "Os itens na Temu podem exibir um Preço de Varejo Recomendado (PVR), sem vínculo obrigatório, o qual é definido e usado por fabricantes, fornecedores ou parceiros comerciais. O PVR é exibido como preço de referência para sua informação e para comparação de preços."
        ]
      }
    ],
    "descriptionContent": {
      "images": [
        "https://img.kwcdn.com/product/fancy/bf74d132-b162-4273-b679-3d919d6a74da.jpg"
      ],
      "videos": [],
      "properties": {
        "Padronizado": [
          "Aleatório"
        ],
        "Estação": [
          "Primavera/Outono"
        ],
        "Idade aplicável para sapatos infantis": [
          "14 anos ou menos"
        ],
        "Material da sola": [
          "PU"
        ],
        "Material da palmilha": [
          "PU"
        ],
        "Material superior": [
          "PU"
        ],
        "Material Interno": [
          "PU"
        ],
        "Pessoas aplicáveis": [
          "Garotas"
        ],
        "Tipo de fechamento": [
          "Outro"
        ],
        "Biqueira": [
          "Biqueira redonda"
        ],
        "ocasião": [
          "Ar livre",
          "Street",
          "Inglaterra"
        ],
        "Estilo": [
          "Bonitinho",
          "Estilo Doce",
          "Moda"
        ],
        "Elementos Populares": [
          "Laço",
          "Com missangas"
        ],
        "ID do item": [
          "RF152745"
        ],
        "Origem": [
          "Zhejiang, China"
        ]
      },
      "text": null
    },
    "rankTag": "1º entre os Mais Vendidos deste vendedor",
    "preOrder": {
      "isPreOrder": true,
      "title": "Pré-venda",
      "message": "Pré-venda. Entrega: 23 de Set.-17 de Out.",
      "terms": [
        "1. A pré-venda de itens reduz o desperdício excessivo devido a inventário não vendido.",
        "2. Se fizer um pedido com itens de pré-venda e outros itens normais, serão enviados em conjunto. Mas não se preocupe! É mais rápido do que pensa!"
      ],
      "scope": "product_selection_notice"
    },
    "deliveryGuarantee": {
      "title": "Garantia de entrega",
      "description": "A Temu trabalha com parceiros de envio confiáveis em todo o mundo. Garantimos que seu pacote chegará a você com segurança e dentro do prazo. \nSe houver algum problema durante o trânsito dos itens que você comprou, como danos, perda ou atraso, tenha certeza de que faremos o possível para solucionar da melhor maneira os problemas e oferecer as melhores soluções.",
      "terms": [
        {
          "title": "R$10,00 de crédito por atraso",
          "description": "Se o seu pedido não for entregue na data de entrega limite informada, ofereceremos um crédito de R$10,00 (Envio padrão) em até aproximadamente 48 horas após essa data, como gesto de cortesia. O crédito será emitido para seu saldo de créditos da Temu e poderá ser usado em seu próximo pedido.\nEm circunstâncias específicas, incluindo, mas não se limitando a desastres naturais e outras circunstâncias imprevisíveis, você pode não receber indenização por atraso na entrega.",
          "policyPath": "/late-delivery-compensation-policy.html"
        },
        {
          "title": "Devolução se o item estiver danificado",
          "description": "Se receber o seu pacote e verificar que alguns itens se perderam ou ficaram danificados durante o transporte, pode solicitar facilmente o reembolso total desses itens.",
          "policyPath": null
        },
        {
          "title": "Reembolso por 30 dias sem atualização",
          "description": "Se o seu pacote não tiver atualizações de rastreamento por mais de 30 dias e não tiver sido entregue, você pode solicitar um reenvio gratuito ou reembolso, pois o pacote pode ter sido perdido durante o transporte. Se você receber o pacote após sua solicitação ter sido aprovada, poderá ficar com ele gratuitamente em determinadas circunstâncias, sem precisar devolvê-lo.\nEm determinadas circunstâncias, incluindo, mas não se limitando a, desastres naturais e outras situações de força maior, você poderá não ter direito a indenização ou reembolso caso não haja atualizações. Os prazos de elegibilidade podem variar dependendo do método de envio, do tipo de pedido e de outros detalhes do pedido. Após fazer um pedido, consulte a garantia de entrega na página de detalhes do pedido para verificar o prazo aplicável.",
          "policyPath": "/package-lost-compensation-policy.html"
        },
        {
          "title": "Reembolso por 65 dias sem entrega",
          "description": "Se o seu pacote não for entregue em até 65 dias após o envio (5 dias a mais para pacotes enviados por caminhão ou com peso igual ou superior a 80 kg), você pode solicitar um reenvio gratuito ou reembolso. Se você receber o pacote após sua solicitação ter sido aprovada, poderá ficar com ele gratuitamente em determinadas circunstâncias, sem precisar devolvê-lo.\nEm determinadas circunstâncias, incluindo, mas não se limitando a, desastres naturais e outras situações de força maior, você poderá não ter direito a um reenvio gratuito ou reembolso caso seu pedido não tenha sido entregue. Os prazos de elegibilidade podem variar dependendo do método de envio, do tipo de pedido e de outros detalhes do pedido. Após efetuar um pedido, consulte a garantia de entrega na página de detalhes do pedido para verificar o prazo aplicável.",
          "policyPath": "/no-delivery-compensation-policy.html"
        }
      ]
    },
    "categories": [
      {
        "optId": "1562",
        "name": "Mocassins e Sapatilhas Femininas",
        "parentOptId": "1553"
      }
    ],
    "enrichment": {
      "seller": {
        "status": "ok"
      },
      "categories": {
        "status": "ok"
      },
      "breadcrumb": {
        "status": "ok"
      },
      "sellerInformation": {
        "status": "ok"
      }
    },
    "returnPolicy": {
      "title": "Devoluções gratuitas no prazo de 90 dias após a compra",
      "terms": [
        "A primeira devolução de um ou vários artigos elegíveis para devolução em TODOS os pedidos é grátis!",
        "É possível devolver este artigo no prazo de 90 dias a partir da data de compra.",
        "Se o artigo devolvido foi utilizado, está danificado ou tiver peças/acessórios em falta, e tal não for imputável à Temu ou ao vendedor, o reembolso será reduzido para compensar a desvalorização do artigo."
      ],
      "policyPath": "/return-and-refund-policy.html"
    },
    "fulfillment": {
      "isLocalGoods": false,
      "label": null
    },
    "breadcrumb": [
      {
        "optId": "1553",
        "name": "Calçados infantis",
        "parentOptId": null
      },
      {
        "optId": "1562",
        "name": "Mocassins e Sapatilhas Femininas",
        "parentOptId": "1553"
      }
    ]
  }
}

Referência completa de campos

Path Tipo Descrição Exemplo
data.additionalProperties[].name string Nome de uma especificacao do produto. Padronizado
data.additionalProperties[].value string Valor principal da especificacao. Aleatório
data.additionalProperties[].values[] string Valores da especificacao quando a Temu retorna lista. Aleatório
data.availability string Disponibilidade normalizada, por exemplo InStock. InStock
data.breadcrumb[].name string Nome localizado da categoria no breadcrumb. O caminho pode ser parcial; consulte enrichment.breadcrumb. Calçados infantis
data.breadcrumb[].optId string ID da categoria no caminho de navegação, da categoria superior para a categoria específica do produto. Home e o título do produto não fazem parte desta lista. 1553
data.breadcrumb[].parentOptId string | null ID da categoria superior; null para a categoria raiz retornada. null
data.canonicalUrl string URL canonica em goods.html montada com goods_id. https://www.temu.com/goods.html?goods_id=601099588578152
data.categories[].name string Nome localizado da categoria vinculada ao produto. Para a sequência de categorias superiores, consulte breadcrumb. Mocassins e Sapatilhas Femininas
data.categories[].optId string ID da categoria de navegação vinculada ao produto. Não é o mesmo identificador de categoryIds. 1562
data.categories[].parentOptId string | null ID da categoria de navegação superior, quando fornecido. 1553
data.categoryIds[] number IDs de categorias retornados pela Temu. 27011
data.currency string Moeda normalizada em ISO 4217 quando disponivel. BRL
data.currencyRaw string Simbolo ou valor bruto de moeda retornado pela Temu. R$
data.deliveryGuarantee object | null Garantia de entrega com as condições exibidas pela Temu. {"title":"Garantia de entrega","description":"A Temu trabalha com parceiros de envio confiáveis em todo o mundo. Garantimos que seu pacote chegará a você com segurança e dentro do prazo. \nSe houver algum problema durante o trânsito dos itens que você comprou, como danos, perda ou atraso, tenha certeza de que faremos o possível para solucionar da melhor maneira os problemas e oferecer as melhores soluções.","terms":[{"title":"R$10,00 de crédito por atraso","description":"Se o seu pedido não for entregue na data de entrega limite informada, ofereceremos um crédito de R$10,00 (Envio padrão) em até aproximadamente 48 horas após essa data, como gesto de cortesia. O crédito será emitido para seu saldo de créditos da Temu e poderá ser usado em seu próximo pedido.\nEm circunstâncias específicas, incluindo, mas não se limitando a desastres naturais e outras circunstâncias imprevisíveis, você pode não receber indenização por atraso na entrega.","policyPath":"/late-delivery-compensation-policy.html"},{"title":"Devolução se o item estiver danificado","description":"Se receber o seu pacote e verificar que alguns itens se perderam ou ficaram danificados durante o transporte, pode solicitar facilmente o reembolso total desses itens.","policyPath":null},{"title":"Reembolso por 30 dias sem atualização","description":"Se o seu pacote não tiver atualizações de rastreamento por mais de 30 dias e não tiver sido entregue, você pode solicitar um reenvio gratuito ou reembolso, pois o pacote pode ter sido perdido durante o transporte. Se você receber o pacote após sua solicitação ter sido aprovada, poderá ficar com ele gratuitamente em determinadas circunstâncias, sem precisar devolvê-lo.\nEm determinadas circunstâncias, incluindo, mas não se limitando a, desastres naturais e outras situações de força maior, você poderá não ter direito a indenização ou reembolso caso não haja atualizações. Os prazos de elegibilidade podem variar dependendo do método de envio, do tipo de pedido e de outros detalhes do pedido. Após fazer um pedido, consulte a garantia de entrega na página de detalhes do pedido para verificar o prazo aplicável.","policyPath":"/package-lost-compensation-policy.html"},{"title":"Reembolso por 65 dias sem entrega","description":"Se o seu pacote não for entregue em até 65 dias após o envio (5 dias a mais para pacotes enviados por caminhão ou com peso igual ou superior a 80 kg), você pode solicitar um reenvio gratuito ou reembolso. Se você receber o pacote após sua solicitação ter sido aprovada, poderá ficar com ele gratuitamente em determinadas circunstâncias, sem precisar devolvê-lo.\nEm determinadas circunstâncias, incluindo, mas não se limitando a, desastres naturais e outras situações de força maior, você poderá não ter direito a um reenvio gratuito ou reembolso caso seu pedido não tenha sido entregue. Os prazos de elegibilidade podem variar dependendo do método de envio, do tipo de pedido e de outros detalhes do pedido. Após efetuar um pedido, consulte a garantia de entrega na página de detalhes do pedido para verificar o prazo aplicável.","policyPath":"/no-delivery-compensation-policy.html"}]}
data.deliveryGuarantee.description string | null Descrição da garantia de entrega. A Temu trabalha com parceiros de envio confiáveis em todo o mundo. Garantimos que seu pacote chegará a você com segurança e dentro do prazo. Se houver algum problema durante o trânsito dos itens que você comprou, como danos, perda ou atraso, tenha certeza de que faremos o possível para solucionar da melhor maneira os problemas e oferecer as melhores soluções.
data.deliveryGuarantee.terms[].description string | null Condições e exceções da cobertura; os títulos não representam promessas incondicionais. Se o seu pedido não for entregue na data de entrega limite informada, ofereceremos um crédito de R$10,00 (Envio padrão) em até aproximadamente 48 horas após essa data, como gesto de cortesia. O crédito será emitido para seu saldo de créditos da Temu e poderá ser usado em seu próximo pedido. Em circunstâncias específicas, incluindo, mas não se limitando a desastres naturais e outras circunstâncias imprevisíveis, você pode não receber indenização por atraso na entrega.
data.deliveryGuarantee.terms[].policyPath string | null Caminho relativo da política na Temu. /late-delivery-compensation-policy.html
data.deliveryGuarantee.terms[].title string Título de cada cobertura, como crédito por atraso. R$10,00 de crédito por atraso
data.deliveryGuarantee.title string Título da garantia de entrega. Garantia de entrega
data.description string | null Descrição textual do produto retornada pela Temu, usando o texto da seção de detalhes quando disponível. Retorna null quando ausente; não é a descrição institucional da loja. null
data.descriptionContent.images[] string Imagens da seção de detalhes do produto. https://img.kwcdn.com/product/fancy/bf74d132-b162-4273-b679-3d919d6a74da.jpg
data.descriptionContent.properties object Especificações por nome, com listas de valores; não são uma descrição de texto gerada. {"Padronizado":["Aleatório"],"Estação":["Primavera/Outono"],"Idade aplicável para sapatos infantis":["14 anos ou menos"],"Material da sola":["PU"],"Material da palmilha":["PU"],"Material superior":["PU"],"Material Interno":["PU"],"Pessoas aplicáveis":["Garotas"],"Tipo de fechamento":["Outro"],"Biqueira":["Biqueira redonda"],"ocasião":["Ar livre","Street","Inglaterra"],"Estilo":["Bonitinho","Estilo Doce","Moda"],"Elementos Populares":["Laço","Com missangas"],"ID do item":["RF152745"],"Origem":["Zhejiang, China"]}
data.descriptionContent.text string | null Texto da seção de detalhes do produto, preservado sem gerar ou interpretar imagens. null quando ausente. null
data.descriptionContent.videos[] string (optional) URLs dos vídeos da seção de detalhes. N/A
data.detailImages[] string URLs das imagens de detalhe/descritivas. https://img.kwcdn.com/product/fancy/bf74d132-b162-4273-b679-3d919d6a74da.jpg
data.enrichment.breadcrumb.reason string (optional) Motivo seguro de falha ou consulta ignorada, incluindo missing_category_id quando não há categoria vinculada ao produto para resolver. N/A
data.enrichment.breadcrumb.status string ok quando o caminho foi resolvido; unavailable quando a resposta não permite completar o caminho; failed ou skipped em caso de falha ou limite de tempo. A categoria conhecida é preservada. ok
data.enrichment.categories.reason string (optional) Motivo seguro da falha ou de a consulta adicional ter sido ignorada. N/A
data.enrichment.categories.status string ok, unavailable, failed ou skipped. unavailable indica uma resposta válida sem categorias. ok
data.enrichment.seller.reason string (optional) Motivo opcional: insufficient_time, missing_seller_id, verification_required, upstream_error, invalid_response, timeout ou request_failed. N/A
data.enrichment.seller.status string ok, unavailable, failed ou skipped. Falhas de enriquecimento não descartam os dados válidos do produto. ok
data.enrichment.sellerInformation.reason string (optional) Motivo opcional: insufficient_time, missing_seller_id, verification_required, upstream_error, invalid_response, timeout ou request_failed. N/A
data.enrichment.sellerInformation.status string ok, unavailable, failed ou skipped. Falhas desta consulta opcional não descartam o produto ou os demais dados da loja. ok
data.fulfillment.isLocalGoods boolean | null Classificação local retornada pela Temu: true para item local, false para item não classificado como local e null quando não informado. Não identifica endereço ou país do armazém. false
data.fulfillment.label string | null Etiqueta de envio do produto, por exemplo Local warehouse, quando disponível. Não usa o link global de navegação da página. null
data.images[].url string URLs das imagens de galeria. https://img.kwcdn.com/product/fancy/f2c1c4e3-80c3-4fd4-9b3c-789d73440d4d.jpg
data.itemId string Identificador secundario do item quando retornado pela Temu. RF152745
data.mainImage.url string URL da imagem principal. https://img.kwcdn.com/product/fancy/f2c1c4e3-80c3-4fd4-9b3c-789d73440d4d.jpg
data.name string Nome do produto. Sapatos Mary Jane Franceses para Meninas Primavera/Outono 2024 Novos Sapatos de Tule de Laço de Pérola Estilo Fada Mocassins
data.preOrder object | null Aviso explícito de pré-venda. null significa que não foi confirmado; não equivale a false. {"isPreOrder":true,"title":"Pré-venda","message":"Pré-venda. Entrega: 23 de Set.-17 de Out.","terms":["1. A pré-venda de itens reduz o desperdício excessivo devido a inventário não vendido.","2. Se fizer um pedido com itens de pré-venda e outros itens normais, serão enviados em conjunto. Mas não se preocupe! É mais rápido do que pensa!"],"scope":"product_selection_notice"}
data.preOrder.isPreOrder boolean true somente quando há aviso explícito de pré-venda. true
data.preOrder.message string | null Aviso de pré-venda e janela de entrega, quando retornados. Pré-venda. Entrega: 23 de Set.-17 de Out.
data.preOrder.scope string product_selection_notice: refere-se ao aviso da seleção do produto e não confirma todos os SKUs. product_selection_notice
data.preOrder.terms[] string Condições da pré-venda fornecidas pela Temu. 1. A pré-venda de itens reduz o desperdício excessivo devido a inventário não vendido.
data.preOrder.title string Título do aviso de pré-venda. Pré-venda
data.price number Preco principal normalizado como numero decimal. 100.5
data.priceDisplay string Preco principal formatado para exibicao. R$100,50
data.priceFormat.currency_code string Codigo de moeda informado no bloco de formatacao. BRL
data.priceFormat.decimal_separator string Separador decimal usado pela Temu. ,
data.priceFormat.decimals number Quantidade de casas decimais usada no preco. 2
data.priceFormat.grouping_separator string Separador de milhar usado pela Temu. .
data.priceFormat.symbol string Simbolo usado na exibicao de preco. R$
data.prices.max.amount number Maior preco como decimal. 100.5
data.prices.max.amountMinor number Maior preco em unidades menores da moeda. 10050
data.prices.max.display string (optional) Maior preco formatado. N/A
data.prices.min.amount number Menor preco como decimal. 100.5
data.prices.min.amountMinor number Menor preco em unidades menores da moeda. 10050
data.prices.min.display string Menor preco formatado. R$100,50
data.prices.rangeDisplay string Faixa de preco formatada quando ha variacao. R$100,50
data.productId string Identificador goods_id da Temu extraido da URL e confirmado no payload. 601099588578152
data.rankTag string | null Texto da posição no ranking, incluindo o escopo da categoria ou da loja. null quando ausente. 1º entre os Mais Vendidos deste vendedor
data.referencePrices[].amount number Preço riscado/de referência fornecido pela Temu para o SKU; pode ser PVR/RRP ou outra referência. Não é necessariamente MRP nem um preço de venda anterior da Temu. 233.68
data.referencePrices[].amountMinor number Preço de referência em unidades menores da moeda. 23368
data.referencePrices[].currency string Moeda do preço de referência: BRL, USD ou GBP. BRL
data.referencePrices[].display string Texto do preço de referência retornado pela Temu. 233,68
data.referencePrices[].explanations[] string Explicação da Temu sobre a referência de preço. Os itens na Temu podem exibir um Preço de Varejo Recomendado (PVR), sem vínculo obrigatório, o qual é definido e usado por fabricantes, fornecedores ou parceiros comerciais. O PVR é exibido como preço de referência para sua informação e para comparação de preços.
data.referencePrices[].kind string recommended_retail_price ou reference_price, conforme o rótulo retornado. recommended_retail_price
data.referencePrices[].label string | null Rótulo original, por exemplo PVR ou RRP. PVR
data.referencePrices[].skuId string SKU ao qual o preço de referência se aplica. 17592492785911
data.referencePrices[].symbol string Símbolo da moeda do preço de referência. R$
data.region string País consultado: br, us ou uk, definido por region ou inferido pela URL. br
data.returnPolicy object | null Política de devolução deste produto fornecida pela Temu; null quando ausente. O prazo não é fixo para todo o catálogo. {"title":"Devoluções gratuitas no prazo de 90 dias após a compra","terms":["A primeira devolução de um ou vários artigos elegíveis para devolução em TODOS os pedidos é grátis!","É possível devolver este artigo no prazo de 90 dias a partir da data de compra.","Se o artigo devolvido foi utilizado, está danificado ou tiver peças/acessórios em falta, e tal não for imputável à Temu ou ao vendedor, o reembolso será reduzido para compensar a desvalorização do artigo."],"policyPath":"/return-and-refund-policy.html"}
data.returnPolicy.policyPath string | null Caminho da política na Temu, quando vinculado ao aviso deste produto. /return-and-refund-policy.html
data.returnPolicy.terms[] string Condições completas da devolução, incluindo limites por pedido e possíveis deduções no reembolso. A primeira devolução de um ou vários artigos elegíveis para devolução em TODOS os pedidos é grátis!
data.returnPolicy.title string Título da política, por exemplo devoluções gratuitas em até 90 dias após a compra. Devoluções gratuitas no prazo de 90 dias após a compra
data.review.rating number | null Nota média do produto, separada de seller.rating. null quando o produto não tem avaliações ou a nota não é informada. 4.8
data.review.reviewCount number | null Quantidade de avaliacoes. 428
data.seller.followers number | null Quantidade exata de seguidores, quando fornecida. Valores abreviados como 1K+ permanecem em followersText. 203
data.seller.followersText string | null Quantidade de seguidores no formato original da Temu. 203 Seguidores
data.seller.information object | null Informações públicas do painel Store Information / Informações sobre a Loja. Consulta adicional por seller.mallId; null quando indisponível. Consulte enrichment.sellerInformation para o resultado da consulta. {"title":"Informações sobre a Loja","name":"Lixiaoming","address":"Block 8, Jinshuiyuan, Zeguo Town\nWenling City\n317500\nZhejiang Province, Taizhou\nChina","email":"459394199@qq.com","fields":[{"type":"NAME","label":"Nome","value":"Lixiaoming"},{"type":"ADDRESS","label":"Endereço","value":"Block 8, Jinshuiyuan, Zeguo Town\nWenling City\n317500\nZhejiang Province, Taizhou\nChina"},{"type":"EMAIL","label":"Endereço de e-mail","value":"459394199@qq.com"}]}
data.seller.information.address string | null Endereço público do vendedor, preservando as quebras de linha da Temu. Não representa necessariamente endereço de devolução ou localização de estoque. Block 8, Jinshuiyuan, Zeguo Town Wenling City 317500 Zhejiang Province, Taizhou China
data.seller.information.email string | null E-mail de contato público quando fornecido pela Temu; null quando ausente. Alguns vendedores oferecem somente uma orientação para contato pelo chat. 459394199@qq.com
data.seller.information.fields[].label string | null Rótulo original apresentado pela Temu, como Business Name, Nome ou Endereço. Nome
data.seller.information.fields[].type string | null Tipo original do campo, como NAME, ADDRESS, EMAIL ou NOTE. Tipos adicionais são preservados. NAME
data.seller.information.fields[].value string Valor público do campo, incluindo eventuais orientações de contato e mantendo quebras de linha. Lixiaoming
data.seller.information.name string | null Nome publicado do vendedor (empresa ou pessoa), separado do nome de exibição da loja. O rótulo original é preservado em fields. Null quando ausente ou quando há múltiplos nomes distintos. Lixiaoming
data.seller.information.title string | null Título original do painel no idioma da região solicitada. Informações sobre a Loja
data.seller.joinDate string | null Data exata de entrada da loja, atualmente não disponível (null). Não é calculada a partir do tempo arredondado. null
data.seller.mallId number Identificador da loja na Temu. 4785488442765
data.seller.name string Nome da loja/seller. Yuanqing children shoe
data.seller.productCount number | null Quantidade de produtos da loja no catálogo consultado, quando exata. 43
data.seller.productCountText string | null Quantidade de produtos no formato original da Temu. 43 Itens
data.seller.rating number | null Nota da loja, separada da nota do produto. 4.8
data.seller.salesTip string Texto de vendas ou reputacao do seller. (45mil vendidos)
data.seller.tenure object | null Tempo de atividade atribuído à loja pela Temu; null quando a loja não possui essa informação. {"text":"Começou a vender na TEMU há 3 anos","description":"A loja começou a vender produtos na TEMU há mais de 3 anos."}
data.seller.tenure.description string | null Descrição completa do selo, preservando qualificadores como mais de 3 anos. A loja começou a vender produtos na TEMU há mais de 3 anos.
data.seller.tenure.text string Texto do selo de tempo de atividade, por exemplo há 3 anos. Começou a vender na TEMU há 3 anos
data.shipping.companies[].name string Nome da transportadora ou canal logistico. Correios
data.shipping.companies[].trackingText string (optional) Texto de rastreamento do canal logistico. N/A
data.shipping.promiseText string (optional) Texto de prazo/promessa de entrega. N/A
data.shipping.text string (optional) Texto resumido de frete. N/A
data.shipping.timeDistribution.days number (optional) Prazo estimado central em dias. N/A
data.shipping.timeDistribution.maxDays number (optional) Maior prazo estimado em dias. N/A
data.shipping.timeDistribution.minDays number (optional) Menor prazo estimado em dias. N/A
data.soldQuantity number Quantidade vendida normalizada quando a Temu fornece o sinal. 4100
data.soldQuantityText string Texto de vendas como aparece na experiencia Temu. 4,1mil vendidos
data.status.isOnSale boolean Indica se o item esta em venda ativa. true
data.status.text string Status textual do produto. NORMAL
data.stock number Estoque agregado ou estoque da melhor variacao disponivel. 120
data.url string URL original solicitada. https://www.temu.com/br/product-g-601099588578152.html
data.variants[].discountBps number (optional) Campo legado com o valor bruto reduction da Temu; apesar do nome, não usa basis points. 850 corresponde a 85%. Prefira discountPercent e discountText. N/A
data.variants[].discountPercent number (optional) Percentual de desconto informado pela Temu: 85 significa 85%. O percentual exibido é arredondado e não deve ser usado para reconstruir o preço de referência. N/A
data.variants[].discountText string (optional) Texto original de desconto, por exemplo 85% OFF. N/A
data.variants[].goodsId number goods_id associado a variacao. 601099588578152
data.variants[].imageUrl string Imagem especifica da variacao. https://img.kwcdn.com/product/fancy/48a5aad4-151f-45de-84b7-87b5a802dbd4.jpg
data.variants[].isOnSale boolean Indica se a variacao esta ativa para venda. true
data.variants[].linePrice.amount number (optional) Preco de linha/de referencia da variacao como decimal. 233.68
data.variants[].linePrice.display string (optional) Preco de linha/de referencia da variacao formatado. 233,68
data.variants[].measurements[] string Medidas ou detalhes especificos da variacao. Comprimento do pé: 16 cm
data.variants[].normalPrice.amount number Valor normal_price da Temu; pode ser igual ao preço atual. Para o preço riscado/de referência, use linePrice ou referencePrices. 100.5
data.variants[].normalPrice.display string Valor normal_price formatado pela Temu; não representa necessariamente um preço anterior ou de referência. R$100,50
data.variants[].price.amount number Preco atual da variacao como decimal. 100.5
data.variants[].price.display string Preco atual da variacao formatado. R$100,50
data.variants[].skuId number Identificador da variacao/SKU. 17592492785911
data.variants[].soldQuantity number Quantidade vendida da variacao quando disponivel. 129
data.variants[].specs object Mapa de atributos selecionaveis da variacao, como cor e tamanho. {"Cor":"【Bege】","Tamanho":"BR 24.5"}
data.variants[].stockQuantity number Estoque da variacao. 6
executionId string (uuid) Identificador unico da execucao do worker. 88888888-8888-4888-8888-888888888888
requestId string (uuid) Identificador unico da requisicao na GeckoAPI. 77777777-7777-4777-8777-777777777777

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.