WhatsApp Ads Scraper – Extract Click‑to‑WhatsApp Ads from Meta Ad Library | Apify Actor

WhatsApp Ads Scraper extracts WhatsApp‑surface ads — including Click‑to‑WhatsApp campaigns — from the Meta Ad Library by keyword, Facebook Page ID, or Ad Library URL, delivered as structured JSON or CSV.

🧠 Overview

This WhatsApp Ads Scraper is an Apify Actor purpose‑built for brands, agencies, and researchers tracking the fast‑growing world of Click‑to‑WhatsApp and WhatsApp Business advertising. Search by keyword (e.g., customer support), Facebook Page ID, or a pre‑filtered Ad Library URL, and the Actor collects every ad where WhatsApp is the reported publisher platform. You get structured rows with metadata, ad copy, timing, performance ranges, regional distribution, and demographics — exported to the Apify Dataset and OUTPUT JSON. Ideal for competitive intelligence on messaging ads, cross‑platform ad research, lead‑generation benchmarking, and conversational‑commerce monitoring without Meta developer approval.

✨ Features

• Extract WhatsApp‑surface ads (Click‑to‑WhatsApp, WhatsApp Business campaigns) only — filtered at the API layer.
• Search by keyword, Facebook Page ID, or full Meta Ad Library URL.
• Scrape unlimited ads per run with no hard maxResults cap.
• Capture ad metadata: page name, ad archive ID, publisher platforms, and run status.
• Harvest ad creative details: copy, CTA, landing URL (deep link to wa.me or api.whatsapp.com), and media.
• Track performance ranges: impressions, spend ranges, and regional coverage (when Meta discloses).
• Export per‑ad Dataset + OUTPUT JSON (summary + data.ads) for automation.
• Integrate with n8n, Make, Zapier, Google Sheets, Airtable via Apify webhooks and REST API.
• Monitor summary.status (SUCCESS / ERROR) plus typed error objects for debuggable pipelines.
• Skip Meta's restricted Ad Library API — no dev app, no token lifecycle, no review process.

🎯 Use Cases

• Click‑to‑WhatsApp Campaign Research: Reverse‑engineer high‑performing conversational ads — copy, CTAs, and wa.me landing formats — from global brands.
• Conversational‑Commerce Benchmarking: Measure how fashion, fintech, travel, and D2C brands deploy WhatsApp ads across regions.
• Competitive Intelligence for Agencies: Track every WhatsApp ad your clients' competitors are running alongside their Facebook and Instagram creatives.
• SaaS & Chatbot Vendor Outreach: Identify brands running WhatsApp ads as sales prospects for chatbot, CRM, or conversational AI tools.
• Regional Market Expansion: Use country=ALL or per‑region URLs to discover brands running WhatsApp ads in India, Brazil, LATAM, and the Middle East.
• Academic & Journalism Research: Build public datasets of messaging‑platform ads for media transparency and regulatory reporting.

⚙️ Input Parameters

Name	Type	Required	Description	Example
keyword	string	One of three	Brand or campaign search term.	"customer support"
pageId	string	One of three	Numeric Facebook Page ID.	"15087023549"
url	string	One of three	Full Meta / Facebook Ad Library URL.	"https://www.facebook.com/ads/library/?q=support&ad_type=all"
maxResults	integer	Yes	Target number of WhatsApp ads to collect.	100

📤 Output Example (JSON)

{
  "metadata": {
    "adArchiveId": "9876543210123456",
    "pageId": "15087023549",
    "pageName": "Acme Finance",
    "publisherPlatforms": ["WHATSAPP"]
  },
  "ad_content": {
    "body": "Chat with us on WhatsApp for instant loan approval.",
    "cta": "Send Message",
    "landingUrl": "https://wa.me/15551234567?text=I%20want%20a%20loan",
    "mediaUrls": ["https://scontent.../image.jpg"]
  },
  "timing": {
    "startDate": "2026-04-02",
    "endDate": null,
    "active": true
  },
  "performance": {
    "impressions": { "lowerBound": 10000, "upperBound": 15000 },
    "spend": { "lowerBound": 100, "upperBound": 499, "currency": "USD" }
  },
  "distribution": {
    "regions": ["IN", "AE", "SG"]
  }
}

📋 Output Data Schema

Every WhatsApp ad is returned as a structured object with these top‑level keys:

Key	Type	Fields
metadata	object	adArchiveId, pageId, pageName, publisherPlatforms (always includes WHATSAPP)
ad_content	object	body, title, cta, landingUrl (typically wa.me / api.whatsapp.com), mediaUrls[]
timing	object	startDate, endDate, active
performance	object	impressions.lowerBound, impressions.upperBound, spend.lowerBound, spend.upperBound, spend.currency
distribution	object	regions[], demographics.ageRange, demographics.gender
status	object	active, adDeliveryStartTime, adDeliveryStopTime
additional_info	object	Any extra fields Meta exposes (prefilled WhatsApp message text, disclaimers, etc.)

Run‑level OUTPUT also holds summary.status (SUCCESS / ERROR), summary.totalAds, summary.keyword, and timing metadata.

▶️ How to Use

1. Run on Apify Console: Open the WhatsApp Ads Scraper Actor page, click Try for free, enter a keyword (or Page ID / URL), set maxResults, and press Start.
2. Via API: Trigger runs via the Apify REST API or ApifyClient and stream the Dataset into your pipeline.
3. Via CLI: Run with the Apify CLI:

   $apify call scrapeio/whatsapp-scraper-premium --input='{"keyword":"loan","maxResults":100}'
   

🔗 API Example (JavaScript)

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('scrapeio/whatsapp-scraper-premium').call({
  keyword: 'customer support',
  maxResults: 80,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Collected ${items.length} WhatsApp ads`);
items.slice(0, 3).forEach(a => console.log(a.metadata.pageName, '→', a.ad_content.landingUrl));

📈 Why Use This WhatsApp Ads Scraper?

• Speed & Automation: Pull every WhatsApp ad for a brand or keyword in minutes — no manual Ad Library filtering or screenshotting.
• Platform‑Filtered Precision: The Actor applies a publisher‑platform filter so only WhatsApp placements show up in your Dataset.
• Conversational‑Commerce Focus: The only Apify Actor tuned specifically for Click‑to‑WhatsApp research — capture wa.me deep links, prefilled messages, and CTA metadata.
• Scale & Reliability: No maxResults cap; automatic pagination, retries, and typed errors keep large jobs predictable.
• Developer Integrations: Apify REST API, webhooks, scheduler, JavaScript + Python SDKs — push into your data warehouse, Slack, or Notion.
• No Meta Developer Account: Skip the Ad Library API approval queue — start researching in seconds.

❓ FAQ

Q: Is it legal to scrape the Meta Ad Library for WhatsApp ads? The Meta Ad Library is a public transparency product. Using it for research, journalism, or lawful competitive intelligence is widely accepted. You are responsible for complying with Meta's Terms, WhatsApp's Business Policy, and local data laws.

Q: Does this read private WhatsApp chats? No. The Actor only collects public Ad Library disclosures of ads whose publisher platform is WhatsApp. No messages, contacts, or private data are accessed.

Q: Why do I get fewer results than Facebook or Instagram runs? WhatsApp ads are a newer, less saturated surface. Widen your region (use a custom URL with country=ALL) and try broader keywords to increase yield.

Q: Does it support proxies? Yes — configure Apify Proxy (residential or datacenter) for stable large runs.

Q: What output formats are supported? Dataset exports to CSV, JSON, Excel, XML, and HTML. OUTPUT JSON stores a summary object plus data.ads array for full run context.

Q: How do I capture the WhatsApp deep link (wa.me)? Every ad's ad_content.landingUrl contains the public landing target — typically a wa.me or api.whatsapp.com URL with prefilled text.

Q: Can I filter by region? Yes — build a custom Ad Library URL with country=IN (or any code) and pass it via the url input. country=ALL returns all regions.

Q: Can this run on a schedule? Yes. Use the Apify scheduler to run daily or hourly and webhook new ads to Slack, HubSpot, or a database for live competitive alerts.

📣 Start Tracking WhatsApp Ads Today

Run the WhatsApp Ads Scraper on Apify now → and turn any brand or keyword into a live feed of Click‑to‑WhatsApp creatives, CTAs, and deep links.

---

🔗 Related Scrapers by ScrapeIO

Build cross‑platform ad‑intelligence pipelines with these companion Apify Actors:

• Facebook Ad Library Scraper — full Meta ads by keyword, Page ID, or URL.
• Instagram Ads Scraper — Instagram‑only ads with creative and copy.
• Facebook Ad Library Brand Finder — resolve brand names to verified Page IDs.
• Google Maps Scraper — local businesses, reviews, and contacts.
• Amazon Multi‑Marketplace Scraper — ASINs, prices, and rankings across 23 regions.
• Google News Scraper — headlines, sources, and publisher links by keyword.
• YouTube Video Downloader — download videos or audio to cloud storage.

---

FastAd — automation & growth tooling.