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 faz | Preço por chamada | Rota |
|---|---|---|---|
tiktok-top-anuncios | Top Ads do TikTok | R$ 0,02 | POST /v1/call/tiktok-top-anuncios |
tiktok-biblioteca-buscar | Buscar na biblioteca de anúncios | R$ 0,02 | POST /v1/call/tiktok-biblioteca-buscar |
tiktok-biblioteca-anuncio | Detalhe de um anúncio | R$ 0,02 | POST /v1/call/tiktok-biblioteca-anuncio |
tiktok-transparencia-buscar | Transparência de anúncios | R$ 0,01 | POST /v1/call/tiktok-transparencia-buscar |
tiktok-anuncios-da-empresa | Anúncios de uma empresa | R$ 0,10 | POST /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.
adLanguage(string, opcional, padrão "en")limit(integer, opcional, padrão 20, mín. 1, máx. 20)objective(string, opcional, padrão "traffic")orderBy(string, opcional, padrão "for_you")page(integer, opcional, padrão 1, mín. 1)performanceRank(string, opcional, padrão "top_1_20")period(integer, opcional, padrão 180)query(string, obrigatório), ex.:glassesregion(string, opcional, padrão "US")
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.
advertiserName(string, opcional), ex.:Spotifyquery(string, opcional), ex.:spotifyregion(string, opcional), ex.:GB
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.
adId(string, obrigatório), ex.:7648493525660270600
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.
advertiserId(string, opcional)days(integer, opcional, padrão 30, mín. 1, máx. 365), ex.:30limit(integer, opcional, padrão 20, mín. 1, máx. 50), ex.:20offset(integer, opcional, padrão 0, mín. 0)query(string, opcional), ex.:nikeregion(string, opcional, padrão "DE"), ex.:DEsort(string, opcional, padrão "last_shown_date,desc")
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.
company_domain(string, obrigatório), ex.:gymshark.cominfluencer_ads(boolean, opcional, padrão false)
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.