Facebook Ad Library Spy 📱 Meta Ads Intelligence — Only $10/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,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

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

Parameter	Type	Description
searchQuery	string	Required. Advertiser name, brand, or keyword to search
country	string	Country ISO code (default: BR). Examples: US, GB, DE
adType	string	all (default) or political_and_issue_ads
activeStatus	string	active (default), inactive, or all
maxAds	number	Max ads to extract (1–500, default: 50)
includeAiAnalysis	boolean	Enable Gemini AI competitive analysis (default: false)
proxyConfiguration	object	Proxy settings — residential proxy strongly recommended

Tips

• Use residential proxies — Meta aggressively blocks datacenter IPs
• 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,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

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

Parâmetro	Tipo	Descrição
searchQuery	string	Obrigatório. Nome do anunciante, marca ou palavra-chave
country	string	Código ISO do país (padrão: BR). Exemplos: US, GB, DE
adType	string	all (padrão) ou political_and_issue_ads
activeStatus	string	active (padrão), inactive ou all
maxAds	number	Máx. anúncios para extrair (1–500, padrão: 50)
includeAiAnalysis	boolean	Ativar análise competitiva com Gemini IA (padrão: false)
proxyConfiguration	object	Configuração de proxy — proxy residencial fortemente recomendado

Dicas

• Use proxies residenciais — a Meta bloqueia agressivamente IPs de datacenter
• 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:

Metric	Cost
Per ad scraped	$0.01
1,000 ads	$10.00
10,000 ads	$100.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