API para TikTok

API para TikTok: Busca na biblioteca de anúncios

Busque na Ads Library pública do TikTok por palavra-chave ou anunciante (anunciante, título, faixa de público, datas de veiculação, link da biblioteca e vídeo).

POST/v1/run/tiktok.ad_library_search
Disponibilidade
42,86%
30d · 42 chamadas
Requisições
42
30d · semanal, últimas 12 sem.
Resposta
2,6s
mediana · 30d

Preços

Um preço, em dólares

Provedores
Giraffe10 atendidas100,00% de disponibilidade2587ms p50US$ 1,20/mil req.preço fixoBadgerFora de serviço8 atendidas25,00% de disponibilidade2036ms p50US$ 0,50/mil req.preço fixo

Um provedor marcado como Fora de serviço parou de responder de forma confiável e foi retirado do rodízio, então suas chamadas vão para os outros. Ele volta sozinho assim que responder de forma confiável de novo.

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": [
      {
        "adId": "a1b2c3d4",
        "adTitle": "Example title",
        "brandName": "Acme Inc",
        "coverUrl": "https://example.com/page",
        "estimatedAudience": "example",
        "firstShownUtc": 42,
        "format": "example",
        "lastShownUtc": 42,
        "status": "active",
        "url": "https://example.com/page",
        "videoUrl": "https://example.com/page"
      }
    ],
    "hasMore": true,
    "nextCursor": "example",
    "total": 12500
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TiktokAdLibrarySearchResponse {
  data: {
    ads: {
      adId: string;
      adTitle: string;
      brandName: string;
      coverUrl: string;
      estimatedAudience: string;
      firstShownUtc?: number;
      format?: string;
      lastShownUtc?: number;
      status?: string;
      url?: string;
      videoUrl: string;
    }[];
    hasMore: boolean;
    nextCursor: string | null;
    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_library_search
curl -X POST https://api.getanyapi.com/v1/run/tiktok.ad_library_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"spotify"}'
CampoTipoValor de exemplo
Corpo da requisição
advertiserNamestringNome do anunciante cujos anúncios listar (ex.: Spotify). Informe advertiserName ou query, nunca os dois.
cursorstringCursor opaco vindo do nextCursor de uma resposta anterior. Omita na primeira página.
querystring"spotify"Palavra-chave para buscar nos títulos e no conteúdo dos anúncios (ex.: spotify). Informe query ou advertiserName, nunca os dois.
regionstringCódigo de região de duas letras da Commercial Content Library do TikTok, como DE, FR, GB ou IT. Cada região tem um conjunto diferente de anúncios. Omita para usar a região padrão da própria biblioteca, DE. A cobertura é a UE e o EEE; um código fora da UE, como US, não é atendido.
Resposta
dataobject
data.adsobject[]Populated whenever the provider has data for the entity.
data.ads[].adIdstringTikTok ad id. Populated whenever the provider has data for the entity.
data.ads[].adTitlestringAd title as shown in TikTok's ad library. Populated whenever the provider has data for the entity.
data.ads[].brandNamestringAdvertiser name on the ad.
data.ads[].coverUrlstringCover image URL of the ad's first video. Populated whenever the provider has data for the entity.
data.ads[].estimatedAudiencestringAudience size band TikTok publishes for the ad, for example "100K-200K".
data.ads[].firstShownUtcintegerUTC epoch timestamp in seconds (Unix time) when TikTok first showed the ad. Multiply by 1000 for a JS Date in milliseconds.
data.ads[].formatstringTikTok's creative format code for the ad, as the ad library reports it.
data.ads[].lastShownUtcintegerUTC epoch timestamp in seconds (Unix time) when TikTok last showed the ad. Multiply by 1000 for a JS Date in milliseconds.
data.ads[].statusstringTikTok's audit status code for the ad, as the ad library reports it.
data.ads[].urlstringLink to the ad's detail page in TikTok's public Ads Library.
data.ads[].videoUrlstringPlayable URL of the ad's first video. Populated whenever the provider has data for the entity.
data.hasMoreboolean
data.nextCursorstringOpaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.
data.totalinteger
foundboolean
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,0012
Preço /mil req.USDUS$ 1,20

Dúvidas frequentes

Sobre o endpoint Busca na biblioteca de anúncios da API para TikTok

O endpoint Busca na biblioteca de anúncios da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /v1/run/tiktok.ad_library_search. Busque na Ads Library pública do TikTok por palavra-chave ou anunciante (anunciante, título, faixa de público, datas de veiculação, link da biblioteca e vídeo). A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 42,9% das chamadas ao endpoint Busca na biblioteca de anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,6 segundos, em 42 chamadas medidas.

Custa a partir de US$ 1,20 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 Ads Library pública do TikTok por palavra-chave ou anunciante (anunciante, título, faixa de público, datas de veiculação, link da biblioteca e vídeo). 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, 42,9% das chamadas ao endpoint Busca na biblioteca de anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,6 segundos, em 42 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 de transparência de anúnciosa partir de US$ 0,50 /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