Facebook Scraper Pro

⚠️ This is the legacy version of Facebook Scraper Pro and may be deprecated in the future.

For new projects, please use Facebook Scraper Pro. It has the same features (Search, Profiles, Posts, and Comments scrapers), the same input format, and receives all new updates and fixes.

If you already use this Actor, it will keep working for now. We recommend switching to Facebook Scraper Pro at your convenience.

Facebook Scraper Pro is a powerful Apify actor designed to extract data from Facebook efficiently. It offers multiple scraping functions to gather data from Facebook searches, profiles, posts, and comments. Below is a detailed guide to help you understand and use this actor effectively.

Key Features

1. Facebook Search Scraper: Searches for specific keywords on Facebook and returns relevant posts.
2. Facebook Profiles Scraper: Extracts detailed information from Facebook profiles, including ID, name, friends count, likes count, location, gender, profile avatar, birthday, and profile posts.
3. Facebook Posts Scraper: Scrapes data from specific Facebook posts, including text, likes, comments, shares, and media.
4. Facebook Comments Scraper: Extracts comments from specific Facebook posts, including comment text, likes, replies, and author details.

Important Notes

• Actor Function: Specifies the scraping function to use (facebook_search_scraper, facebook_profiles_scraper, facebook_posts_scraper, facebook_comments_scraper).
• Rate Limiting: Use appropriate min_wait_time_in_sec and max_wait_time_in_sec to avoid blocking.
• Data Limits: Use the results_limit parameter to control the amount of data scraped.
• Strict Search: Use the strict_search parameter to only retrieve posts containing the exact keyword provided by keyword parameter.
• Follow Post Scraping: Use follow_post_scraping (default: true) to control whether SEARCH and PROFILE results are followed by an additional post-scraping step for more reliable/richer post details.

Input Schema

The input schema for the Facebook Scraper Pro actor is as follows:

{
    // enum for "function" ["facebook_search_scraper", "facebook_profiles_scraper", "facebook_posts_scraper", "facebook_comments_scraper"]
    "function": "facebook_search_scraper",
    "filter_by_recent_posts": true, // used in facebook_search_scraper
    "strict_search": false, // used in facebook_search_scraper
    "since": "1d", // used to fetch data in interval time (1d, 7d, 30d)
    "keyword": "BBC", // used in facebook_search_scraper

    "results_limit": 5, // limit number of posts or comments returned
    "min_wait_time_in_sec": 2, // minimum seconds to wait for each cursor.
    "max_wait_time_in_sec": 6, // maximum seconds to wait for each cursor.
    "cookies": [], // Optional Facebook user account cookies for improved scraping reliability and maintainability.
    "fetch_reaction_map": false, // When enabled, fetches reaction breakdown for video posts only.
    "follow_post_scraping": true, // When enabled, SEARCH and PROFILE results are followed by post scraping for more reliable post details.

    "profile_urls": [
        // used in facebook_profiles_scraper
        {
            "url": "https://www.facebook.com/profile.php?id=61568555420777"
        }
    ],
    "post_urls": [
        // used in facebook_posts_scraper
        {
            "url": "https://www.facebook.com/watch/?v=918725866988227"
        }
    ],
    "post_urls_for_comments": [
        // used in facebook_comments_scraper
        {
            "url": "https://www.facebook.com/watch/?v=918725866988227"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}

Output Schema

Facebook Search Scraper, Facebook Profiles Scraper, Facebook Posts Scraper

{
    // "author" only exists in Facebook Profile Scraper Responses
    "author": {
        "user_name": "Chief&Chill",
        "user_id": "61568555420777",
        "user_url": "https://www.facebook.com/profile.php?id=61568555420777",
        "avatar": "https://scontent.fcai20-6.fna.fbcdn.net/v/t39.30808-1/326769796_731573711877409_5775268283301149505_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=XXAYvfYQ_XgQ7kNvwFiOR3P&_nc_oc=AdneB4lCDPZ95GwkBc18yPBqBDx0KJBbBs3BtpBIarAhHXX_Xe04Bt93nF8-rPbu4mQ&_nc_zt=24&_nc_ht=scontent.fcai20-6.fna&_nc_gid=82BoXRmuCctRCyAwsu2f_w&oh=00_AfJG6Qx8GljgLqvbHK-0LgEBFqp11KvgYfhKtCPYQ84lDw&oe=682E9F53",
        "intro": "Organizing the world's information and making it universally accessible and useful.",
        "email": "for.loop.2020@gmail.com",
        "followers_count": "37K",
        "friends_count": null,
        "likes_count": "750",
        "following_count": null,
        "location": null,
        "gender": "UNKNOWN",
        "birthday": null,
        "created_at": "22 June 2020",
        "category": "Community"
    },
    "post_id": "122118274184618514",
    "action_id": "ZmVlZGJhY2s6MTIyMTE4Mjc0MTg0NjE4NTE0",
    "text": "No Man Sky !!\nCredits @qballgamingYT\n#gamingcommunity\n#gaming\n#besttime\n#funnymoments",
    "create_time": 1737231816,
    "post_url": "https://www.facebook.com/61568555420777/videos/8940928369328022/",
    "like_count": 47,
    "comment_count": 591,
    "share_count": 32,
    "view_count": 0,
    "reaction_map": [
        {
            "name": "Like",
            "count": 166,
            "parsed_count": "166"
        },
        {
            "name": "Love",
            "count": 19,
            "parsed_count": "19"
        },
        {
            "name": "Haha",
            "count": 5,
            "parsed_count": "5"
        },
        {
            "name": "Care",
            "count": 2,
            "parsed_count": "2"
        }
    ],
    "play_count": 0,
    "image_list": [],
    "video_list": [],
    "video_cover_image": [],
    "durationInSec": [],
    "type": "video",
    "author_username": "UNILAD",
    "author_user_id": "100064850344103",
    "author_profile_url": "https://www.facebook.com/uniladmag",
    "author_avatar": "https://scontent.fcai20-1.fna.fbcdn.net/v/t39.30808-1/...",
    "comments": []
}

Note: The reaction_map field contains reaction breakdown data when fetch_reaction_map is enabled. It is an array of objects with name, count, and parsed_count properties. Example:

{
    "reaction_map": [
        {
            "name": "Like",
            "count": 337,
            "parsed_count": "337"
        },
        {
            "name": "Sad",
            "count": 229,
            "parsed_count": "229"
        },
        {
            "name": "Care",
            "count": 185,
            "parsed_count": "185"
        }
    ]
}

Facebook Comments Scraper

{
    "action_id": "ZmVlZGJhY2s6OTAyOTM5NjE2MzgxODE1N185MDI5NDA2MTUzODE3MTU4",
    "comment_id": "9029406153817158",
    "gender": "FEMALE",
    "author_user_id": "100009355176494",
    "author_username": "Lillian Mamdouh",
    "author_profile_url": "https://www.facebook.com/lillian.mamdouh.7",
    "author_avatar": "",
    "text": "Up",
    "like_count": 0,
    "reply_count": 0,
    "create_time": 1738101623,
    "image_list": [],
    "video_list": [],
    "video_cover_image": [],
    "post": {
        "post_id": "9029396163818157",
        "post_url": "https://www.facebook.com/groups/5958702877554183/posts/9029396163818157/",
        "author_user_id": "pfbid036cJegrwq7rXF3Le6BCGDZd8nwuGw31mwx2smn8go2sbjRe23PocViB4H7DW4VgQ6l",
        "author_username": "Perihan Sameh",
        "author_profile_url": null,
        "author_avatar": ""
    },
    "input": "https://www.facebook.com/groups/5958702877554183/posts/9029396163818157/"
}