API para TikTok

API para TikTok: Busca de transparência de anúncios

Busque na Commercial Content Library da UE do TikTok por palavra-chave ou ID do anunciante.

POST/v1/run/tiktok.ad_transparency_search
Disponibilidade
99,92%
30d · 1.301 chamadas
Requisições
1.301
30d · semanal, últimas 12 sem.
Resposta
2,5s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "ads": [
      {
        "adTitle": "Example title",
        "advertiserName": "Example title",
        "estimatedAudience": "example",
        "firstShownUtc": 12.5,
        "format": "example",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "lastShownUtc": 12.5,
        "status": "active",
        "videoUrl": "https://example.com/page"
      }
    ],
    "hasMore": true,
    "nextCursor": "example",
    "offset": 42,
    "region": "CA",
    "total": 12500
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TiktokAdTransparencySearchResponse {
  data: {
    ads: {
      adTitle?: string;
      advertiserName?: string;
      estimatedAudience?: string;
      firstShownUtc?: number;
      format?: string;
      id: string;
      image?: string;
      lastShownUtc?: number;
      status?: string;
      videoUrl?: string;
    }[];
    hasMore: boolean;
    nextCursor: string | null;
    offset: number;
    region: string;
    total: number;
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/tiktok.ad_transparency_search
curl -X POST https://api.getanyapi.com/v1/run/tiktok.ad_transparency_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":30,"limit":20,"query":"nike","region":"DE"}'
CampoTipoValor de exemplo
Corpo da requisição
advertiserIdstringID do anunciante na Commercial Content Library do TikTok. Informe advertiserId ou query.
cursorstringCursor de busca vindo do nextCursor de uma resposta anterior.
daysinteger30Número de dias de histórico da Commercial Content Library a buscar, de 1 a 365. O padrão é 30.
limitinteger20Número máximo de anúncios a retornar, de 1 a 50. O padrão é 20. A cobrança é fixa por requisição.
offsetintegerDeslocamento dos resultados, a partir de zero. O padrão é 0.
querystring"nike"Palavra-chave para buscar na Commercial Content Library da UE do TikTok. Informe query ou advertiserId.
regionstring"DE"Código de região para a busca de transparência. O padrão é DE.
sortstringExpressão de ordenação do upstream. O padrão é last_shown_date,desc.
Resposta
dataobjectAd transparency search results and pagination, or null when no ads were found.
data.adsobject[]Commercial Content Library ad records returned for the search. Populated whenever the provider has data for the entity.
data.ads[].adTitlestringAd title as shown in TikTok's ad library.
data.ads[].advertiserNamestringAdvertiser display name associated with the ad. Populated whenever the provider has data for the entity.
data.ads[].estimatedAudiencestringEstimated audience size band the ad reached, as a range string.
data.ads[].firstShownUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was first shown. Populated whenever the provider has data for the entity.
data.ads[].formatstringCommercial Content Library creative format code for the ad. Populated whenever the provider has data for the entity.
data.ads[].idstringTikTok Commercial Content Library ad identifier. Populated whenever the provider has data for the entity.
data.ads[].imagestringSigned cover image URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity.
data.ads[].lastShownUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was last shown. Populated whenever the provider has data for the entity.
data.ads[].statusstringCommercial Content Library audit status code for the ad. Populated whenever the provider has data for the entity.
data.ads[].videoUrlstringSigned video asset URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity.
data.hasMorebooleanWhether the Commercial Content Library reports more matching ads. Populated whenever the provider has data for the entity.
data.nextCursorstringSearch cursor to pass as cursor on a subsequent request, or null when there is no next page. Populated whenever the provider has data for the entity.
data.offsetintegerZero-based result offset reported for this page.
data.regionstringRegion code applied to this transparency search. Populated whenever the provider has data for the entity.
data.totalintegerTotal number of matching ads reported by the Commercial Content Library. Populated whenever the provider has data for the entity.
foundbooleanTrue when TikTok's EU Commercial Content Library returned at least one ad.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,0005
Preço /mil req.USDUS$ 0,50

Dúvidas frequentes

Sobre o endpoint Busca de transparência de anúncios da API para TikTok

O endpoint Busca de transparência de anúncios da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /v1/run/tiktok.ad_transparency_search. Busque na Commercial Content Library da UE do TikTok por palavra-chave ou ID do anunciante. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 0,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,9% das chamadas ao endpoint Busca de transparência de anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,5 segundos, em 1.301 chamadas medidas.

Custa a partir de US$ 0,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque na Commercial Content Library da UE do TikTok por palavra-chave ou ID do anunciante. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 99,9% das chamadas ao endpoint Busca de transparência de anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,5 segundos, em 1.301 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de TikTok

Perfila partir de US$ 0,45 /mil req.Vídeos do perfila partir de US$ 0,70 /mil req.Transcrição de vídeoa partir de US$ 1,20 /mil req.Busca por palavra-chavea partir de US$ 0,70 /mil req.Vídeoa partir de US$ 0,45 /mil req.Comentários do vídeoa partir de US$ 0,70 /mil req.Busca de usuáriosa partir de US$ 0,70 /mil req.Anúncio da biblioteca de anúnciosa partir de US$ 1,20 /mil req.Busca na biblioteca de anúnciosa partir de US$ 1,20 /mil req.Dados demográficos do públicoa partir de US$ 18,00 /mil req.Respostas a comentáriosa partir de US$ 0,90 /mil req.Seguidoresa partir de US$ 0,95 /mil req.Seguindoa partir de US$ 0,95 /mil req.Vídeos da hashtaga partir de US$ 0,80 /mil req.Ao vivoa partir de US$ 1,20 /mil req.Fotosa partir de US$ 1,20 /mil req.Vídeos da playlista partir de US$ 1,20 /mil req.Contato do perfila partir de US$ 1,16 /mil req.Playlists do perfila partir de US$ 1,20 /mil req.Região do perfila partir de US$ 1,20 /mil req.Reposts do perfila partir de US$ 1,20 /mil req.Buscar hashtaga partir de US$ 1,20 /mil req.Buscar fotosa partir de US$ 1,20 /mil req.Sugestões de buscaa partir de US$ 0,95 /mil req.Buscar principais resultadosa partir de US$ 0,90 /mil req.Músicaa partir de US$ 0,90 /mil req.Vídeos da músicaa partir de US$ 0,90 /mil req.Busca de principais anúnciosa partir de US$ 1,20 /mil req.Feed em altaa partir de US$ 0,80 /mil req.Hashtags em altaa partir de US$ 1,20 /mil req.Download de vídeoa partir de US$ 0,90 /mil req.Transcrição de vídeo (versão completa)a partir de US$ 5,94 /mil minutos de áudio