TT TikTok Shop

API TikTok Shop: busca e detalhes de produtos

Busque produtos por palavra-chave com a API PLP ou consulte um produto por ID ou URL com a nova API PDP. Receba preços, imagens, variantes, estoque informado por SKU, vendedor e especificações em JSON. Descrições são incluídas quando disponíveis. Brasil, França e outros oito países, por 5 créditos por consulta.

GeckoAPI é uma API independente e não é afiliada, patrocinada ou endossada por TikTok Shop.

Começar grátis Ver documentação Testar detalhes de produto

Não precisa de cartão de crédito.

API TikTok Shop API preços TikTok Shop busca de produtos PLP PDP estoque por SKU inteligência de preços

PDP e PLP em BR, MX, JP, ID, MY, PH, SG, TH, VN e FR · 5 créditos por consulta. PLP: busca por keyword. PDP: productId ou URL completa do produto. Selecione o país com region. Preços podem incluir promoções; estoque e descrição dependem dos dados da origem.

// exemplo brasileiro verificado · 21 de outubro de 2026

Da busca no Brasil ao detalhe do produto

Comece pela PLP, selecione um item e preserve a região na PDP. Os valores em BRL são um snapshot observado, não uma oferta atual.

1. Buscar produtos (PLP)

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",
  "region": "BR",
  "page": 1
}'

Copie data.items[].productId para a chamada PDP e mantenha region: BR. Preserve IDs como strings.

2. Consultar o produto (PDP)

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": "pdp",
  "region": "BR",
  "productId": "1737210528686179693"
}'

Na consulta de 21/10/2026, a busca mostrou R$ 132,78 e a PDP retornou R$ 258,99 para o mesmo produto. Promoções e contexto podem diferir entre busca e detalhe. A descrição e o preço de referência vieram como null. Estoque é informado por variante; não o some para estimar vendas. Uma primeira tentativa PDP retornou timeout; uma nova chamada concluiu com dados.

Contrato de busca Contrato de produto Testar esta busca no sandbox

Duas APIs para acompanhar o TikTok Shop

NOVO · PDP

Detalhes de um produto

Envie o ID ou a URL do produto e selecione o país. Consulte imagens, vendedor, preços e estoque informado por variante, com descrição e especificações quando disponíveis.

5 créditos por consulta de produto.

Documentação PDP Testar produto

PLP

Busca de produtos

Encontre produtos por palavra-chave, país e página. Receba preços, lojas, imagens, avaliações e promoções. Use o productId de qualquer resultado para consultar seus detalhes no PDP.

5 créditos por página de resultados.

Documentação PLP Testar busca

// sample_response

Prévia da resposta do endpoint

Versão resumida do JSON retornado pela API de TikTok Shop , mostrando só os campos mais úteis para entender o formato da resposta. Alguns atributos opcionais podem vir como null.

Ver schema completo

Brasil · BRL · 21/10/2026

{
  "data": {
    "source": "tiktok.com",
    "region": "BR",
    "currency": "BRL",
    "productId": "1737210528686179693",
    "url": "https://www.tiktok.com/shop/br/pdp/1737210528686179693",
    "name": "Jogo de Panelas Dona Chefa 10 Peças Antiaderente Tampa de Vidro Marrom Escuro Choccino Preto Colmeia Dourado Prata Vanilla",
    "price": 258.99,
    "regularPrice": null,
    "description": null,
    "variants": [
      {
        "skuId": "1737210471965230445",
        "status": 1,
        "price": 258.99,
        "displayPrice": "R$ 258,99",
        "regularPrice": null,
        "displayRegularPrice": null,
        "currency": "BRL",
        "stock": 113,
        "purchaseLimit": 200,
        "minimumBuyQuantity": 0,
        "attributes": [
          {
            "name": "Cor",
            "value": "Marrom Escuro"
          }
        ]
      },
      {
        "skuId": "1737210471965295981",
        "status": 0,
        "price": 379.99,
        "displayPrice": "R$ 379,99",
        "regularPrice": null,
        "displayRegularPrice": null,
        "currency": "BRL",
        "stock": 188,
        "purchaseLimit": 200,
        "minimumBuyQuantity": 0,
        "attributes": [
          {
            "name": "Cor",
            "value": "Marrom Escuro c/ Grill (11 pçs)"
          }
        ]
      }
    ]
  }
}

// para_quem_serve

Para quem serve

Inteligência de preços

Compare preços de busca e consulte o preço de cada variante de um produto específico.

Catálogo e variantes

Enriqueça produtos com imagens, especificações, opções de cor e tamanho, vendedor e estoque informado por SKU.

Monitoramento de ofertas

Registre preço atual, preço de referência e desconto quando disponíveis.

// como_funciona

Como funciona

Crie sua conta

Acesse o dashboard e gere sua chave de API.

Chame a API

POST /v1/extract com a URL, target e tipo no body.

Receba JSON

Dados estruturados, padronizados e prontos para uso.

cURL · Brasil

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": "pdp",
  "region": "BR",
  "productId": "1737210528686179693"
}'

// integracao_ia

Integre com IA (MCP)

Conecte agentes de IA à GeckoAPI e seu chatbot responde com dados reais de TikTok Shop.

// exemplos de perguntas que seu agente pode responder:

→

"Busque panela antiaderente no TikTok Shop Brasil."

→

"Consulte as variantes e o estoque informado do produto 1737680778211985253 no Brasil."

Fluxo: Chatbot → Agente MCP → GeckoAPI → Resposta com dados

100 créditos iniciais

Comece a usar a API de TikTok Shop

Crie sua conta e comece grátis. Sem cartão necessário.

Criar conta e começar Ver exemplos de uso