Uma API de biblioteca de anúncios para anúncios da Meta, do Google e do TikTok

Todas as buscas usam a mesma chave, a mesma paginação e os mesmos códigos de erro, e respondem em JSON. Chame a API de um script ou do seu próprio app, ou deixe um agente de IA chamá-la pelo servidor MCP.

Anúncios da Meta, do Google e do TikTok em uma única API de bibliotecas de anúncios

Três conjuntos de dados de anúncios estão por trás da chave. Os anúncios da Meta cobrem o Facebook e o Instagram, e você os pesquisa por palavras no texto, na marca ou na página de destino. Os anúncios do Google vêm como anúncios de texto, imagem e vídeo, com um filtro para a rede em que rodaram, incluindo o YouTube. Um anúncio em vídeo leva à Central de Transparência de Anúncios do Google, onde ele é reproduzido. O TikTok traz anúncios e posts orgânicos em uma só busca, com visualizações, curtidas e compartilhamentos.

Cada anúncio aponta para a marca por trás dele: a página do anunciante e, quando existe, a loja Shopify vinculada a ela. Assim, você pode ir de um anúncio à loja e depois ao tráfego e aos mais vendidos da loja, com a mesma chave.

A lista completa está na Documentação da API. Se você prefere clicar a programar, as mesmas buscas funcionam na nossa ferramenta para espionar anúncios.

Obtenha uma chave de API e envie sua primeira requisição

1. Crie uma conta, confirme seu e-mail e escolha um plano pago: a API começa aí.
2. Abra Chaves de API no seu painel e crie uma chave. Copie-a na hora: ela só é mostrada uma vez.
3. Envie a chave em todas as requisições, no cabeçalho X-API-Key ou como bearer token.

Esta requisição encontra anúncios em vídeo de skincare que ainda estão no ar. Ela funciona em todos os planos pagos:

# Search Meta ads
curl "https://api.sellwinners.com/v1/ads?search=skincare&status=active&mediaType=video&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/ads Parâmetros e campos na documentação

A resposta traz um requestId, os anúncios em data e um objeto pagination. Em cada anúncio, media tem as URLs da miniatura e do vídeo, content o título, o texto, a chamada para ação e a página de destino, e advertiser a página que o veicula. metrics conta os duplicados e acrescenta o alcance e o investimento estimado.

Uma busca na Meta retorna um anúncio por marca, para que um anunciante não ocupe a página toda. Aumente maxAdsPerBrand (até 15, ou 0 para sem limite) para ver mais anúncios de cada uma.

Filtre pelo nome

Os anúncios da Meta aceitam 111 filtros nomeados, enviados como parâmetros de consulta em um GET ou como campos do corpo em um POST. Os mais comuns são minDaysRunning, countries, cta e minDuplicates. Um nome escrito errado recebe um 400 validation_failed que lista os nomes que o endpoint aceita, então um erro de digitação nunca retorna anúncios sem filtro.

# Search Meta ads with advanced filters
curl -X POST "https://api.sellwinners.com/v1/ads/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "skincare", "status": "active", "mediaType": "video", "countries": ["US"], "minDaysRunning": 30, "sortBy": "reach", "limit": 10}'

POST /v1/ads/query Parâmetros e campos na documentação

Alcance significa alcance na UE e no Reino Unido, e o investimento é sempre uma estimativa.

Todos os anúncios de uma marca

Encontre o id de anunciante da marca com GET /v1/lookup?q=allbirds.com&type=advertiser e depois liste os anúncios dela, os mais longevos primeiro:

# Meta ads of one advertiser
curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/ads?sortBy=longestRunning&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/advertisers/{advertiser_id}/ads Parâmetros e campos na documentação

Nossa página sobre a busca na biblioteca de anúncios da Meta mostra essa visão no app web, junto com o mix de formatos e as páginas de destino da marca.

Pagine os resultados

As buscas aceitam limit (até 100) e page ou offset. Para a próxima página, repita a requisição com page mais um, ou offset mais limit. Pare quando hasMore for false.

A paginação alcança os primeiros 5.000 resultados de uma busca (no caso de uma busca de anunciantes, os primeiros 100). Para ir além, adicione filtros ou mude a ordenação. A maior parte das pesquisas precisa do topo de uma lista bem filtrada, não da página 200.

Limites de requisições e créditos por plano

1 crédito = 1 resultado retornado: os detalhes de uma marca, um anúncio ou uma linha de uma lista. Um resultado vazio é gratuito. Erros, recusas, consultas de lookup e valores de filtro não custam nada, e uma chamada de ferramenta MCP custa os resultados que retorna, como a API. Todos em um espaço de trabalho, as chaves dele, a API e o servidor MCP compartilham um único conjunto de créditos e um único limite de requisições. Os créditos mensais são renovados às 00:00 UTC do dia 1º de cada mês; os créditos de recarga comprados na página de cobrança passam para os meses seguintes.

Toda resposta traz X-RateLimit-Remaining e X-Credits-Remaining, e X-Usage-Cost informa quanto a chamada custou, para que o seu código possa desacelerar antes de ser recusado. Acima do limite por minuto, você recebe 429 rate_limited com um Retry-After em segundos. Quando os créditos mensais e os créditos de recarga acabam, você recebe 402 insufficient_credits até os créditos serem renovados. GET /v1/usage mostra sua situação e não custa nada. Mais em limites de requisições e créditos.

Pesquise anúncios com um agente de IA pelo servidor MCP

O servidor MCP dá a um agente de IA os mesmos dados na forma de ferramentas, pelo transporte streamable HTTP, com sua chave de API no cabeçalho X-API-Key. A página do nosso Servidor MCP para agentes de IA tem a URL do servidor e configurações prontas para o Cursor, o VS Code e o Claude Desktop.

Para pesquisa de anúncios, o agente chama principalmente search_ads, scan_ad para abrir um anúncio, search_google_ads_library, search_tiktok_library e search_advertisers. Você pede com palavras simples: «Encontre anúncios em vídeo de skincare ainda no ar nos EUA, abra os três que estão há mais tempo no ar e liste os ganchos deles.» O agente transforma isso em filtros e chamadas. As regras dos planos são as mesmas da API.

Como isso difere da API da Biblioteca de anúncios da Meta

O SellWinners não é a API oficial da Meta. É um serviço independente, sem vínculo com a Meta. A Meta tem a sua própria API da Biblioteca de anúncios. Na página de ferramentas da Biblioteca de anúncios («Meta Ad Library tools», na Central de Transparência dela), a Meta diz que a API «permite uma análise mais aprofundada de anúncios sobre temas sociais, eleições ou política, assim como de anúncios veiculados na UE e em territórios associados» e fala em «usuários autorizados». Consultamos essa página em 19 de outubro de 2026.

As duas atendem a trabalhos diferentes. A API da Meta é operada pela Meta, sob as regras da Meta. O SellWinners é feito para a pesquisa em e-commerce:

• Uma chave para anúncios da Meta, do Google e do TikTok, com a mesma paginação, os mesmos erros e os mesmos limites.
• Anúncios ligados à marca por trás deles: a página do anunciante e a loja Shopify, quando existe.
• Filtros que ajudam a identificar anúncios que continuam no ar: dias no ar, duplicados, chamada para ação e posição do anúncio.
• Um servidor MCP, para que um agente de IA faça as buscas por você.
• Alcance dos anúncios exibidos na UE e no Reino Unido e um investimento estimado.

Se o seu trabalho é sobre anúncios políticos ou sobre temas sociais, a própria API da Meta foi feita para isso. Se você quer ver o que as marcas de e-commerce veiculam em três redes e quais lojas estão por trás dos anúncios, esse é o trabalho que o SellWinners faz.

Próximos passos

Comece com uma pergunta, por exemplo quais marcas de skincare mantêm o mesmo vídeo no ar há um mês. Execute-a uma vez com curl e depois leve-a para o seu código. Para se aprofundar em uma plataforma, abra a biblioteca de anúncios do TikTok, a biblioteca de anúncios do Google ou a busca de anunciantes. Para acompanhar um concorrente, o caminho é monitorar os anúncios de uma marca ao longo do tempo. Para o mercado como um todo, veja como as ferramentas para espionar anúncios se comparam.

Pesquisar anúncios no Explorar