# Facebook URL To Id (`scrapeflux/facebook-url-to-id`) Actor Facebook URL to ID Scraper converts Facebook profile, page, group, and post URLs into their corresponding Facebook IDs. Quickly extract unique identifiers for data analysis, automation workflows, research, lead generation, and social media management tasks. - **URL**: https://apify.com/scrapeflux/facebook-url-to-id.md - **Developed by:** [ScrapeFlux](https://apify.com/scrapeflux) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ### Fcebook Url to Id ⚡ — Resolve Facebook URLs to Internal IDs (Pages, Groups, and Posts) If you have a list of Facebook URLs (like facebook page url to id links or group post permalinks) but need the underlying internal IDs for analysis or automation, that manual lookup gets painful fast. **Fcebook Url to Id** scrapes data from Facebook Pages, Groups, and Posts and resolves each URL into the IDs and metadata you can use right away. It also supports facebook profile url to id, facebook video url to id style inputs, and more—without you writing scraping code. Built for marketers, analysts, and researchers who want reliable facebook url to id mapping at scale. In one run, you can process an input list and get structured results into your dataset within seconds of launch. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "type": "group", "group_name": "Apify Community", "group_url": "https://www.facebook.com/groups/123456789012345/", "member_count": "12.3K members", "facebookId": "123456789012345", "profile_picture": "https://example.com/picture.jpg", "viewer_join_state": "NOT_JOINED", "viewer_forum_join_state": "NOT_JOINED", "theme_color": "#1877F2", "secondary_theme_color": "#0F5CA8", "creation_time": "2019-08-12T10:22:00+00:00", "seo_title": "Apify Community | Facebook", "extracted_at": "2026-06-07T12:34:56.789012", "source_url": "https://www.facebook.com/groups/123456789012345/" } ```` If a URL fails, the actor writes an error record to the dataset, for example: ```json { "url": "https://www.facebook.com/invalid-link", "error": "Non-200 status code: 404", "failed": true } ``` | Field | Type | What It Tells You | |---|---|---| | `type` | string | Lets you immediately tell whether the input was treated as a `page`, `group`, or `post`. | | `facebookId` | string | The resolved internal Facebook ID for your URL mapping workflow (facebook id lookup by url). | | `user_name` | string | null | The display name for Pages (useful for deduping and reporting). | | `group_name` | string | null | The group’s name when your input is a facebook group url to id link. | | `actor_name` | string | null | For posts, the author name (helps attribute content to the right profile). | | `source_url` | string | The exact URL used in the run after any redirects were followed (facebook permalink to id mapping). | | `description` | string | null | A page description field when available. | | `member_count` | string | null | Group size text (handy for prioritizing outreach). | | `reaction_count` | number | null | Post engagement metric extracted for quick sorting of content relevance. | | `comment_count` | number | null | Number of comments for post-level analysis. | | `share_count` | number | null | Share metric for posts. | | `extracted_at` | string | Timestamp for when this record was captured so you can track data freshness. | | `url` | string (error cases) | The URL that failed (written in error records). | | `error` | string (error cases) | The failure reason captured from the run logs. | | `failed` | boolean (error cases) | Indicates the record represents a failure instead of resolved data. | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "fbUrls": [ { "url": "https://www.facebook.com/share/p/1WsVQCnCRM/" }, "https://www.facebook.com/groups/123456789012345/" ] } ``` | Parameter | Required | What It Does | |---|---|---| | `fbUrls` | ✅ | Provide a list of Facebook URLs (Pages, Groups, or Posts) to resolve into internal IDs and metadata. | | ↳ `fbUrls[].url` | ✅ | A single Facebook URL to process (you can pass either objects with `url` or plain URL strings). | *** ### What It Does **Fcebook Url to Id** takes your list of Facebook URLs and outputs structured records with resolved internal IDs and related metadata for Pages, Groups, and Posts. #### Resolves Pages, Groups, and Posts into IDs Feed it a facebook url to id link and you get the matching `facebookId` plus the relevant fields for that object type. This includes page-level name and description data, group-level identity data, and post-level author and engagement fields. #### Works across multiple Facebook URL styles Whether your input looks like a facebook post url to id, facebook page url to id, facebook group url to id, or other common public permalink formats, the actor detects the URL type and returns the best matching structured result. #### Clean, consistent JSON records for analysis The output is written to your dataset in real time as JSON objects with predictable field names such as `type`, `facebookId`, `source_url`, and `extracted_at`. For posts, it includes metrics like `reaction_count`, `comment_count`, and `share_count`. #### Includes failure output for transparency If a URL can’t be processed, the actor still writes a dataset record containing the failing `url`, an `error` message, and `failed: true`. This makes it easy to audit which inputs need re-checking without losing everything from a run. #### Built-in resilience for real-world batches The actor includes retries and fallbacks to improve the chance of extracting data from public web pages. It also follows redirects so your records reflect the final resolved `source_url` used during extraction—important when dealing with share-style links like facebook permalink to id inputs. Overall, Fcebook Url to Id turns facebook URL lists into ID-ready datasets you can use immediately in your workflows. *** ### Why Fcebook Url to Id? There are plenty of ways to pull data from Facebook—here's why Fcebook Url to Id stands out. #### URL-to-ID mapping with structured context You don’t just get an ID—you also get `type`, names, descriptions, and post engagement fields where available. That means faster deduping and cleaner joins when you’re building reports, maintaining CRM lists, or enriching data pipelines with facebook id lookup by url. #### Dataset-friendly output with timestamps Every successful record includes `source_url` and `extracted_at`, so you can confidently track refresh cycles and data provenance. This is especially useful when you’re converting facebook url to numeric id values for repeated analysis runs. #### Transparent error records so you can troubleshoot quickly Instead of silently skipping failures, the actor pushes error records (with `url`, `error`, and `failed`) into your dataset. That keeps your data QA process straightforward when some inputs are invalid, inaccessible, or incomplete. *** ### Real-World Use Cases Here's how different teams put Fcebook Url to Id to work: **Marketing Agencies**\ A campaign lead receives spreadsheets full of mixed Facebook URLs for target brands, communities, and content. They run Fcebook Url to Id to resolve each facebook page url to id and facebook group url to id entry, then keep the results as an ID-enriched list for reporting and retargeting prep. Within minutes, they go from “raw links” to a dataset that’s consistent enough for downstream tooling. **Sales Teams**\ A BDR team wants to prioritize outreach based on group size and post engagement, but their CRM already expects IDs. They convert facebook url to numeric id inputs using Fcebook Url to Id, then sort by `member_count`, and use post metrics like `reaction_count` to identify high-signal actors. The result is fewer manual checks and faster prospect qualification. **Freelance Researchers**\ A researcher is compiling a dataset of communities and content sources for an investigation. They paste a list of facebook group url to id and facebook post url to id links, then export the dataset to keep `group_name`, `actor_name`, and engagement fields organized. Their workflow becomes repeatable—run, export, analyze—without writing custom code. **Data Engineers & Automation Specialists**\ A data engineer needs to normalize URL inputs into IDs so the rest of the pipeline can join across tables. They schedule runs and store results from Fcebook Url to Id, including `source_url` and `extracted_at` for traceability. The output becomes a reliable upstream step in a larger enrichment system, including facebook id lookup by url scenarios. **Content Analysts**\ A social media analyst wants to compare performance across posts but starts from a list of permalinks. By resolving facebook permalink to id style inputs and extracting `creation_time`, `comment_count`, and `share_count`, they can quickly build dashboards without spending time cleaning identifiers by hand. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Go to the actor page on Apify** — open it in the Apify Console: 2. **Enter your inputs** — add your Facebook URLs into the `fbUrls` field (each item can be an object with `url`, or a plain URL string). 3. **Configure proxy settings** — if you use Apify Proxy, enable it for better reliability on larger batches. 4. **Start the run** — launch the actor and monitor the live logs for progress. 5. **Open the Dataset tab** — view records as they’re pushed, including `type`, `facebookId`, and `source_url`. 6. **Export your results** — download as JSON, CSV, or Excel directly from the dataset. 7. **Re-run only what failed** — if any items produce an error record (`failed: true`), fix the inputs and run again. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Fcebook Url to Id fits directly into your existing workflow. Export formats include JSON, CSV, and Excel from the Apify dataset tab. If you’re enriching spreadsheets or building analysis datasets, this makes it easy to move from resolved IDs to joins and reporting. You can also integrate via Apify’s API access to pull results programmatically, and trigger downstream actions using webhooks when a run completes. For no-code automation, tools like Zapier or Make can connect your dataset outputs into CRMs and other systems. *** ### Pricing Fcebook Url to Id runs on Apify, which includes a **free tier** — no credit card needed to start. You can begin with a small test run to validate your facebook url to id and ID-resolution workflow before scaling up. If you need higher throughput, you’ll typically pay as you go based on Actor compute units (CU), and you can use Apify’s paid plans for heavier workloads. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Platform rate limits | Request pacing and resilience suitable for bulk URL processing. | | Redirects and share-style links | Redirects are followed so the resolved `source_url` is reflected in results. | | Scrape failures | Error records are pushed to the dataset with `url`, `error`, and `failed: true`. | | Incomplete extraction cases | If expected content isn’t found, some fields may be `null` while the record still indicates the `type`. | Limitations: the actor works with publicly accessible Facebook pages, groups, and posts. If content is restricted, login-gated, or not available publicly, you may receive error records or incomplete fields. For use cases outside public access, you may need a different data source. For enterprise-scale needs or custom configurations, reach out and we’ll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes—Apify offers a free tier so you can run a small test job before committing to paid usage. #### Do I need to log in or create an account on Facebook? No—this actor is designed to work with public web content. You only provide the URLs in `fbUrls`, and results are collected from publicly available pages. #### How accurate is the extracted data? Accuracy depends on what’s publicly available on each target URL at the time of extraction. The actor resolves `facebookId` and pulls metadata fields it can extract, such as names, descriptions, and (for posts) engagement metrics. #### How many results can I get per run? You can process a list of URLs in one run based on your Apify plan and compute limits. For large lists, the actor is built for dataset-friendly output as it processes items one by one. #### How fresh is the data? The dataset includes `extracted_at` for each record. This lets you treat your output as a point-in-time snapshot, then refresh by re-running when needed. #### Is this legal? Does it comply with GDPR / CCPA? You should use it in a way that complies with applicable laws and regulations. The actor processes publicly available data; you’re responsible for ensuring your collection and usage practices follow GDPR, CCPA, and relevant platform terms. #### Can I export to Google Sheets or Excel? Yes. You can export the dataset from Apify in common formats like JSON, CSV, or Excel, and then import into Google Sheets or other tools. #### Can I schedule this to run automatically? Yes. You can run actors on a schedule from Apify for automated, recurring dataset refreshes. #### Can I access results via the API? Yes. You can retrieve results programmatically using Apify’s API after the run completes. #### What happens when the actor encounters an error? If a URL can’t be processed, the actor pushes an error object into the dataset with `url`, an `error` message, and `failed: true`. This keeps failures visible and lets you rerun only the problematic inputs. *** ### Get Help & Use Responsibly Got a question about Fcebook Url to Id or a feature you'd like added? Reach out at . We welcome requests like expanding support for more Facebook URL formats or improving the richness of extracted post and group metadata. *** **Publicly available data** only: this actor extracts information from publicly accessible pages. It does not access private accounts, login-gated pages, or password-protected content. It’s your responsibility to comply with GDPR, CCPA, and Facebook/platform Terms of Service for your use case. For data removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # Actor input Schema ## `fbUrls` (type: `array`): List of Facebook URLs (Pages, Groups, or Posts) to resolve to IDs and metadata. ## Actor input object example ```json { "fbUrls": [ { "url": "https://www.facebook.com/share/p/1WsVQCnCRM/" } ] } ``` # 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 = { "fbUrls": [ { "url": "https://www.facebook.com/share/p/1WsVQCnCRM/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeflux/facebook-url-to-id").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 = { "fbUrls": [{ "url": "https://www.facebook.com/share/p/1WsVQCnCRM/" }] } # Run the Actor and wait for it to finish run = client.actor("scrapeflux/facebook-url-to-id").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 '{ "fbUrls": [ { "url": "https://www.facebook.com/share/p/1WsVQCnCRM/" } ] }' | apify call scrapeflux/facebook-url-to-id --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeflux/facebook-url-to-id", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook URL To Id", "description": "Facebook URL to ID Scraper converts Facebook profile, page, group, and post URLs into their corresponding Facebook IDs. Quickly extract unique identifiers for data analysis, automation workflows, research, lead generation, and social media management tasks.", "version": "1.0", "x-build-id": "WUy2keOAnVyPvHwMa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeflux~facebook-url-to-id/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeflux-facebook-url-to-id", "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/scrapeflux~facebook-url-to-id/runs": { "post": { "operationId": "runs-sync-scrapeflux-facebook-url-to-id", "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/scrapeflux~facebook-url-to-id/run-sync": { "post": { "operationId": "run-sync-scrapeflux-facebook-url-to-id", "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", "required": [ "fbUrls" ], "properties": { "fbUrls": { "title": "Facebook URLs", "type": "array", "description": "List of Facebook URLs (Pages, Groups, or Posts) to resolve to IDs and metadata.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```