Meta Ad Library Click-to-WhatsApp Ads Scraper

Find every business that is paying Meta to send customers to its WhatsApp, in any country, in minutes.

Agencies, WhatsApp Business solution providers and lead-gen teams use it to build lists of advertisers that already have budget, a WhatsApp line and a sales flow: the warmest possible outbound list. Researchers use it to measure how Click-to-WhatsApp advertising spreads by market and vertical.

What you get

One row per ad. Fields that matter most:

Field	Example
page_name	Femme Cosmetics
page_categories	["Health & Beauty"]
page_like_count	16488
page_url	https://www.facebook.com/61563780793600/
cta_type	WHATSAPP_MESSAGE
cta_text	Enviar mensaje de WhatsApp
title	Escribenos para mas info
body	Dale a tus rizos la definición que merecen…
days_running	312
publisher_platform	["FACEBOOK","INSTAGRAM","WHATSAPP"]
ad_url	https://www.facebook.com/ads/library/?id=1490506798909645

Plus ad_archive_id, country_searched, search_term, page_id, whatsapp_link, whatsapp_phone (when the ad's link carries a number), caption, display_format, start_date, end_date, is_active, collation_count, images, videos, scraped_at, and the delivery estimates Meta publishes for some ads: impressions_text, reach_estimate, spend, currency, eu_total_reach, eu_age_gender_breakdown, eu_country_breakdown.

Why this one

• Ads targeted at the country, not just shown there. The Ad Library's country filter also returns foreign advertisers whose audience spilled over. This actor keeps only ads targeted at the country by default, so a Mexico list is Mexican businesses.
• Small and medium businesses on purpose. Filter advertisers by page likes to drop big brands and dynamic catalog ads, and keep the local clinic, store or school that actually needs a WhatsApp reply.
• Honest output. Fields that Meta does not publish stay null. Nothing is estimated or invented.
• Pay for what you keep. One event per ad saved. Scanned ads that the filter drops are free.

Example item:

{
  "ad_archive_id": "1490506798909645",
  "ad_url": "https://www.facebook.com/ads/library/?id=1490506798909645",
  "country_searched": "CO",
  "search_term": "whatsapp",
  "page_id": "427370767118409",
  "page_name": "Femme Cosmetics",
  "page_url": "https://www.facebook.com/61563780793600/",
  "page_categories": ["Health & Beauty"],
  "page_like_count": 16488,
  "cta_type": "WHATSAPP_MESSAGE",
  "cta_text": "Enviar mensaje de WhatsApp",
  "title": "Escribenos para mas info",
  "body": "😍 Dale a tus rizos la definición que merecen con SOY RIZOS…",
  "display_format": "VIDEO",
  "publisher_platform": ["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK", "MESSENGER", "WHATSAPP"],
  "start_date": "2025-10-30",
  "days_running": 312,
  "is_active": true
}

How to use it

1. Pick the countries (ISO codes: CO, MX, BR, ES, IN, ID…).
2. Pick search terms. whatsapp alone finds most Click-to-WhatsApp ads, because advertisers write it in the ad. Add vertical words to narrow: agenda tu cita, pide por whatsapp, delivery, cotiza.
3. Leave Only Click-to-WhatsApp ads on. Turn it off if you want every ad that matches the term.
4. Set Max ads per search to control cost. You pay per ad saved, not per ad scanned.

Advertiser page IDs can be passed instead of search terms to pull everything a specific page is running.

Why this and not the official API

The official Ad Library API only exposes political and social-issue ads. Commercial ads, and therefore their call-to-action type, are only visible in the public Ad Library website. This actor reads that public site, without logging in, and keeps only the ads whose button opens WhatsApp, including carousel cards.

Limits worth knowing

• The Ad Library does not publish the destination phone number of a Click-to-WhatsApp ad. You get the advertiser page, its category, size and the creative. Enrich the number from the page or the advertiser's website in a second step.
• Ad text is in the advertiser's language. Search terms match that text.
• Meta blocks datacenter IPs. The default proxy setting uses residential proxies; images and video files are not downloaded, so traffic stays small.
• Meta rotates the internal query id every few weeks. The actor learns the current one from the page itself and falls back to the last known value.

Pricing

Pay per event: one event per ad saved. Scanned ads that the WhatsApp filter drops are free.