Anúncios do TikTok (Top Ads e biblioteca)

Anúncios do TikTok (Top Ads e biblioteca): Anúncios de melhor desempenho (Top Ads) e biblioteca comercial do TikTok.

Atualizado em .

O que é Anúncios do TikTok (Top Ads e biblioteca) na APIcultura

Acesse Anúncios do TikTok (Top Ads e biblioteca) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Anúncios de melhor desempenho (Top Ads) e biblioteca comercial do TikTok. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Anúncios. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)O que fazPreço por chamadaRota
tiktok-top-anunciosTop Ads do TikTokR$ 0,02POST /v1/call/tiktok-top-anuncios
tiktok-biblioteca-buscarBuscar na biblioteca de anúnciosR$ 0,02POST /v1/call/tiktok-biblioteca-buscar
tiktok-biblioteca-anuncioDetalhe de um anúncioR$ 0,02POST /v1/call/tiktok-biblioteca-anuncio
tiktok-transparencia-buscarTransparência de anúnciosR$ 0,01POST /v1/call/tiktok-transparencia-buscar
tiktok-anuncios-da-empresaAnúncios de uma empresaR$ 0,10POST /v1/call/tiktok-anuncios-da-empresa

Top Ads do TikTok (tiktok-top-anuncios)

Anúncios de melhor desempenho, filtrados por país, período e setor. Preço: R$ 0,02 por chamada.

Schema de entrada de tiktok-top-anuncios

{
  "required": [
    "query"
  ],
  "properties": {
    "adLanguage": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "number"
    },
    "objective": {
      "type": "string",
      "maxLength": 2000
    },
    "orderBy": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "number"
    },
    "performanceRank": {
      "type": "string",
      "maxLength": 2000
    },
    "period": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "region": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Buscar na biblioteca de anúncios (tiktok-biblioteca-buscar)

Busca anúncios da biblioteca do TikTok por palavra-chave. Preço: R$ 0,02 por chamada.

Schema de entrada de tiktok-biblioteca-buscar

{
  "required": [],
  "properties": {
    "advertiserName": {
      "type": "string",
      "maxLength": 2000
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "region": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Detalhe de um anúncio (tiktok-biblioteca-anuncio)

Detalhes de um anúncio da biblioteca por ID. Preço: R$ 0,02 por chamada.

Schema de entrada de tiktok-biblioteca-anuncio

{
  "required": [
    "adId"
  ],
  "properties": {
    "adId": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Transparência de anúncios (tiktok-transparencia-buscar)

Busca no centro de transparência de anúncios do TikTok. Preço: R$ 0,01 por chamada.

Schema de entrada de tiktok-transparencia-buscar

{
  "required": [],
  "properties": {
    "advertiserId": {
      "type": "string",
      "maxLength": 2000
    },
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "days": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "region": {
      "type": "string",
      "maxLength": 2000
    },
    "sort": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Anúncios de uma empresa (tiktok-anuncios-da-empresa)

Anúncios do TikTok de uma empresa. Preço: R$ 0,10 por chamada.

Schema de entrada de tiktok-anuncios-da-empresa

{
  "required": [
    "company_domain"
  ],
  "properties": {
    "company_domain": {
      "type": "string",
      "maxLength": 2000
    },
    "influencer_ads": {
      "type": "boolean"
    }
  }
}

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "tiktok-top-anuncios", "input": {"query":"glasses"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/tiktok-top-anuncios \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"glasses"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,02 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Workflows que usam Anúncios do TikTok (Top Ads e biblioteca)

Experimente

Teste no playground interativo: Anúncios do TikTok (Top Ads e biblioteca) no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Anúncios do TikTok (Top Ads e biblioteca) é marca de seus respectivos donos, citada apenas para identificar a integração.