Temu: get product details
Inspect one public product page for pricing, identity, images and other fields when available from the source.
5 credits per request. Public data only; GeckoAPI is independent of the marketplace.
Try this endpointRegion, pagination and limitations
PDP supports br (BRL), us (USD), uk (GBP) and co (COP). Search supports br, us and uk. Region and URL country must agree. Search starts at page 1; use nextPageUrl to preserve its cursor. Product prices are in prices.min.amount; search prices are in items[].price.
HTTP request
cURL
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target": "temu.com",
"type": "pdp",
"region": "br",
"url": "https://www.temu.com/br/product-g-604898057923527.html"
}'Replace YOUR_API_KEY with your own server-side credential. Read the quickstart for authentication and error handling.
Supported inputs
| Field | Requirement | Meaning |
|---|---|---|
| url | required | Complete public search or product URL. Keep its country and query parameters. |
| region | optional | Source-specific country code. See the regional notes below. |
| target | required | Source identifier shown in the example. |
| type | required | plp for search; pdp for product details. |
Conditional means an alternative input can satisfy the request, such as keyword or search URL. Fields absent from this table are unsupported for this endpoint.
Example response
One possible response, not a guarantee of current price or availability. Product text stays in the source language. Fields may be missing or null; preserve that distinction in your database.
JSON
{
"requestId": "example-request-id",
"executionId": "example-execution-id",
"data": {
"productId": "604898057923527",
"itemId": "K6M2V4V3K5",
"region": "br",
"name": "Mouse Gamer Sem Fio para Escritório com Iluminação LED Vermelha, Mouse com Rastreamento, Sem Fio 2.4GHz, Alcance de 10m",
"description": null,
"currency": "BRL",
"priceFormat": {
"currency_code": "BRL",
"symbol": "R$",
"decimal_separator": ",",
"grouping_separator": ".",
"decimals": 2
},
"prices": {
"min": {
"amountMinor": 1564,
"amount": 15.64,
"display": "R$15,64",
"currency": "BRL",
"symbol": "R$"
},
"max": {
"amountMinor": 1602,
"amount": 16.02,
"currency": "BRL",
"symbol": "R$"
},
"rangeDisplay": "R$15,64-R$16,02"
},
"soldQuantity": 3900,
"soldQuantityText": "3,9mil vendidos",
"status": {
"code": 1,
"text": "NORMAL",
"isOnSale": true
},
"categoryIds": [
2542,
3715
],
"images": [
{
"url": "https://img.kwcdn.com/local-image/s132/211a2a4a582/3aea8c89-769a-47c5-aa79-9eef91f54117_800x800.jpeg.format.jpg",
"width": 800,
"height": 800
},
{
"url": "https://img.kwcdn.com/local-image/s132/211a2a4a582/4c721cd2-0faf-4c74-a192-25e91fa0a759_800x800.jpeg.format.jpg",
"width": 800,
"height": 800
}
],
"detailImages": [
"https://img.kwcdn.com/local-image/s132/211a2a4b8ce/6a7c68f6-bad5-4048-ac4e-0ef46444aef6_800x800.jpeg.format.jpg",
"https://img.kwcdn.com/local-image/s132/211a2a4b8ce/fc8af312-4a96-4d74-a10f-1d166e75e0aa_800x800.jpeg.format.jpg"
],
"additionalProperties": [
{
"name": "Propriedade sem fio",
"value": "Incluindo 2.4G/3G/4G/5G e outras funções",
"values": [
"Incluindo 2.4G/3G/4G/5G e outras funções"
]
},
{
"name": "Propriedades da bateria",
"value": "Bateria não recarregável",
"values": [
"Bateria não recarregável"
]
}
],
"shipping": {
"title": "Entregue por EYenjoy",
"content": "Entrega rápida de 2 dias",
"deliveryTime": "23 de Out.-5 de Nov.",
"timeDistribution": [
{
"name": "≤2 dias",
"percentage": 1570,
"percentageText": "15,7%"
},
{
"name": "3 dias",
"percentage": 3310,
"percentageText": "33,1%"
}
],
"rawDescriptions": [
"Padrão: R$10,00 ou GRÁTIS (se encomendar R$39,00+ deste vendedor) , Entrega rápida de 2 dias . Envio mais cedo em 1h.",
"Sem custos de importação para todos os itens do armazém local e sem custos extras na entrega"
]
},
"variants": [
{
"skuId": 77823465247520,
"goodsId": 604898057923527,
"specs": {
"Cor": "preto"
},
"imageUrl": "https://img.kwcdn.com/local-image/s132/211a2a4a582/d71ce1a4-2c03-4c87-8ad4-3a1f29811a37_800x800.jpeg.format.jpg",
"urlId": "1566666519519707810",
"stockQuantity": 752,
"soldQuantity": 2251,
"isOnSale": true,
"limitQuantity": 60,
"price": {
"amountMinor": 1602,
"amount": 16.02,
"display": "R$16,02",
"currency": "BRL",
"symbol": "R$"
},
"normalPrice": {
"amountMinor": 1602,
"amount": 16.02,
"display": "R$16,02",
"currency": "BRL",
"symbol": "R$"
},
"linePrice": {
"amountMinor": 2798,
"amount": 27.98,
"display": "27,98",
"currency": "BRL",
"symbol": "R$"
}
},
{
"skuId": 77823465280288,
"goodsId": 604898057923527,
"specs": {
"Cor": "Cor prateada."
},
"imageUrl": "https://img.kwcdn.com/local-image/s132/211a2a4b8ce/fc8af312-4a96-4d74-a10f-1d166e75e0aa_800x800.jpeg.format.jpg",
"urlId": "7817926775387522336",
"stockQuantity": 27,
"soldQuantity": 610,
"isOnSale": true,
"limitQuantity": 27,
"price": {
"amountMinor": 1564,
"amount": 15.64,
"display": "R$15,64",
"currency": "BRL",
"symbol": "R$"
},
"normalPrice": {
"amountMinor": 1564,
"amount": 15.64,
"display": "R$15,64",
"currency": "BRL",
"symbol": "R$"
},
"linePrice": {
"amountMinor": 2798,
"amount": 27.98,
"display": "27,98",
"currency": "BRL",
"symbol": "R$"
}
}
],
"seller": {
"mallId": 635517740007167,
"name": "EYenjoy",
"salesTip": "(25mil vendidos)",
"rating": 4.7,
"followers": 430,
"followersText": "430 Seguidores",
"productCount": 65,
"productCountText": "65 Itens",
"joinDate": null,
"tenure": null,
"information": null
},
"review": {
"rating": 4.8,
"reviewCount": 1008
},
"url": "https://www.temu.com/br/product-g-604898057923527.html",
"canonicalUrl": "https://www.temu.com/goods.html?goods_id=604898057923527",
"price": 15.64,
"priceDisplay": "R$15,64",
"currencyRaw": "R$",
"mainImage": {
"url": "https://img.kwcdn.com/local-image/s132/211a2a4a582/3aea8c89-769a-47c5-aa79-9eef91f54117_800x800.jpeg.format.jpg",
"width": 800,
"height": 800
},
"stock": 930,
"availability": "InStock",
"referencePrices": [
{
"skuId": "77823465247520",
"amountMinor": 2798,
"amount": 27.98,
"display": "27,98",
"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."
]
},
{
"skuId": "77823465280288",
"amountMinor": 2798,
"amount": 27.98,
"display": "27,98",
"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": {
"text": null,
"images": [
"https://img.kwcdn.com/local-image/s132/211a2a4b8ce/6a7c68f6-bad5-4048-ac4e-0ef46444aef6_800x800.jpeg.format.jpg",
"https://img.kwcdn.com/local-image/s132/211a2a4b8ce/fc8af312-4a96-4d74-a10f-1d166e75e0aa_800x800.jpeg.format.jpg"
],
"videos": [],
"properties": {
"Propriedade sem fio": [
"Incluindo 2.4G/3G/4G/5G e outras funções"
],
"Propriedades da bateria": [
"Bateria não recarregável"
],
"Bateria não recarregável": [
"Pilha AAA"
],
"Material": [
"Plástico"
],
"Orientação da mão": [
"Direita (mão)"
],
"Fonte de energia": [
"Alimentado por bateria"
],
"Modo de energia": [
"Alimentado por bateria"
],
"Tensão operacional": [
"≤36V"
],
"ID do item": [
"K6M2V4V3K5"
],
"Origem": [
"Guangdong, China"
]
}
},
"rankTag": "#1 MAIS BEM AVALIADO em Teclados, ratos e extras",
"preOrder": null,
"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
}
]
},
"returnPolicy": {
"title": "Devoluções gratuitas no prazo de 30 dias a partir da entrega",
"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 30 dias a partir da data de entrega."
],
"policyPath": "/return-and-refund-policy.html"
},
"fulfillment": {
"isLocalGoods": true,
"label": "Armazém local"
},
"categories": [
{
"optId": "1814",
"name": "Teclados, mouses e acessórios",
"parentOptId": "248"
}
],
"breadcrumb": [
{
"optId": "248",
"name": "Eletrônicos",
"parentOptId": null
},
{
"optId": "1814",
"name": "Teclados, mouses e acessórios",
"parentOptId": "248"
}
],
"enrichment": {
"seller": {
"status": "ok"
},
"categories": {
"status": "ok"
},
"breadcrumb": {
"status": "ok"
},
"sellerInformation": {
"status": "failed",
"reason": "invalid_response"
}
}
}
}Response fields
Field paths and types
{
"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 (optional; absent when not provided by the source)",
"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 (optional; absent when not provided by the source)",
"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 (optional; absent when not provided by the source)",
"data.seller.tenure.description": "string | null (optional; absent when not provided by the source)",
"data.preOrder": "object | null",
"data.preOrder.isPreOrder": "boolean (optional; absent when not provided by the source)",
"data.preOrder.title": "string (optional; absent when not provided by the source)",
"data.preOrder.message": "string | null (optional; absent when not provided by the source)",
"data.preOrder.terms[]": "string (optional; absent when not provided by the source)",
"data.preOrder.scope": "string (optional; absent when not provided by the source)",
"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 (optional; absent when not provided by the source)",
"data.seller.information.name": "string | null (optional; absent when not provided by the source)",
"data.seller.information.address": "string | null (optional; absent when not provided by the source)",
"data.seller.information.email": "string | null (optional; absent when not provided by the source)",
"data.seller.information.fields[].type": "string | null (optional; absent when not provided by the source)",
"data.seller.information.fields[].label": "string | null (optional; absent when not provided by the source)",
"data.seller.information.fields[].value": "string (optional; absent when not provided by the source)",
"data.enrichment.sellerInformation.status": "string",
"data.enrichment.sellerInformation.reason": "string (optional)"
}