PDP por URL mobile
Consulta basica para pagina de produto da Temu.
{
"url": "https://m.temu.com/product-g-601099588578152.html",
"target": "temu.com",
"type": "pdp"
} // docs
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.
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"
}'
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.
Endpoint
POST /v1/mcp
Tool name
temu_com_pdp
Auth
Bearer ou X-API-Key
{
"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"
}
}
}
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 |
Consulta basica para pagina de produto da Temu.
{
"url": "https://m.temu.com/product-g-601099588578152.html",
"target": "temu.com",
"type": "pdp"
} Tambem aceita URLs desktop da Temu com goods_id.
{
"url": "https://www.temu.com/goods.html?goods_id=601099588578152",
"target": "temu.com",
"type": "pdp"
} Consulta o catálogo dos Estados Unidos; os valores são retornados em USD.
{
"target": "temu.com",
"type": "pdp",
"region": "us",
"url": "https://www.temu.com/us/product-g-601101379301276.html"
} Consulta o catálogo do Reino Unido; os valores são retornados em GBP. Use uk no campo region.
{
"target": "temu.com",
"type": "pdp",
"region": "uk",
"url": "https://www.temu.com/uk/product-g-606858391703781.html"
} Consulta um produto do catálogo colombiano, com valores em COP. Colômbia está disponível somente para PDP.
{
"target": "temu.com",
"type": "pdp",
"region": "co",
"url": "https://www.temu.com/co/product-g-606151617962210.html"
} Mapa de paths de saída com tipo esperado para esta API.
{
"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)"
} {
"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"
}
]
}
} | 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 |
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. |