Facebook Ads Lead Extractor — Emails, Phones & Contacts

What does Facebook Ads Lead Extractor do?

This Actor searches the Meta Ad Library (ads_archive, via the Meta Graph API) by keyword and country, collects the unique advertiser pages, and then enriches each page with publicly shown contact details: email, phone, website, physical address, Instagram username and followers. The result is a dataset you can export to CSV, JSON, Excel or JSONL.

Requirement: a Meta access token must be available as the META_ACCESS_TOKEN environment variable (Actor settings → Environment variables). Without it the run stops immediately with an error.

Contact fields are filled only when the information is publicly visible on the page; many pages have no email or phone, so some fields can be empty (null).

Use cases

• B2B prospecting: find businesses that currently pay for Facebook ads in a niche (dentists, restaurants, real estate…).
• Local lead generation: combine a category keyword with the address filter to target a city or region.
• Agency outreach: build lists of advertisers with websites and Instagram accounts.
• Market research: see who advertises on a topic in a given country and since when.

Input

Field	Type	Description	Default
keywords	string	Comma-separated search terms, e.g. dentist, lawyer	– (prefill dental clinic)
country	string	2-letter ISO code (see list below). ALL searches without a country restriction	FR
adStatus	string	ACTIVE, INACTIVE or ALL	ACTIVE
maxLeads	integer	Maximum number of unique pages to extract (1–1000)	100 (prefill 5)
matchAllKeywords	boolean	AND logic: keep only pages found for all keywords	false
nameContains	string	Keep only pages whose name contains this text (case-insensitive)	empty
addressContains	string	Keep only pages whose address contains this text (case-insensitive)	empty

Example input

{
  "keywords": "restaurant",
  "country": "BG",
  "adStatus": "ACTIVE",
  "maxLeads": 20,
  "addressContains": "sofia"
}

Keyword logic (OR / AND)

By default each keyword is searched independently and results are merged (OR). With matchAllKeywords: true the Actor fetches up to 5× maxLeads candidates per keyword and keeps only the pages present in every keyword search (AND). Use it for brand/place + category searches, e.g. formosa, restaurant.

Filters

nameContains and addressContains are applied after the Meta search. The address comes from the Facebook page profile, so pages without a public address are not matched by addressContains.

Output

Each dataset item is one advertiser page. Example (values anonymised):

{
  "Facebook URL": "https://www.facebook.com/1234567890",
  "Email": "contact@example.com",
  "Phone": "+000000000000",
  "Website": "https://example.com/",
  "Address": "1 Example Street, Example City, Country, 00000",
  "Followers": 1400,
  "Page ID": "1234567890",
  "Page Name": "Example Clinic",
  "Category": "Health/Beauty",
  "Facebook Likes": 1415,
  "Facebook Verification": "NOT_VERIFIED",
  "Country": "TR",
  "Entity Type": "person_profile",
  "Instagram Username": "exampleclinic",
  "Instagram Followers": 16537,
  "Instagram Verified": null,
  "All Emails": "contact@example.com",
  "All Phones": "+000000000000",
  "All Websites": "https://example.com/",
  "Platforms": "facebook, instagram",
  "Ad Creation Date": "2023-11-14",
  "Ad Start Date": "2023-11-15",
  "Keyword": "dental clinic",
  "Captured At": "2026-01-01T00:00:00Z"
}

How it works

1. Queries the Meta Ad Library by keyword + country with your access token.
2. Collects unique advertiser page IDs.
3. Reads each page's public profile data to extract email, phone, website and address.
4. Adds Instagram username/followers through the Ad Library typeahead lookup when available.
5. Applies the optional name/address filters and saves the dataset.

Configuration

• Set META_ACCESS_TOKEN in the Actor's environment variables.
• Default run options: 1024 MB memory, 3600 s timeout.
• Start with a small maxLeads (e.g. 5) to check the results, then increase it.

Pricing

The pricing model and price are shown on this Actor's Store page and in the Apify Console; they are not defined in the Actor code. Apify platform usage (compute) applies as usual. The Meta access token is your own.

Tips

• Use specific keywords (dental implants rather than dentist).
• Keep Ad Status = ACTIVE for advertisers currently spending money.
• Export as CSV for CRM import.
• Only publicly available data is collected; make sure your use of personal data (e.g. business emails and phones) complies with GDPR and local rules.

FAQ

Why are some Email/Phone fields empty? The Actor only returns what the page publicly shows. Many pages do not publish an email or phone.

The run fails immediately. Why? Most likely META_ACCESS_TOKEN is missing or the keywords input is empty. Check the run log.

Does the Actor log in to Facebook? No. It uses the Meta Graph API with your token and public page data only.

Can I get more than 1000 leads? maxLeads is capped at 1000 per run; run several searches with different keywords instead.

My country is missing. Open an issue on the Actor page and we will look at adding it.

Supported countries

Code	Country
🇦🇪 AE	United Arab Emirates
🇦🇷 AR	Argentina
🇦🇹 AT	Austria
🇦🇺 AU	Australia
🇧🇪 BE	Belgium
🇧🇭 BH	Bahrain
🇧🇴 BO	Bolivia
🇧🇷 BR	Brazil
🇧🇬 BG	Bulgaria
🇨🇦 CA	Canada
🇨🇭 CH	Switzerland
🇨🇮 CI	Ivory Coast
🇨🇱 CL	Chile
🇨🇲 CM	Cameroon
🇨🇴 CO	Colombia
🇨🇷 CR	Costa Rica
🇨🇿 CZ	Czech Republic
🇩🇪 DE	Germany
🇩🇰 DK	Denmark
🇩🇴 DO	Dominican Republic
🇩🇿 DZ	Algeria
🇪🇨 EC	Ecuador
🇪🇬 EG	Egypt
🇪🇸 ES	Spain
🇫🇮 FI	Finland
🇫🇷 FR	France
🇬🇧 GB	United Kingdom
🇬🇭 GH	Ghana
🇬🇷 GR	Greece
🇬🇹 GT	Guatemala
🇭🇰 HK	Hong Kong
🇭🇳 HN	Honduras
🇭🇷 HR	Croatia
🇭🇺 HU	Hungary
🇮🇩 ID	Indonesia
🇮🇪 IE	Ireland
🇮🇱 IL	Israel
🇮🇳 IN	India
🇮🇶 IQ	Iraq
🇮🇹 IT	Italy
🇯🇴 JO	Jordan
🇯🇵 JP	Japan
🇰🇪 KE	Kenya
🇰🇷 KR	South Korea
🇰🇼 KW	Kuwait
🇱🇧 LB	Lebanon
🇱🇺 LU	Luxembourg
🇲🇦 MA	Morocco
🇲🇽 MX	Mexico
🇲🇾 MY	Malaysia
🇳🇬 NG	Nigeria
🇳🇮 NI	Nicaragua
🇳🇱 NL	Netherlands
🇳🇴 NO	Norway
🇳🇿 NZ	New Zealand
🇵🇦 PA	Panama
🇵🇪 PE	Peru
🇵🇭 PH	Philippines
🇵🇱 PL	Poland
🇵🇹 PT	Portugal
🇵🇾 PY	Paraguay
🇶🇦 QA	Qatar
🇷🇴 RO	Romania
🇸🇦 SA	Saudi Arabia
🇸🇪 SE	Sweden
🇸🇬 SG	Singapore
🇸🇮 SI	Slovenia
🇸🇰 SK	Slovakia
🇸🇳 SN	Senegal
🇸🇻 SV	El Salvador
🇹🇭 TH	Thailand
🇹🇳 TN	Tunisia
🇹🇷 TR	Turkey
🇹🇼 TW	Taiwan
🇺🇦 UA	Ukraine
🇺🇾 UY	Uruguay
🇺🇸 US	United States
🇻🇪 VE	Venezuela
🇻🇳 VN	Vietnam
🇿🇦 ZA	South Africa

Keywords

Facebook ads leads, Meta ad library leads, Facebook advertiser emails, Facebook advertiser contacts, Meta ads email extractor, Facebook business leads, Meta ad library scraper, Facebook page email extractor, Instagram business contacts, Facebook ads prospecting, B2B leads Facebook, social media leads, advertiser contact info, Facebook marketing leads, Meta Graph API leads, Facebook page contacts, email scraper Facebook, phone number Facebook ads, website scraper Meta ads, lead generation Facebook, CRM import Facebook, sales leads Meta, Facebook ads intelligence, advertiser database, Facebook business directory, address scraper Facebook, business address extractor