Pricing

Rating

Developer

Actor stats

Categories

Share

Facebook Ad Library Spy 📱 Meta Ads Intelligence — Only $0.15/1K Ads 💰

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

🇺🇸 English

Overview

Scrape ads from the Meta Ad Library — Facebook's official transparency tool. Monitor any advertiser's campaigns across Facebook, Instagram, Messenger, and Audience Network. Extract ad creatives, platform breakdown, spend estimates, campaign dates, and get optional AI-powered competitive analysis via Google Gemini.

Features

• Multi-Platform: Extract ads from Facebook, Instagram, Messenger & Audience Network
• Ad Intelligence: Get ad creatives, text, images, videos, formats, and status
• Spend Tracking: Estimated spend & impression ranges (political/social ads)
• Multi-Country: Search ads in any country using ISO codes (BR, US, GB, etc.)
• AI Analysis: Optional competitive strategy report powered by Google Gemini 2.0 Flash
• Active/Inactive Filter: Focus on currently running ads or analyze historical campaigns
• Infinite Scroll: Automatically loads all available ads up to your configured limit

Input Example

{
"searchQuery":"Nike",
"country":"BR",
"adType":"all",
"activeStatus":"active",
"maxAds":50,
"includeAiAnalysis":false
}

Output Example

{
"id":"a1b2c3d4e5f6",
"pageName":"Nike",
"adContent":"Just Do It. Encontre os melhores tênis e roupas Nike...",
"adFormat":"image",
"imageUrl":"https://scontent.xx.fbcdn.net/v/t45.1600-4/...",
"videoUrl":null,
"country":"BR",
"startDate":"Feb 10, 2026",
"status":"Active",
"platforms":"Facebook, Instagram",
"estimatedSpend":"1,000 - 5,000",
"impressions":"100,000 - 500,000",
"adLibraryId":"1234567890",
"adLibraryUrl":"https://www.facebook.com/ads/library/?id=1234567890"
}

Input Parameters

Tips

• Start without proxy to minimize cost; only add residential if Meta blocks the run or returns zero ads
• Start with maxAds: 20 to validate your search before scaling up
• Enable includeAiAnalysis for automated competitive reports (requires Gemini API key in actor environment)
• Political ads include spend & impression ranges; commercial ads may not
• Debug screenshots and HTML dumps are saved to Key-Value Store for troubleshooting

Use Cases

• Competitive Intelligence: Monitor competitor ad campaigns and creatives
• Market Research: Discover advertising trends in any country
• Brand Protection: Track unauthorized use of your brand in ads
• Political Transparency: Analyze political ad spending and messaging
• Creative Inspiration: Collect ad formats and copy for benchmarking

🇧🇷 Português

Visão Geral

Extraia anúncios da Biblioteca de Anúncios da Meta — a ferramenta oficial de transparência do Facebook. Monitore campanhas de qualquer anunciante no Facebook, Instagram, Messenger e Audience Network. Obtenha criativos, segmentação por plataforma, estimativas de gasto, datas de campanha e análise competitiva opcional com inteligência artificial via Google Gemini.

Funcionalidades

• Multi-Plataforma: Extraia anúncios de Facebook, Instagram, Messenger e Audience Network
• Inteligência de Anúncios: Obtenha criativos, textos, imagens, vídeos, formatos e status
• Rastreamento de Gastos: Estimativas de gasto e impressões (anúncios políticos/sociais)
• Multi-País: Busque anúncios em qualquer país usando códigos ISO (BR, US, GB, etc.)
• Análise com IA: Relatório estratégico competitivo opcional via Google Gemini 2.0 Flash
• Filtro Ativo/Inativo: Foque em anúncios em execução ou analise campanhas históricas
• Scroll Infinito: Carrega automaticamente todos os anúncios até o limite configurado

Exemplo de Entrada

{
"searchQuery":"Magazine Luiza",
"country":"BR",
"adType":"all",
"activeStatus":"active",
"maxAds":50,
"includeAiAnalysis":false
}

Exemplo de Saída

{
"id":"a1b2c3d4e5f6",
"pageName":"Magazine Luiza",
"adContent":"Ofertas imperdíveis! Até 50% OFF em eletrônicos...",
"adFormat":"image",
"imageUrl":"https://scontent.xx.fbcdn.net/v/t45.1600-4/...",
"videoUrl":null,
"country":"BR",
"startDate":"Jan 15, 2026",
"status":"Active",
"platforms":"Facebook, Instagram",
"estimatedSpend":"5,000 - 10,000",
"impressions":"500,000 - 1,000,000",
"adLibraryId":"9876543210",
"adLibraryUrl":"https://www.facebook.com/ads/library/?id=9876543210"
}

Parâmetros de Entrada

Dicas

• Comece sem proxy para minimizar custo; só adicione residencial se a Meta bloquear a execução ou voltar zero anúncios
• Comece com maxAds: 20 para validar sua busca antes de escalar
• Ative includeAiAnalysis para relatórios competitivos automatizados (requer chave Gemini API)
• Anúncios políticos incluem faixas de gasto e impressões; anúncios comerciais podem não incluir
• Screenshots de debug e dumps HTML são salvos no Key-Value Store para diagnóstico

Casos de Uso

• Inteligência Competitiva: Monitore campanhas e criativos dos concorrentes
• Pesquisa de Mercado: Descubra tendências de publicidade em qualquer país
• Proteção de Marca: Rastreie uso não autorizado da sua marca em anúncios
• Transparência Política: Analise gastos e mensagens em anúncios políticos
• Inspiração Criativa: Colete formatos e textos de anúncios para benchmarking

💰 Pricing / Preços

This actor uses Pay Per Event (PPE) pricing:

Example: Scraping 1,000 ads costs $150.00.

🔗 Data Source

All data comes from the Meta Ad Library — Meta's official transparency tool for viewing advertiser activity across Facebook, Instagram, Messenger, and Audience Network.

🔗 Related Actors

• Instagram Reels & Posts Scraper
• TikTok Viral Scanner
• YouTube Channel Scraper
• Reclame Aqui Scraper
• Google Maps BR Scraper
• Mercado Livre BR Scraper

📝 Changelog

• v1.1 — Improved extraction selectors, cookie consent handling, login wall bypass, infinite scroll reliability
• v1.0 — Initial release: Meta Ad Library scraping with AI analysis

License

ISC © 2026 Viral Analyzer Platform