# 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.

URL: https://apicultura.app/ferramentas/tiktok-biblioteca-anuncios/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=anuncios). 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.: `glasses`
- `region` (string, opcional, padrão "US")

### Schema de entrada de tiktok-top-anuncios

```json
{
  "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.: `Spotify`
- `query` (string, opcional), ex.: `spotify`
- `region` (string, opcional), ex.: `GB`

### Schema de entrada de tiktok-biblioteca-buscar

```json
{
  "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

```json
{
  "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.: `30`
- `limit` (integer, opcional, padrão 20, mín. 1, máx. 50), ex.: `20`
- `offset` (integer, opcional, padrão 0, mín. 0)
- `query` (string, opcional), ex.: `nike`
- `region` (string, opcional, padrão "DE"), ex.: `DE`
- `sort` (string, opcional, padrão "last_shown_date,desc")

### Schema de entrada de tiktok-transparencia-buscar

```json
{
  "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.com`
- `influencer_ads` (boolean, opcional, padrão false)

### Schema de entrada de tiktok-anuncios-da-empresa

```json
{
  "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:

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

## Exemplo de chamada HTTP

```bash
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)

- [Minerador de ofertas: ache os anúncios que já funcionam no seu nicho](/workflows/minerador-de-ofertas/)

## Experimente

Teste no playground interativo: [Anúncios do TikTok (Top Ads e biblioteca) no playground](/ferramentas/ferramenta.html?slug=tiktok-biblioteca-anuncios). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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