# Facebook Profile & Post Scraper (`headlessagent/facebook-profile-post-scraper`) Actor Scrape Facebook profiles and posts. Get clean JSON with profile stats, media URLs, captions, comments, tagged users, and more. - **URL**: https://apify.com/headlessagent/facebook-profile-post-scraper.md - **Developed by:** [Headless Agent](https://apify.com/headlessagent) (community) - **Categories:** Automation, Social media - **Stats:** 12 total users, 9 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.90 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Facebook Profile & Post Scraper Scrape Facebook **user profiles** and **posts** — no API key or login required. Get clean, formatted JSON with only the important fields. Supports profile URLs and post URLs as input. ### 🤔 What can Facebook Profile & Post Scraper do? This Actor lets you **extract public data from Facebook profiles and posts** in one place. Just provide profile URLs or post URLs and get structured results: 👤 Scrape **any public Facebook profile** — name, ID, bio, followers, likes, verification status, work, education, and more 📝 Extract **post data** — message text, hashtags, URLs, attachments (images/videos), reactions, and comments ❤️ Get **full reaction breakdowns** — total reactions plus per-type counts (Like, Love, Haha, Wow, etc.) 💬 Get **comments with replies** — author info, text, timestamps, and nested replies 🔗 Extract **external links** — Instagram, Twitter, YouTube, LinkedIn, website links from profiles 🖼️ Extract **profile photos** — recent photos from the profile's photo section 📦 Download results in **JSON, CSV, XML, or Excel** from the Apify Dataset 🦾 Integrate via **API, webhooks, SDKs** (Python & Node.js), or connect with tools like Zapier, n8n, Make, and more ### ✅ What data can I scrape from Facebook? #### From profiles: - 👤 Name, profile ID, profile URL - 🚻 Gender, verification status - 🖼️ Profile picture and cover photo URLs - 📊 Likes count, followers count, following count - 🏷️ Profile type (User or Page) - 📝 Bio / intro text - 🏢 Category (for Pages) - 💼 Work history and education - 🌍 Current city, joined date - 📞 Contact info (address, phone, email, business hours, price range) - 🔗 External links (Instagram, Twitter, website, etc.) - 📸 Recent photos #### From posts: - 🆔 Post ID, post URL - 👤 Author name and ID - 📝 Message text - 🏷️ Hashtags and URLs mentioned in the post - 📎 Attachments (images/videos with dimensions and captions) - 👥 Tagged actors (people/pages mentioned) - ❤️ Reactions summary — total count + per-type breakdown - 💬 Comments with author info, text, timestamps, reaction counts - 🔁 Nested replies on comments ### 🔧 How to scrape data from Facebook 1. [Create](https://console.apify.com/sign-up) a free Apify account. 2. Open Facebook Profile & Post Scraper. 3. Add **profile URLs** and/or **post URLs** — use any combination. 4. Optionally set a **proxy URL** to avoid rate limiting. 5. Click **Save & Start** and wait for the data to be extracted. 6. Download your data in JSON, CSV, XML, Excel, or access it via API. ### ⬇️ Input All fields are optional, but **at least one must be provided**. You can use them independently or together in a single run. | Field | Type | Description | |-------|------|-------------| | `profileUrls` | `string[]` | Facebook profile or page URLs (e.g. `https://www.facebook.com/zuck`) | | `postUrls` | `string[]` | Facebook post URLs (e.g. `https://www.facebook.com/zuck/posts/pfbid0...`) | | `proxy` | `string` | Optional proxy URL (`http://` or `socks5://` format) | #### Example input ```json { "profileUrls": [ "https://www.facebook.com/priscilla", "https://www.facebook.com/modernatx" ], "postUrls": [ "https://www.facebook.com/zuck/posts/pfbid0gScCMnNJMohdCuH7mU6P7e6z3GfyQF6zpMBZwCzPkmuJBXmEBuhgV7MssGAZwd1cl", ], "proxy": "http://user:pass@host:port" } ```` ### ⬆️ Output Results are pushed to the Apify Dataset. Each item has a `type` field (`"profile"` or `"post"`) so you can easily filter and process them. You can export data in JSON, CSV, XML, Excel, or access it programmatically via the Apify API. #### 👤 User profile data sample ```json { "type": "profile", "name": "Priscilla Chan", "id": "140", "url": "https://www.facebook.com/priscilla", "gender": "female", "verified": true, "profile_picture": "https://scontent.../244579863_10113957535838091_n.jpg?...", "cover_photo": "https://scontent.../487942515_10116449322702241_n.jpg?...", "likes": "3,078,658", "followers": "3M", "following": "133", "joined": "", "profile_type": "USER", "profile_intro_text": "Loves cooking and soft things.\r\n\r\ni like the food network, warm places, sun dried tomatoes and diet a&w. i am a simple creature. \r\n\r\ngoing to be in peru this summer.", "category": "Public figure", "address": "", "phone": "", "email": "", "business_hours": "", "price_range": "", "work": [ "Founder at Biohub", "Former 4th and 5th Grade Science Teacher at The Harker School", "Former Resident Physician at UCSF Benioff Children's Hospitals", "Former Director/Mentor at FASE" ], "education": [ "Studied at UCSF", "Studied at University of California, San Francisco", "Studied Biology at Harvard University", "Studied at Harvard University", "Went to Quincy High School" ], "current_city": "Lives in Palo Alto, California", "links": [], "photos": [ { "link": "https://scontent.../459334148_10115820537393041_n.jpg?...", "owner": { "type": "User", "id": "140" } } ] } ``` #### 🏢 Page profile data sample ```json { "type": "profile", "name": "Moderna, Inc. | Cambridge MA", "id": "100069948937913", "url": "https://www.facebook.com/modernatx", "gender": "neuter", "verified": true, "profile_picture": "https://scontent.../356888152_561191559555804_n.jpg?...", "cover_photo": "https://scontent.../484087947_932917982383158_n.png?...", "likes": "29,633", "followers": "29K", "following": "48", "joined": "", "profile_type": "PAGE", "profile_intro_text": "Our mission is to deliver the greatest possible impact to people through mRNA medicines.", "category": "Biotechnology Company", "address": "325 Binney Street, Cambridge, MA, United States, Massachusetts", "phone": "+1 617-714-6500", "email": "info@modernatx.com", "business_hours": "Always open", "price_range": "", "work": [], "education": [], "current_city": "", "links": [ { "title": "moderna_tx", "link": "https://www.instagram.com/moderna_tx", "icon": "https://static.xx.fbcdn.net/rsrc.php/yz/r/77rw1oPmYdg.webp" }, { "title": "moderna_tx", "link": "https://x.com/moderna_tx", "icon": "https://static.xx.fbcdn.net/rsrc.php/yz/r/77rw1oPmYdg.webp" }, { "title": "modernatx", "link": "https://youtube.com/@modernatx", "icon": "https://static.xx.fbcdn.net/rsrc.php/yz/r/77rw1oPmYdg.webp" }, { "title": "linkedin.com/company/modernatx", "link": "https://www.linkedin.com/company/modernatx/", "icon": "https://static.xx.fbcdn.net/rsrc.php/yH/r/e_4VJ-xHGZI.webp" }, { "title": "modernatx.com", "link": "https://www.modernatx.com/", "icon": "https://static.xx.fbcdn.net/rsrc.php/yF/r/iMZrDKSBhxd.webp" } ], "photos": [ { "link": "https://scontent.../536281947_1059130653095223_n.jpg?...", "owner": { "type": "User", "id": "100069948937913" } } ] } ``` #### 📝 Post data sample ```json { "type": "post", "url": "https://www.facebook.com/zuck/posts/pfbid0gScCMnNJMohdCuH7mU6P7e6z3GfyQF6zpMBZwCzPkmuJBXmEBuhgV7MssGAZwd1cl", "post_id": "10117392482806831", "author": { "name": "Mark Zuckerberg", "id": "4" }, "message": "Always a great time seeing these legends fight. Congrats Charles Oliveira, Caio Borralho, and Drew Dober. Max Holloway is always impressive. Best sport in the world.", "hashtags": [], "urls": [], "attachments": [], "actors": [ { "name": "Mark Zuckerberg", "id": "4", "url": "https://www.facebook.com/zuck", "profile_picture": "https://scontent.../632598281_10117314650513371_n.jpg?..." } ], "reactions_summary": { "total_reactions": 117904, "breakdown": [ { "type": "Like", "count": 97162 }, { "type": "Love", "count": 17152 }, { "type": "Care", "count": 2491 }, { "type": "Haha", "count": 484 }, { "type": "Wow", "count": 438 }, { "type": "Angry", "count": 129 }, { "type": "Sad", "count": 48 } ] }, "comments_summary": { "total_comments": 38056, "extracted_comments": 10 }, "comments": [ { "id": "892846226910003", "author": { "name": "Nick Jahr", "url": null, "profile_picture": "https://scontent.../475154618_10212244667187971_n.jpg?..." }, "text": "Charles didn't have a fight he had a hug fest", "created_time": 1772999046, "reactions": 338, "replies": [], "reply_count": 0 }, { "id": "1887297778684607", "author": { "name": "Delcio Marinho Goncalves", "url": "https://www.facebook.com/delciomarinho", "profile_picture": "https://scontent.../642784505_10215729309381652_n.jpg?..." }, "text": "Zuck's got the comments, but can he get a round with Max Holloway? #UFCLife", "created_time": 1772999161, "reactions": 82, "replies": [], "reply_count": 0 } ] } ``` ### 🔗 Integrations You can connect Facebook Profile & Post Scraper with almost any cloud service or web app through [Apify integrations](https://apify.com/integrations). Connect with **Zapier, n8n, Make, Slack, Google Sheets, Google Drive, Airbyte, GitHub**, and many more. You can also use [webhooks](https://docs.apify.com/integrations/webhooks) to trigger actions whenever a run finishes — for example, getting a notification or automatically processing the scraped data. ### 🦾 Using the Apify API The Apify [API](https://docs.apify.com/api/v2) gives you programmatic access to Facebook Profile & Post Scraper. You can start runs, fetch datasets, monitor execution, and integrate the scraper into your own workflows. - **Python**: Use the [`apify-client`](https://pypi.org/project/apify-client/) PyPI package - **Node.js**: Use the [`apify-client`](https://www.npmjs.com/package/apify-client) NPM package ### ❓ FAQ #### Can I scrape multiple profiles and posts in one run? Yes. Both input fields (`profileUrls`, `postUrls`) accept arrays. You can provide multiple items in each field, and even use both fields together in a single run. Each result will have a `type` field so you can tell them apart. #### What format are timestamps in? Post timestamps (`created_time`) are Unix timestamps (seconds since epoch). You can convert them to a human-readable date using any standard date library or online converter. Profile `joined` dates are returned as human-readable strings (e.g. "May 2004"). #### Does the scraper work with private profiles? No. The scraper can only extract data from **public Facebook profiles and posts**. Private profiles and posts behind privacy settings will not return data. #### Can I use a proxy? Yes. The optional `proxy` input field accepts HTTP and SOCKS5 proxy URLs. This is useful to avoid rate limiting or IP blocks when scraping at higher volumes. #### Why are some fields empty? Facebook profiles vary widely — not everyone fills in their work, education, phone, email, or other fields. The scraper extracts whatever is publicly available on the page. Empty strings or empty arrays mean that data wasn't found on the public profile. #### Is it legal to scrape Facebook? This scraper only extracts publicly available data. It does not access private accounts, login credentials, or any data behind authentication. However, scraped results could contain personal data protected by [GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation) and other regulations. Ensure you have a legitimate reason for scraping and consult legal counsel if unsure. See also Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). # Actor input Schema ## `profileUrls` (type: `array`): List of Facebook profile or page URLs to scrape (e.g. https://www.facebook.com/zuck). ## `postUrls` (type: `array`): List of Facebook post URLs or post IDs to scrape. ## `proxy` (type: `string`): Optional proxy URL (e.g. http://user:pass@host:port or socks5://user:pass@host:port). Useful to avoid rate limiting. ## Actor input object example ```json { "profileUrls": [ "https://www.facebook.com/priscilla", "https://www.facebook.com/modernatx" ], "postUrls": [ "https://www.facebook.com/zuck/posts/pfbid02EAPwtiasVZJNFhsH3SwFLmpjFr2iX5L6MWwJ1Xjqzwxi4iZ8ERNxr8E2QMqEYTdl" ] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "profileUrls": [ "https://www.facebook.com/priscilla", "https://www.facebook.com/modernatx" ], "postUrls": [ "https://www.facebook.com/zuck/posts/pfbid02EAPwtiasVZJNFhsH3SwFLmpjFr2iX5L6MWwJ1Xjqzwxi4iZ8ERNxr8E2QMqEYTdl" ] }; // Run the Actor and wait for it to finish const run = await client.actor("headlessagent/facebook-profile-post-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "profileUrls": [ "https://www.facebook.com/priscilla", "https://www.facebook.com/modernatx", ], "postUrls": ["https://www.facebook.com/zuck/posts/pfbid02EAPwtiasVZJNFhsH3SwFLmpjFr2iX5L6MWwJ1Xjqzwxi4iZ8ERNxr8E2QMqEYTdl"], } # Run the Actor and wait for it to finish run = client.actor("headlessagent/facebook-profile-post-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "profileUrls": [ "https://www.facebook.com/priscilla", "https://www.facebook.com/modernatx" ], "postUrls": [ "https://www.facebook.com/zuck/posts/pfbid02EAPwtiasVZJNFhsH3SwFLmpjFr2iX5L6MWwJ1Xjqzwxi4iZ8ERNxr8E2QMqEYTdl" ] }' | apify call headlessagent/facebook-profile-post-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=headlessagent/facebook-profile-post-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Profile & Post Scraper", "description": "Scrape Facebook profiles and posts. Get clean JSON with profile stats, media URLs, captions, comments, tagged users, and more.", "version": "1.0", "x-build-id": "1Vgcz30bKA3PHcsOR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/headlessagent~facebook-profile-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-headlessagent-facebook-profile-post-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/headlessagent~facebook-profile-post-scraper/runs": { "post": { "operationId": "runs-sync-headlessagent-facebook-profile-post-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/headlessagent~facebook-profile-post-scraper/run-sync": { "post": { "operationId": "run-sync-headlessagent-facebook-profile-post-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "profileUrls": { "title": "Profile URLs", "type": "array", "description": "List of Facebook profile or page URLs to scrape (e.g. https://www.facebook.com/zuck).", "items": { "type": "string" } }, "postUrls": { "title": "Post URLs", "type": "array", "description": "List of Facebook post URLs or post IDs to scrape.", "items": { "type": "string" } }, "proxy": { "title": "Proxy URL", "type": "string", "description": "Optional proxy URL (e.g. http://user:pass@host:port or socks5://user:pass@host:port). Useful to avoid rate limiting." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```