Facebook Page Contact Detail Scraper

How it works

This actor allows you to scrape Facebook pages contact details information such as addresses, category, email, mobile, likes, website, ratings, hours open, check-ins, and phone information and social platform links.

It now features a dual-crawler system:

1. CheerioCrawler (Default): Extremely fast, HTTP-only scraper. It extracts OpenGraph metadata, nested JSON schemas, and visible text without spinning up a browser. This method does not require cookies.
2. PuppeteerCrawler (Browser): Full browser automation via Puppeteer. Requires cookies, but can sometimes intercept hidden GraphQL queries and render complex dynamic content.

Features

• Flexible inputs: Supports scraping based on multiple inputs, whether it's a full URL (https://www.facebook.com/humansofnewyork), a plain string (humansofnewyork), or an array of request objects ([{"url": "villaharmonia.santateresa"}]).
• Deep Extraction: Pulls nested metadata, contact info, follower/following counts, profile pictures, cover photos, and business categories.
• Customizable: Choose between the lightning-fast HTTP approach or the robust browser approach based on your needs.

How to Use

1. Set Up: Ensure you have an Apify account and access to the Apify platform.
2. Specify the Facebook page URLs or usernames you want to scrape. You can add multiple inputs for a broader search scope.
3. (Optional) Configure proxy settings for enhanced reliability (residential proxies recommended).
4. Run the actor and obtain the extracted data in your preferred format (JSON, CSV, Excel).

Input Data

Here's a simple example of how to set up a search:

{
    "startUrls": [
        "humansofnewyork",
        "https://www.facebook.com/villaharmonia.santateresa",
        {
            "url": "https://www.facebook.com/VoltaRoofing"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
}

Output Structure

The output data typically includes:

[
  {
    "pageUrl": "https://www.facebook.com/humansofnewyork",
    "pageId": "1234567890",
    "title": "Humans of New York",
    "categories": [
      "Page",
      "Arts & Humanities Website"
    ],
    "info": [
      "Humans of New York. 17,164,742 likes · 159,261 talking about this. New York City, one story at a time. \nCreated by Brandon Stanton"
    ],
    "likes": 17164742,
    "followers": 17164742,
    "followings": 159261,
    "messenger": null,
    "address": null,
    "phone": null,
    "email": "hony@example.com",
    "website": "http://www.humansofnewyork.com",
    "rating": null,
    "profilePictureUrl": "https://scontent.fsjj1-1.fna.fbcdn.net/v/t39...",
    "coverPhotoUrl": "https://scontent.fsjj1-1.fna.fbcdn.net/v/t39...",
    "profilePhoto": "https://scontent.fsjj1-1.fna.fbcdn.net/v/t39..."
  }
]

Best Practices

• Rate Limiting: Respect Facebook's terms of service by avoiding overly frequent requests.
• Proxies: Facebook heavily limits Datacenter proxies. Use Residential proxies for the best success rate.
• Data Storage: Utilize Apify's data storage solutions for efficient data management.

🤖 For AI Agents & LLM Apps

Compact reference for AI agents calling this actor via the Apify MCP server or the Apify API (actor: memo23/facebook-page-contact-detail-scraper).

Purpose: Extract contact and profile details (email, phone, address, website, likes, followers, category, ratings, photos) from public Facebook pages, given page URLs or page names.

Minimal input:

{
  "startUrls": ["humansofnewyork"],
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] },
  "language": "en-US"
}

Output: one row per input page — pageUrl, pageId, title, categories, info, likes, followers, followings, messenger, address, phone, email, website, rating, profilePictureUrl, coverPhotoUrl, profilePhoto.

Behaviors an agent should know:

• startUrls (required) accepts full page URLs, bare page names (humansofnewyork), or {url} objects.
• Default HTTP (Cheerio) crawler needs no cookies; a browser mode exists for dynamic/hidden content.
• Use RESIDENTIAL proxies — Facebook heavily throttles datacenter IPs.
• language sets the Accept-Language header (default en-US); it controls the locale of the returned page text.
• No maxItems cap — one row per input page, so control volume via the number of startUrls.
• Fields the page does not publish (email, phone, address, rating) come back null.
• Pay-per-event billing — see the Pricing tab on the actor page.

⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Meta Platforms, Inc. or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.

The scraper accesses only publicly available Facebook page data — no authenticated endpoints, private profiles, or content behind the Facebook login wall. Users are responsible for ensuring their use complies with Facebook's Terms of Service, applicable data-protection law (GDPR, CCPA, etc.), and any contractual obligations of their own organization.

SEO Keywords

facebook scraper, facebook page scraper, scrape facebook, facebook contact scraper, facebook page details scraper, facebook.com scraper, facebook email scraper, facebook phone number scraper, facebook business page scraper, social media data scraper, page contact extraction, lead generation scraper, business contact data, facebook page analytics, local business data, Apify facebook scraper