GeckoAPI
PT EN
Entrar Testar URL

// docs

TikTok Shop PLP

Busca produtos do TikTok Shop Brasil com preços, imagens, avaliações, vendas, frete, cupons e promoções, quando informados pela origem. Custo: 5 créditos por requisição (uma página).

Tempo de resposta: Cada item é um produto, com dados comerciais extraídos da resposta mobile. Produtos repetidos entre blocos e cartões de vídeo/live são deduplicados por productId. Campos indisponíveis retornam null; listas sem dados retornam []. Preços são ofertas exibidas na busca e podem depender de cupons ou promoções; não são preços finais de checkout. A origem pode exigir verificação.

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

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

Chamada HTTP

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

Chamada MCP

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

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

tiktok_com_plp

Auth

Bearer ou X-API-Key

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

Possibilidades de input

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

Campo Tipo Status Regra Default Exemplo
keyword
Palavra-chave para buscas PLP. Em Google Search ela representa a query enviada ao Google; em Booking PLP é obrigatória; em outros PLPs pode substituir a URL.
 string Obrigatório Palavra-chave com 1 a 200 caracteres, sem contar espaços nas extremidades. - panela antiaderente
target
Fonte alvo da extração.
 enum Obrigatório Use tiktok.com. - tiktok.com
type
Tipo da extração: pdp, idp, plp, ilp, quote, review ou places.
 enum Obrigatório Use plp. - plp
page
Paginacao. Em PLP, inclusive Trivago, e no Reclame AQUI ILP inicia em 1; em review (MercadoLivre, Booking e Hoteis) inicia em 0. O Reclame AQUI ILP aceita ate a pagina 100.
 integer Opcional Inteiro de 1 a 20. Cada página consome 5 créditos. 1 1

Exemplos de request

Buscar produtos

Uma página por requisição, com tamanho solicitado de 10 produtos. A origem pode retornar menos produtos. Use nextPage enquanto hasMore for true, mantendo a mesma keyword. Limite: página 20.

Buscar produtos 
{
  "target": "tiktok.com",
  "type": "plp",
  "keyword": "panela antiaderente",
  "page": 1
}

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.source": "string",
  "data.type": "string",
  "data.query": "string",
  "data.region": "string",
  "data.currency": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.page": "number",
  "data.resultsPerPage": "number",
  "data.primaryResults": "number",
  "data.totalResults": "null",
  "data.hasMore": "boolean",
  "data.nextPage": "number | null",
  "data.nextCursor": "number | null",
  "data.items": "array<object>",
  "data.items[].position": "number",
  "data.items[].productId": "string",
  "data.items[].name": "string",
  "data.items[].sellerName": "string | null",
  "data.items[].shopId": "string | null",
  "data.items[].price": "number | null",
  "data.items[].displayPrice": "string | null",
  "data.items[].currency": "string | null",
  "data.items[].regularPrice": "number | null",
  "data.items[].displayRegularPrice": "string | null",
  "data.items[].discountPercentage": "number | null",
  "data.items[].discountText": "string | null",
  "data.items[].priceType": "string",
  "data.items[].rating": "number | null",
  "data.items[].soldCount": "number | null",
  "data.items[].soldCountText": "string | null",
  "data.items[].image": "object | null",
  "data.items[].image.url": "string (optional)",
  "data.items[].image.width": "number | null (optional)",
  "data.items[].image.height": "number | null (optional)",
  "data.items[].image.originalWidth": "number | null (optional)",
  "data.items[].image.originalHeight": "number | null (optional)",
  "data.items[].appUrl": "string | null",
  "data.items[].isAd": "boolean | null",
  "data.items[].isBrandAuthorized": "boolean | null",
  "data.items[].isMallProduct": "boolean | null",
  "data.items[].freeShipping": "boolean | null",
  "data.items[].labels": "array<object>",
  "data.items[].labels[].text": "string (optional)",
  "data.items[].labels[].type": "string | null (optional)",
  "data.items[].promotions": "array<object>",
  "data.items[].promotions[].type": "string (optional)",
  "data.items[].promotions[].id": "string | null (optional)",
  "data.items[].promotions[].discountText": "string | null (optional)",
  "data.items[].promotions[].couponType": "string | null (optional)",
  "data.items[].promotions[].fundedBy": "string | null (optional)",
  "data.items[].promotions[].hasCountdown": "boolean | null (optional)",
  "data.items[].promotionLabels": "array<string>",
  "data.items[].flashSale": "object | null",
  "data.items[].flashSale.startsAt": "string | null (optional; iso datetime)",
  "data.items[].flashSale.endsAt": "string | null (optional; iso datetime)",
  "data.items[].sellingPoints": "array<object>",
  "data.items[].sellingPoints[].text": "string (optional)",
  "data.items[].sellingPoints[].type": "string | null (optional)",
  "data.items[].sellingPoints[].category": "string | null (optional)",
  "data.items[].sellingPoints[].value": "number | null (optional)",
  "data.items[].contentTypes": "array<string>"
}

Exemplo de response

responseExample 
{
  "requestId": "7a0c0e3f-7d85-4d9b-a57d-730527fb8f40",
  "executionId": "6dfd2e49-e431-4375-8db1-f3b1eeefdf28",
  "data": {
    "source": "tiktok.com",
    "type": "plp",
    "query": "panela antiaderente",
    "region": "BR",
    "currency": "BRL",
    "extractedAt": "2026-09-08T16:00:05.414621+00:00",
    "page": 1,
    "resultsPerPage": 10,
    "primaryResults": 10,
    "totalResults": null,
    "hasMore": true,
    "nextPage": 2,
    "nextCursor": 10,
    "items": [
      {
        "position": 1,
        "productId": "1734492858853524507",
        "name": "Jogo De Panelas 10 Peças Antiaderente, Conjunto com, Panela, Caçarola, Frigideira, Fervedor E Utensilios De Nylon, Tampas De Vidro",
        "sellerName": "Loja do Chefe",
        "shopId": "7494391956289913883",
        "price": 154.99,
        "displayPrice": "R$154,99",
        "currency": "BRL",
        "regularPrice": 189.99,
        "displayRegularPrice": "R$ 189,99",
        "discountPercentage": 18,
        "discountText": "18%",
        "priceType": "displayed_offer",
        "rating": 4.3,
        "soldCount": 1912,
        "soldCountText": "1.9K sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/4588128ff7c0438cb61ed7cc9bab5cb6~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1254,
          "originalHeight": 1254
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221734492858853524507%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "FLASH_SALE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": true
          },
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "18%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "Flash sale"
        ],
        "flashSale": {
          "startsAt": "2026-09-08T03:00:00+00:00",
          "endsAt": "2026-09-09T02:59:59+00:00"
        },
        "sellingPoints": [],
        "contentTypes": [
          "live",
          "product"
        ]
      },
      {
        "position": 2,
        "productId": "1737092330571728141",
        "name": "Conjunto Jogo de Panelas 16 a 24 Antiaderente Teflon Panelas Grande Tampa de Vidro",
        "sellerName": "House Home BR",
        "shopId": "7494291074663023885",
        "price": 229.99,
        "displayPrice": "R$229,99",
        "currency": "BRL",
        "regularPrice": 350,
        "displayRegularPrice": "R$ 350,00",
        "discountPercentage": 34,
        "discountText": "34%",
        "priceType": "displayed_offer",
        "rating": 4.9,
        "soldCount": 1161,
        "soldCountText": "1.2K sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/0f3ce119648245e3a770fc7d654e13c4~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1200,
          "originalHeight": 1200
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737092330571728141%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "FLASH_SALE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": true
          },
          {
            "type": "VOUCHER",
            "id": "7679210149139203847",
            "discountText": null,
            "couponType": "min_spend_off",
            "fundedBy": "platform",
            "hasCountdown": null
          },
          {
            "type": "COUPON_APPLIED_PRICE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          },
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "34%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "Flash sale",
          "R$ 20 off"
        ],
        "flashSale": {
          "startsAt": "2026-09-08T03:00:00+00:00",
          "endsAt": "2026-09-09T02:59:59+00:00"
        },
        "sellingPoints": [],
        "contentTypes": [
          "live",
          "product"
        ]
      },
      {
        "position": 3,
        "productId": "1735783357946169129",
        "name": "Jogo De Panela Omega Cerâmica Premium 20 Peças - Antiaderente",
        "sellerName": "Yamonaco imports BQ",
        "shopId": "7494672478396647209",
        "price": 423.9,
        "displayPrice": "R$423,90",
        "currency": "BRL",
        "regularPrice": 699.99,
        "displayRegularPrice": "R$ 699,99",
        "discountPercentage": 39,
        "discountText": "39%",
        "priceType": "displayed_offer",
        "rating": 4.8,
        "soldCount": 2862,
        "soldCountText": "2.9K sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/64d8fb6428a24e01bf513c78a88e9888~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1254,
          "originalHeight": 1254
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221735783357946169129%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "FLASH_SALE",
            "id": "7683192783523350292",
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": true
          },
          {
            "type": "VOUCHER",
            "id": "7679210149139154695",
            "discountText": null,
            "couponType": "min_spend_off",
            "fundedBy": "platform",
            "hasCountdown": null
          },
          {
            "type": "COUPON_APPLIED_PRICE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          },
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "39%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "Flash sale",
          "R$ 80 off"
        ],
        "flashSale": {
          "startsAt": "2026-09-08T15:53:03+00:00",
          "endsAt": "2026-09-08T16:03:03+00:00"
        },
        "sellingPoints": [
          {
            "text": "57 repurchased",
            "type": "repurchase_num_in_180d",
            "category": "statistic",
            "value": 57
          }
        ],
        "contentTypes": [
          "live",
          "product"
        ]
      },
      {
        "position": 4,
        "productId": "1737211890663720924",
        "name": "Jogo de Panelas de Cerâmica Antiaderente 20 peças Mônaco",
        "sellerName": "MAAT BRAND",
        "shopId": "7494547214556694492",
        "price": 699.9,
        "displayPrice": "R$699,90",
        "currency": "BRL",
        "regularPrice": null,
        "displayRegularPrice": null,
        "discountPercentage": null,
        "discountText": null,
        "priceType": "displayed_offer",
        "rating": 4.8,
        "soldCount": 3303,
        "soldCountText": "3.3K sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/2bc4c3765fd74dffaaac19e7e0800dd7~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1254,
          "originalHeight": 1254
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737211890663720924%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": true,
        "freeShipping": true,
        "labels": [
          {
            "text": "Free shipping",
            "type": "8"
          }
        ],
        "promotions": [
          {
            "type": "FLASH_SALE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": true
          },
          {
            "type": "PRODUCT_FREE_SHIPPING",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "Flash sale"
        ],
        "flashSale": {
          "startsAt": "2026-09-08T03:00:00+00:00",
          "endsAt": "2026-09-09T02:59:59+00:00"
        },
        "sellingPoints": [],
        "contentTypes": [
          "product"
        ]
      },
      {
        "position": 5,
        "productId": "1736192981834171795",
        "name": "Jogo De Panelas Cerâmica Antiaderente , Fundo Triplo Compatível com Fogão de Indução, Gás e Elétrico Fácil de Limpar Múltiplas opções de tamanho e cor",
        "sellerName": "PKCR",
        "shopId": "7494533064388674963",
        "price": 462.46,
        "displayPrice": "R$462,46",
        "currency": "BRL",
        "regularPrice": 699.99,
        "displayRegularPrice": "R$ 699,99",
        "discountPercentage": 34,
        "discountText": "34%",
        "priceType": "displayed_offer",
        "rating": 4.7,
        "soldCount": 213,
        "soldCountText": "213 sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/f6c9524a28444e98ae79de83247e9bae~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1600,
          "originalHeight": 1600
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221736192981834171795%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "FLASH_SALE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": true
          },
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "34%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "Flash sale"
        ],
        "flashSale": {
          "startsAt": "2026-09-08T03:00:00+00:00",
          "endsAt": "2026-09-09T02:59:59+00:00"
        },
        "sellingPoints": [
          {
            "text": "In 1.8K+ people's carts",
            "type": "add_shopcart_num_180d",
            "category": "statistic",
            "value": 1811
          }
        ],
        "contentTypes": [
          "product"
        ]
      },
      {
        "position": 6,
        "productId": "1735536072442872996",
        "name": "Jogo De Panela Omega Cerâmica Premium 20 Peças - Antiaderente",
        "sellerName": "Yamonaco Imports",
        "shopId": "7494499848744502436",
        "price": 523.9,
        "displayPrice": "R$523,90",
        "currency": "BRL",
        "regularPrice": 699.99,
        "displayRegularPrice": "R$ 699,99",
        "discountPercentage": 25,
        "discountText": "25%",
        "priceType": "displayed_offer",
        "rating": 4.9,
        "soldCount": 4193,
        "soldCountText": "4.2K sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/7b9832e5cb054338b75552e05a313d20~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1254,
          "originalHeight": 1254
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221735536072442872996%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "FLASH_SALE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": true
          },
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "25%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "Flash sale"
        ],
        "flashSale": {
          "startsAt": "2026-09-08T03:00:00+00:00",
          "endsAt": "2026-09-09T02:59:59+00:00"
        },
        "sellingPoints": [],
        "contentTypes": [
          "video"
        ]
      },
      {
        "position": 7,
        "productId": "1735782347100489611",
        "name": "Jogo de Panelas 10 Peças Antiaderente com Tampa de Vidro Cor Cerâmica Kit Teflon ARS Aluminios",
        "sellerName": "ARS - Loja de Panelas",
        "shopId": "7494363854445381515",
        "price": 189.4,
        "displayPrice": "R$189,40",
        "currency": "BRL",
        "regularPrice": 345.9,
        "displayRegularPrice": "R$ 345,90",
        "discountPercentage": 45,
        "discountText": "45%",
        "priceType": "displayed_offer",
        "rating": 4,
        "soldCount": 497,
        "soldCountText": "497 sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/391f08c3a4a644ea90741fefdf2c9090~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1254,
          "originalHeight": 1254
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221735782347100489611%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "45%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [],
        "flashSale": null,
        "sellingPoints": [
          {
            "text": "In 2K+ people's carts",
            "type": "add_shopcart_num_180d",
            "category": "statistic",
            "value": 2095
          }
        ],
        "contentTypes": [
          "product"
        ]
      },
      {
        "position": 8,
        "productId": "1737088774208586813",
        "name": "Conjunto de Panelas Antiaderente Teflon Alumínio Grafite Fortlar - Escolha a Variação",
        "sellerName": "Marilar Presentes",
        "shopId": "7494224203616912445",
        "price": 66.78,
        "displayPrice": "R$66,78",
        "currency": "BRL",
        "regularPrice": 95.4,
        "displayRegularPrice": "R$ 95,40",
        "discountPercentage": 30,
        "discountText": "30%",
        "priceType": "displayed_offer",
        "rating": null,
        "soldCount": 4597,
        "soldCountText": "4.6K sold online",
        "image": {
          "url": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/cd8963409eeb01b2a0ce99d1b21b96c7~tplv-o3syd03w52-crop-webp:450:600.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 450,
          "height": 600,
          "originalWidth": 1200,
          "originalHeight": 1200
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737088774208586813%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": true,
        "labels": [
          {
            "text": "Free shipping",
            "type": "8"
          }
        ],
        "promotions": [
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "30%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          },
          {
            "type": "PRODUCT_FREE_SHIPPING",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "New in"
        ],
        "flashSale": null,
        "sellingPoints": [
          {
            "text": "In 451 people's carts",
            "type": "add_shopcart_num_180d",
            "category": "statistic",
            "value": 451
          }
        ],
        "contentTypes": [
          "video"
        ]
      },
      {
        "position": 9,
        "productId": "1737356355888711454",
        "name": "Conjunto Panelas 10 Pecas Antiaderente Modernas Alegrete",
        "sellerName": "ALEGRETE ALUMÍNIO",
        "shopId": "7494645228267276062",
        "price": 151.99,
        "displayPrice": "R$151,99",
        "currency": "BRL",
        "regularPrice": 289.99,
        "displayRegularPrice": "R$ 289,99",
        "discountPercentage": 48,
        "discountText": "48%",
        "priceType": "displayed_offer",
        "rating": null,
        "soldCount": 11,
        "soldCountText": "11 sold",
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/829e689b01514d38ae40a4f9a159cbb7~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1200,
          "originalHeight": 1200
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737356355888711454%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": true,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "FLASH_SALE",
            "id": "7683193451938039559",
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": true
          },
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "48%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "Flash sale"
        ],
        "flashSale": {
          "startsAt": "2026-09-08T15:56:45+00:00",
          "endsAt": "2026-09-08T16:02:45+00:00"
        },
        "sellingPoints": [],
        "contentTypes": [
          "product"
        ]
      },
      {
        "position": 10,
        "productId": "1737192942823376505",
        "name": "Jogo De Panelas Antiaderente 7 Peças Com Tampa De Vidro Bege",
        "sellerName": "FRIJI.TEX",
        "shopId": "7494775421751428729",
        "price": 129.4,
        "displayPrice": "R$129,40",
        "currency": "BRL",
        "regularPrice": 199.9,
        "displayRegularPrice": "R$ 199,90",
        "discountPercentage": 35,
        "discountText": "35%",
        "priceType": "displayed_offer",
        "rating": null,
        "soldCount": null,
        "soldCountText": null,
        "image": {
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/7b9692c341444d32b20ec1626cedbcd5~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001",
          "width": 400,
          "height": 400,
          "originalWidth": 1200,
          "originalHeight": 1200
        },
        "appUrl": "aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737192942823376505%22%5D%7D",
        "isAd": false,
        "isBrandAuthorized": false,
        "isMallProduct": null,
        "freeShipping": null,
        "labels": [],
        "promotions": [
          {
            "type": "VOUCHER",
            "id": "7681719939690137362",
            "discountText": null,
            "couponType": "min_spend_off",
            "fundedBy": "platform",
            "hasCountdown": null
          },
          {
            "type": "COUPON_APPLIED_PRICE",
            "id": null,
            "discountText": null,
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          },
          {
            "type": "PRICE_TOTAL_DISCOUNT",
            "id": null,
            "discountText": "35%",
            "couponType": null,
            "fundedBy": null,
            "hasCountdown": null
          }
        ],
        "promotionLabels": [
          "R$ 10 off"
        ],
        "flashSale": null,
        "sellingPoints": [],
        "contentTypes": [
          "product"
        ]
      }
    ]
  }
}

Referência completa de campos

Path Tipo Descrição Exemplo
data.currency string Moeda da busca: BRL. BRL
data.extractedAt string (iso datetime) Data e hora da coleta. 2026-09-08T16:00:05.414621+00:00
data.hasMore boolean Continuação informada pela origem, com cursor válido e dentro do limite de 20 páginas. true
data.items array<object> Produtos deduplicados por ID, na ordem da primeira aparição. Prioriza cartões com preço, depois cartões de produto, depois a versão mais recente. Preços e promoções são mantidos juntos a partir do cartão escolhido. Estruturas de renderização e rastreamento não fazem parte do resultado. [{"position":1,"productId":"1734492858853524507","name":"Jogo De Panelas 10 Peças Antiaderente, Conjunto com, Panela, Caçarola, Frigideira, Fervedor E Utensilios De Nylon, Tampas De Vidro","sellerName":"Loja do Chefe","shopId":"7494391956289913883","price":154.99,"displayPrice":"R$154,99","currency":"BRL","regularPrice":189.99,"displayRegularPrice":"R$ 189,99","discountPercentage":18,"discountText":"18%","priceType":"displayed_offer","rating":4.3,"soldCount":1912,"soldCountText":"1.9K sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/4588128ff7c0438cb61ed7cc9bab5cb6~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1254,"originalHeight":1254},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221734492858853524507%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":null,"labels":[],"promotions":[{"type":"FLASH_SALE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"18%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["Flash sale"],"flashSale":{"startsAt":"2026-09-08T03:00:00+00:00","endsAt":"2026-09-09T02:59:59+00:00"},"sellingPoints":[],"contentTypes":["live","product"]},{"position":2,"productId":"1737092330571728141","name":"Conjunto Jogo de Panelas 16 a 24 Antiaderente Teflon Panelas Grande Tampa de Vidro","sellerName":"House Home BR","shopId":"7494291074663023885","price":229.99,"displayPrice":"R$229,99","currency":"BRL","regularPrice":350,"displayRegularPrice":"R$ 350,00","discountPercentage":34,"discountText":"34%","priceType":"displayed_offer","rating":4.9,"soldCount":1161,"soldCountText":"1.2K sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/0f3ce119648245e3a770fc7d654e13c4~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1200,"originalHeight":1200},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737092330571728141%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":null,"labels":[],"promotions":[{"type":"FLASH_SALE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"VOUCHER","id":"7679210149139203847","discountText":null,"couponType":"min_spend_off","fundedBy":"platform","hasCountdown":null},{"type":"COUPON_APPLIED_PRICE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":null},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"34%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["Flash sale","R$ 20 off"],"flashSale":{"startsAt":"2026-09-08T03:00:00+00:00","endsAt":"2026-09-09T02:59:59+00:00"},"sellingPoints":[],"contentTypes":["live","product"]},{"position":3,"productId":"1735783357946169129","name":"Jogo De Panela Omega Cerâmica Premium 20 Peças - Antiaderente","sellerName":"Yamonaco imports BQ","shopId":"7494672478396647209","price":423.9,"displayPrice":"R$423,90","currency":"BRL","regularPrice":699.99,"displayRegularPrice":"R$ 699,99","discountPercentage":39,"discountText":"39%","priceType":"displayed_offer","rating":4.8,"soldCount":2862,"soldCountText":"2.9K sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/64d8fb6428a24e01bf513c78a88e9888~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1254,"originalHeight":1254},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221735783357946169129%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":null,"labels":[],"promotions":[{"type":"FLASH_SALE","id":"7683192783523350292","discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"VOUCHER","id":"7679210149139154695","discountText":null,"couponType":"min_spend_off","fundedBy":"platform","hasCountdown":null},{"type":"COUPON_APPLIED_PRICE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":null},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"39%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["Flash sale","R$ 80 off"],"flashSale":{"startsAt":"2026-09-08T15:53:03+00:00","endsAt":"2026-09-08T16:03:03+00:00"},"sellingPoints":[{"text":"57 repurchased","type":"repurchase_num_in_180d","category":"statistic","value":57}],"contentTypes":["live","product"]},{"position":4,"productId":"1737211890663720924","name":"Jogo de Panelas de Cerâmica Antiaderente 20 peças Mônaco","sellerName":"MAAT BRAND","shopId":"7494547214556694492","price":699.9,"displayPrice":"R$699,90","currency":"BRL","regularPrice":null,"displayRegularPrice":null,"discountPercentage":null,"discountText":null,"priceType":"displayed_offer","rating":4.8,"soldCount":3303,"soldCountText":"3.3K sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/2bc4c3765fd74dffaaac19e7e0800dd7~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1254,"originalHeight":1254},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737211890663720924%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":true,"freeShipping":true,"labels":[{"text":"Free shipping","type":"8"}],"promotions":[{"type":"FLASH_SALE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"PRODUCT_FREE_SHIPPING","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["Flash sale"],"flashSale":{"startsAt":"2026-09-08T03:00:00+00:00","endsAt":"2026-09-09T02:59:59+00:00"},"sellingPoints":[],"contentTypes":["product"]},{"position":5,"productId":"1736192981834171795","name":"Jogo De Panelas Cerâmica Antiaderente , Fundo Triplo Compatível com Fogão de Indução, Gás e Elétrico Fácil de Limpar Múltiplas opções de tamanho e cor","sellerName":"PKCR","shopId":"7494533064388674963","price":462.46,"displayPrice":"R$462,46","currency":"BRL","regularPrice":699.99,"displayRegularPrice":"R$ 699,99","discountPercentage":34,"discountText":"34%","priceType":"displayed_offer","rating":4.7,"soldCount":213,"soldCountText":"213 sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/f6c9524a28444e98ae79de83247e9bae~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1600,"originalHeight":1600},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221736192981834171795%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":null,"labels":[],"promotions":[{"type":"FLASH_SALE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"34%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["Flash sale"],"flashSale":{"startsAt":"2026-09-08T03:00:00+00:00","endsAt":"2026-09-09T02:59:59+00:00"},"sellingPoints":[{"text":"In 1.8K+ people's carts","type":"add_shopcart_num_180d","category":"statistic","value":1811}],"contentTypes":["product"]},{"position":6,"productId":"1735536072442872996","name":"Jogo De Panela Omega Cerâmica Premium 20 Peças - Antiaderente","sellerName":"Yamonaco Imports","shopId":"7494499848744502436","price":523.9,"displayPrice":"R$523,90","currency":"BRL","regularPrice":699.99,"displayRegularPrice":"R$ 699,99","discountPercentage":25,"discountText":"25%","priceType":"displayed_offer","rating":4.9,"soldCount":4193,"soldCountText":"4.2K sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/7b9832e5cb054338b75552e05a313d20~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1254,"originalHeight":1254},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221735536072442872996%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":null,"labels":[],"promotions":[{"type":"FLASH_SALE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"25%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["Flash sale"],"flashSale":{"startsAt":"2026-09-08T03:00:00+00:00","endsAt":"2026-09-09T02:59:59+00:00"},"sellingPoints":[],"contentTypes":["video"]},{"position":7,"productId":"1735782347100489611","name":"Jogo de Panelas 10 Peças Antiaderente com Tampa de Vidro Cor Cerâmica Kit Teflon ARS Aluminios","sellerName":"ARS - Loja de Panelas","shopId":"7494363854445381515","price":189.4,"displayPrice":"R$189,40","currency":"BRL","regularPrice":345.9,"displayRegularPrice":"R$ 345,90","discountPercentage":45,"discountText":"45%","priceType":"displayed_offer","rating":4,"soldCount":497,"soldCountText":"497 sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/391f08c3a4a644ea90741fefdf2c9090~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1254,"originalHeight":1254},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221735782347100489611%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":null,"labels":[],"promotions":[{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"45%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":[],"flashSale":null,"sellingPoints":[{"text":"In 2K+ people's carts","type":"add_shopcart_num_180d","category":"statistic","value":2095}],"contentTypes":["product"]},{"position":8,"productId":"1737088774208586813","name":"Conjunto de Panelas Antiaderente Teflon Alumínio Grafite Fortlar - Escolha a Variação","sellerName":"Marilar Presentes","shopId":"7494224203616912445","price":66.78,"displayPrice":"R$66,78","currency":"BRL","regularPrice":95.4,"displayRegularPrice":"R$ 95,40","discountPercentage":30,"discountText":"30%","priceType":"displayed_offer","rating":null,"soldCount":4597,"soldCountText":"4.6K sold online","image":{"url":"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/cd8963409eeb01b2a0ce99d1b21b96c7~tplv-o3syd03w52-crop-webp:450:600.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":450,"height":600,"originalWidth":1200,"originalHeight":1200},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737088774208586813%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":true,"labels":[{"text":"Free shipping","type":"8"}],"promotions":[{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"30%","couponType":null,"fundedBy":null,"hasCountdown":null},{"type":"PRODUCT_FREE_SHIPPING","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["New in"],"flashSale":null,"sellingPoints":[{"text":"In 451 people's carts","type":"add_shopcart_num_180d","category":"statistic","value":451}],"contentTypes":["video"]},{"position":9,"productId":"1737356355888711454","name":"Conjunto Panelas 10 Pecas Antiaderente Modernas Alegrete","sellerName":"ALEGRETE ALUMÍNIO","shopId":"7494645228267276062","price":151.99,"displayPrice":"R$151,99","currency":"BRL","regularPrice":289.99,"displayRegularPrice":"R$ 289,99","discountPercentage":48,"discountText":"48%","priceType":"displayed_offer","rating":null,"soldCount":11,"soldCountText":"11 sold","image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/829e689b01514d38ae40a4f9a159cbb7~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1200,"originalHeight":1200},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737356355888711454%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":true,"freeShipping":null,"labels":[],"promotions":[{"type":"FLASH_SALE","id":"7683193451938039559","discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"48%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["Flash sale"],"flashSale":{"startsAt":"2026-09-08T15:56:45+00:00","endsAt":"2026-09-08T16:02:45+00:00"},"sellingPoints":[],"contentTypes":["product"]},{"position":10,"productId":"1737192942823376505","name":"Jogo De Panelas Antiaderente 7 Peças Com Tampa De Vidro Bege","sellerName":"FRIJI.TEX","shopId":"7494775421751428729","price":129.4,"displayPrice":"R$129,40","currency":"BRL","regularPrice":199.9,"displayRegularPrice":"R$ 199,90","discountPercentage":35,"discountText":"35%","priceType":"displayed_offer","rating":null,"soldCount":null,"soldCountText":null,"image":{"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/7b9692c341444d32b20ec1626cedbcd5~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1200,"originalHeight":1200},"appUrl":"aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221737192942823376505%22%5D%7D","isAd":false,"isBrandAuthorized":false,"isMallProduct":null,"freeShipping":null,"labels":[],"promotions":[{"type":"VOUCHER","id":"7681719939690137362","discountText":null,"couponType":"min_spend_off","fundedBy":"platform","hasCountdown":null},{"type":"COUPON_APPLIED_PRICE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":null},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"35%","couponType":null,"fundedBy":null,"hasCountdown":null}],"promotionLabels":["R$ 10 off"],"flashSale":null,"sellingPoints":[],"contentTypes":["product"]}]
data.items[].appUrl string | null Link aweme://ec/pdp extraído da navegação mobile, preservando parâmetros do produto e removendo rastreamento e contexto de live. Não é uma URL web. aweme://ec/pdp?biz_type=0&requestParams=%7B%22product_id%22%3A%5B%221734492858853524507%22%5D%7D
data.items[].contentTypes array<string> Tipos de cartão em que o produto apareceu: product, video, live ou other. ["live","product"]
data.items[].currency string | null Moeda do preço; R$ é normalizado para BRL. BRL
data.items[].discountPercentage number | null Percentual de desconto informado, sem recalcular a partir dos preços. 18
data.items[].discountText string | null Texto original do desconto, por exemplo 18%. 18%
data.items[].displayPrice string | null Texto original do preço anunciado. R$154,99
data.items[].displayRegularPrice string | null Texto original do preço riscado. R$ 189,99
data.items[].flashSale object | null Período da oferta com contagem regressiva, quando disponível. {"startsAt":"2026-09-08T03:00:00+00:00","endsAt":"2026-09-09T02:59:59+00:00"}
data.items[].flashSale.endsAt string | null (optional; iso datetime) Fim da oferta, convertido de milissegundos Unix para UTC. 2026-09-09T02:59:59+00:00
data.items[].flashSale.startsAt string | null (optional; iso datetime) Início da oferta, convertido de milissegundos Unix para UTC. 2026-09-08T03:00:00+00:00
data.items[].freeShipping boolean | null Indicador de frete grátis da origem; null não significa frete pago. null
data.items[].image object | null Imagem principal do cartão. Não inclui ícones ou elementos visuais da interface. {"url":"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/4588128ff7c0438cb61ed7cc9bab5cb6~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001","width":400,"height":400,"originalWidth":1254,"originalHeight":1254}
data.items[].image.height number | null (optional) Altura da imagem exibida, em pixels. 400
data.items[].image.originalHeight number | null (optional) Altura original informada pela origem, em pixels. 1254
data.items[].image.originalWidth number | null (optional) Largura original informada pela origem, em pixels. 1254
data.items[].image.url string (optional) URL original da imagem principal. https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/4588128ff7c0438cb61ed7cc9bab5cb6~tplv-aphluv4xwc-crop-webp:400:400.webp?dr=15592&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=my2&from=1737278001
data.items[].image.width number | null (optional) Largura da imagem exibida, em pixels. 400
data.items[].isAd boolean | null Indicador de anúncio: null significa que a origem não informou. false
data.items[].isBrandAuthorized boolean | null Indicador de produto com autorização de marca informado pela origem. false
data.items[].isMallProduct boolean | null true quando a origem apresenta o selo Mall; null quando ausente. null
data.items[].labels array<object> Rótulos comerciais do cartão, como frete grátis. []
data.items[].labels[].text string (optional) Texto original do rótulo. N/A
data.items[].labels[].type string | null (optional) Código do tipo de rótulo da origem. N/A
data.items[].name string Título exibido no cartão. Jogo De Panelas 10 Peças Antiaderente, Conjunto com, Panela, Caçarola, Frigideira, Fervedor E Utensilios De Nylon, Tampas De Vidro
data.items[].position number Posição nesta página com o deslocamento de 10 por página; não representa um ranking global estável. 1
data.items[].price number | null Preço anunciado convertido em número decimal, sem cálculo de frete ou aplicação adicional de cupom. 154.99
data.items[].priceType string displayed_offer: oferta exibida na listagem, sem confirmação de SKU ou checkout. displayed_offer
data.items[].productId string ID do produto, preservado como string para evitar perda de precisão. 1734492858853524507
data.items[].promotionLabels array<string> Textos comerciais exibidos, como Flash sale, R$ 10 off e New in. ["Flash sale"]
data.items[].promotions array<object> Promoções estruturadas, como FLASH_SALE, VOUCHER e COUPON_APPLIED_PRICE. [{"type":"FLASH_SALE","id":null,"discountText":null,"couponType":null,"fundedBy":null,"hasCountdown":true},{"type":"PRICE_TOTAL_DISCOUNT","id":null,"discountText":"18%","couponType":null,"fundedBy":null,"hasCountdown":null}]
data.items[].promotions[].couponType string | null (optional) Tipo de cupom, como min_spend_off. As condições completas podem não estar presentes na listagem. null
data.items[].promotions[].discountText string | null (optional) Texto do desconto associado à promoção. null
data.items[].promotions[].fundedBy string | null (optional) Responsável pelo custo do cupom, quando informado, como platform. null
data.items[].promotions[].hasCountdown boolean | null (optional) Indicador de contagem regressiva da promoção. true
data.items[].promotions[].id string | null (optional) ID real da promoção como string; o marcador nativo -999 vira null. null
data.items[].promotions[].type string (optional) Tipo da promoção informado pela origem. FLASH_SALE
data.items[].rating number | null Nota de avaliação informada pela origem. 4.3
data.items[].regularPrice number | null Preço de referência riscado informado pela origem. 189.99
data.items[].sellerName string | null Nome do vendedor/loja informado pela origem. Loja do Chefe
data.items[].sellingPoints array<object> Destaques comerciais e estatísticas exibidas. O texto/tipo preserva o contexto e o período; não equivale a uma contagem total de avaliações. []
data.items[].sellingPoints[].category string | null (optional) Categoria nativa do destaque, como statistic. N/A
data.items[].sellingPoints[].text string (optional) Texto original do destaque. N/A
data.items[].sellingPoints[].type string | null (optional) Tipo nativo do destaque, como good_rating_num_180d. N/A
data.items[].sellingPoints[].value number | null (optional) Valor numérico explícito da origem; não é estimado a partir do texto. N/A
data.items[].shopId string | null ID da loja como string. 7494391956289913883
data.items[].soldCount number | null Contagem numérica de vendas informada; não é estimada a partir do texto abreviado. 1912
data.items[].soldCountText string | null Texto de vendas exibido, como 1.9K sold. 1.9K sold
data.nextCursor number | null Próximo cursor nativo ou null quando não houver continuação. Use page para solicitar a próxima página. 10
data.nextPage number | null Próxima página ou null quando não houver continuação. 2
data.page number Página solicitada, de 1 a 20. 1
data.primaryResults number Quantidade de produtos únicos retornados nesta página. 10
data.query string Palavra-chave consultada. panela antiaderente
data.region string Região fixa: BR. BR
data.resultsPerPage number Tamanho solicitado à origem: 10. 10
data.source string Fonte: tiktok.com. tiktok.com
data.totalResults null Total global indisponível na origem; retorna null. null
data.type string Tipo: plp. plp
executionId string (uuid) ID da execução. 6dfd2e49-e431-4375-8db1-f3b1eeefdf28
requestId string (uuid) ID da requisição HTTP. 7a0c0e3f-7d85-4d9b-a57d-730527fb8f40

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.