API para TikTok: Busca de principais anúncios

Busque os principais anúncios em vídeo do TikTok Creative Center por palavra-chave, com filtros de objetivo de campanha, percentil de desempenho e janela de tempo.

POST/v1/run/tiktok.top_ads_search

Disponibilidade

100,00%

30d · 708 chamadas

Requisições

802

30d · semanal, últimas 12 sem.

Resposta

0,9s

mediana · 30d

Preços

Um preço, em dólares

Provedores

Tiger708 atendidas100,00% de disponibilidade748ms p50100,00% (708 chamadas)748ms (708 chamadas)708US$ 1,20/mil req.preço fixo

Teste

Faça sua primeira requisição

query*stringPalavra-chave para buscar nos principais anúncios em vídeo do TikTok Creative Center.limitinteger 1-20Número máximo de anúncios solicitados para esta página, de 1 a 20 (padrão 20).objectiveenumFiltro de objetivo de campanha. Omita para buscar em todos os objetivos.pageinteger 1-Número da página no provedor, a partir de 1 (padrão 1).performanceRankenumFaixa de percentil de desempenho do anúncio, em que top_1_20 são os 20% de melhor desempenho. Omita para buscar em todas as faixas.periodenumPeríodo de retrospectiva em dias (padrão 180).

Abrir emPrompt copiado

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",
        "cost": 19.99,
        "ctr": 12.5,
        "durationSeconds": 12.5,
        "height": 42,
        "image": "https://example.com/image.jpg",
        "industry": "general",
        "likes": 12500,
        "objective": "example",
        "videoUrl": "https://example.com/page",
        "width": 1024
      }
    ],
    "hasMore": true,
    "page": 29,
    "pageSize": 29,
    "total": 12500
  },
  "found": true,
  "reason": "not_found"
}

Interface da resposta

interface TiktokTopAdsSearchResponse {
  data: {
    ads: {
      adId: string;
      adTitle?: string;
      brandName?: string;
      cost?: number;
      ctr?: number;
      durationSeconds?: number;
      height?: number;
      image?: string;
      industry?: string;
      likes?: number;
      objective?: string;
      videoUrl?: string;
      width?: number;
    }[];
    hasMore: boolean;
    page: number;
    pageSize: number;
    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.top_ads_search

curl -X POST https://api.getanyapi.com/v1/run/tiktok.top_ads_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"glasses"}'

Campo	Tipo	Valor de exemplo
Corpo da requisição
query	string	"glasses"Palavra-chave para buscar nos principais anúncios em vídeo do TikTok Creative Center.
limit	integer	Número máximo de anúncios solicitados para esta página, de 1 a 20 (padrão 20).
objective	enum	Filtro de objetivo de campanha. Omita para buscar em todos os objetivos.
page	integer	Número da página no provedor, a partir de 1 (padrão 1).
performanceRank	enum	Faixa de percentil de desempenho do anúncio, em que top_1_20 são os 20% de melhor desempenho. Omita para buscar em todas as faixas.
period	enum	Período de retrospectiva em dias (padrão 180).
Resposta
data	object	Top-ad results and page metadata, or null when no matching ads were found.
data.ads	object[]	TikTok Creative Center top-ad records returned for this page. Populated whenever the provider has data for the entity.
data.ads[].adId	string	TikTok Creative Center ad material identifier. Populated whenever the provider has data for the entity.
data.ads[].adTitle	string	Title or primary copy shown for the ad. Populated whenever the provider has data for the entity.
data.ads[].brandName	string	Advertiser brand name when supplied by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.ads[].cost	number	TikTok Creative Center's relative cost ranking value for the ad. Populated whenever the provider has data for the entity.
data.ads[].ctr	number	TikTok Creative Center's click-through rate value for the ad. Populated whenever the provider has data for the entity.
data.ads[].durationSeconds	number	Video duration in seconds. Populated whenever the provider has data for the entity.
data.ads[].height	integer	Video height in pixels. Populated whenever the provider has data for the entity.
data.ads[].image	string	Signed video cover image URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.ads[].industry	string	TikTok Creative Center industry classification key. Populated whenever the provider has data for the entity.
data.ads[].likes	integer	Number of likes reported for the ad. Populated whenever the provider has data for the entity.
data.ads[].objective	string	TikTok Creative Center campaign objective key. Populated whenever the provider has data for the entity.
data.ads[].videoUrl	string	Signed 720p video asset URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.ads[].width	integer	Video width in pixels. Populated whenever the provider has data for the entity.
data.hasMore	boolean	Whether TikTok Creative Center reports another page of matching ads. Populated whenever the provider has data for the entity.
data.page	integer	One-based page number reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.pageSize	integer	Page size reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.total	integer	Total number of matching top ads reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
found	boolean	True when TikTok Creative Center returned at least one matching top 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ção	USD	US$ 0,0012
Preço /mil req.	USD	US$ 1,20

Dúvidas frequentes

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

O endpoint Busca de principais anúncios da AnyAPI para TikTok retorna dados de TikTok em JSON normalizado com uma chamada POST para /v1/run/tiktok.top_ads_search. Busque os principais anúncios em vídeo do TikTok Creative Center por palavra-chave, com filtros de objetivo de campanha, percentil de desempenho e janela de tempo. 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, 100,0% das chamadas ao endpoint Busca de principais anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 0,9 segundos, em 708 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 os principais anúncios em vídeo do TikTok Creative Center por palavra-chave, com filtros de objetivo de campanha, percentil de desempenho e janela de tempo. 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, 100,0% das chamadas ao endpoint Busca de principais anúncios da API para TikTok feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 0,9 segundos, em 708 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

Uma chave, uma carteira e
sua primeira chamada de TikTok.

Ganhe ~150 requisições grátis

API para TikTok: Busca de principais anúncios

Um preço, em dólares

Faça sua primeira requisição

Requisição, resposta e preço

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

Quanto custa o endpoint Busca de principais anúncios da API para TikTok?

O que o endpoint Busca de principais anúncios da API para TikTok retorna?

Quão confiável é o endpoint Busca de principais anúncios da API para TikTok?

Outros endpoints de TikTok

Uma chave, uma carteira esua primeira chamada de TikTok.

Uma chave, uma carteira e
sua primeira chamada de TikTok.