# Facebook Url To Id (`scraperoka/facebook-url-to-id`) Actor 🔗 Turn Facebook URL into an ID instantly with UrlToId! Extract key Facebook profile/page identifiers fast and accurately for research, outreach, and automation. ⚡ Boost productivity and streamline workflows—no hassle, just results. - **URL**: https://apify.com/scraperoka/facebook-url-to-id.md - **Developed by:** [Scraperoka](https://apify.com/scraperoka) (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 $0.01 / 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 🎯 Manually resolving Facebook Pages, Groups, and Posts from links into usable internal IDs and metadata wastes hours you don’t have. **Fcebook Url to Id** scrapes data from Facebook Pages, Groups, and Posts and resolves them to IDs and useful fields—so you can build clean datasets faster. Use **Fcebook Url to Id** (facebook url to id, facebook profile url to id) for marketers, recruiters, and growth teams who need thousands of records in minutes. --- ### What You Get: Sample Output Here's a sample record from a single run: ```json { "type": "group", "group_name": "Example Community Group", "group_url": "https://www.facebook.com/groups/1234567890/", "member_count": "25K members", "facebookId": "1234567890", "profile_picture": "https://example-cdn.com/profile.jpg", "viewer_join_state": "NOT_JOINED", "viewer_forum_join_state": "NOT_JOINED", "theme_color": "#ffffff", "secondary_theme_color": "#f0f0f0", "creation_time": "2021-01-01T00:00:00Z", "seo_title": "Example Community Group | Facebook", "extracted_at": "2026-06-03T12:34:56.789012", "source_url": "https://www.facebook.com/groups/1234567890/" } ```` | Field | Type | What It Tells You | |---|---|---| | `type` | string | Whether the resolved link is a `page`, `group`, or `post` record | | `facebookId` | string | The resolved Facebook numeric ID from the provided URL (facebook page id from url / extract facebook id from url) | | `user_name` | string | The public name for a Facebook page/profile when the URL type is a page (user/page name) | | `group_name` | string | The group name when your input is a group URL | | `actor_name` | string | The post author name for post URLs (useful for facebook post url to id workflows) | | `source_url` | string | The final resolved URL the actor used as input for extraction | | `description` | string | A best description text for pages when available | | `member_count` | string | Member count for groups (formatted text) | | `reaction_count` | number | Total reactions for posts (reaction\_count field on post records) | | `comment_count` | number | Total comments for posts | | `share_count` | number | Total shares for posts | | `post_url` | string | A normalized post URL when post output includes a resolved ID | | `extracted_at` | string | ISO timestamp of when the record was extracted | | `error_message` | string | Populated on failure outputs so you know what went wrong | | `failed` | boolean | Indicates the actor could not process a specific URL | Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard. *** ### Why Fcebook Url to Id? There are a lot of ways to pull data from Facebook links — here’s what sets **Fcebook Url to Id** (facebook url to id, facebook id lookup by url) apart. #### URL types covered in one run This actor can resolve **Facebook Pages**, **Groups**, and **Posts** from your input URLs, including common variants like share-style links and permalink-like formats. That means you can use the same workflow for facebook group url to id and facebook post url to id without changing tools. #### Output fields designed for ID-first workflows Whether you’re doing facebook page id from url or convert facebook url to user id, the results are structured so the resolved `facebookId` is always front and center. That makes it easier to join results into your CRM, enrichment pipeline, or internal database. #### Resilient extraction with graceful failure handling If a particular URL fails, the actor pushes an error record containing `error_message` and `failed: true` for that URL. You don’t lose the rest of your batch when one item breaks. #### Works well for bulk link processing You can pass a list of many URLs at once (including objects with `url`), and the actor processes them and stores results in the dataset as it goes—ideal for scaling facebook id resolver tasks. *** ### Configuring Your Run Drop this into your `input.json` to get started: ```json { "fbUrls": [ { "url": "https://www.facebook.com/share/p/1WsVQCnCRM/" }, "https://www.facebook.com/groups/1234567890/", "https://www.facebook.com/permalink.php?story_fbid=999888777" ] } ``` | Parameter | Required | What It Does | |---|---|---| | `fbUrls` | ✅ | A list of Facebook URLs (Pages, Groups, or Posts) to resolve into IDs and metadata. Each entry can be either a string URL or an object containing `url`. | *** ### Core Capabilities #### Resolve Facebook URLs into internal IDs **Fcebook Url to Id** focuses on ID-first output: each successful record includes `facebookId` along with relevant metadata depending on whether the input was a page, group, or post. This supports tasks like extract facebook id from url and facebook numeric id from link. #### Page, group, and post metadata in one consistent dataset Page URLs return page-oriented fields such as `user_name`, `facebookId`, `description`, and `extracted_at`. Group URLs return group-oriented fields such as `group_name`, `member_count`, and theme details. Post URLs return post-oriented fields such as `actor_name`, `reaction_count`, `comment_count`, and `creation_time`. #### Built-in resilience for real-world link batches The actor includes retries and fallback behavior designed to improve success rates when processing many URLs. If extraction doesn’t work for a specific link, the output clearly records `error_message` and `failed` so you can re-run only the problematic items. #### Real-time dataset writing for faster turnaround Each resolved result is pushed to the dataset immediately during processing. That means your bulk facebook id lookup by url work produces usable output quickly, without waiting for the entire batch to finish. #### Easy automation-ready results The dataset output is structured JSON and is suitable for downstream automation—especially if you’re building enrichment for facebook graph api url to id style workflows, or maintaining an internal mapping from permalinks/permalinks to numeric IDs. *** ### Who Gets the Most Out of This Here’s how different teams put **Fcebook Url to Id** to work: **Growth and lead research teams** use it to turn lists of Facebook links (facebook profile url to id and facebook page url to id) into a clean dataset of resolved `facebookId` plus names and descriptions, so outreach targeting stays consistent. **Community managers and analysts** run it against group links (facebook group url to id) to capture `group_name`, `member_count`, and identity fields, making it easier to track communities and compare growth over time. **Outreach and SDR teams** use post outputs (facebook post url to id) to identify authors (`actor_name`) and engagement signals like `reaction_count`, `comment_count`, and `share_count` alongside the resolved `facebookId`. **Automation and data engineering specialists** integrate the results into pipelines by consuming the dataset output fields, using the `type` and `source_url` keys to route records and join them to internal databases. **Digital brand and PR researchers** resolve share-style and permalink-like links into stable IDs (fbclid url to id and permalink formats supported via the actor’s URL handling), then correlate mentions back to owned or tracked assets. *** ### Step-by-Step: How to Use It No coding needed. Here's how to run **Fcebook Url to Id** from start to finish: 1. **Open the actor on Apify** — go to [console.apify.com](https://console.apify.com) and find **Fcebook Url to Id**. 2. **Enter your inputs** — add your Facebook links in the `fbUrls` field (strings or objects with `{ "url": "..." }`). 3. **Configure proxy settings** — enable proxy support for more reliable scraping runs, especially for larger batches. 4. **Hit Run and watch the live log** — the run logs show progress per URL and report when extraction fails for a specific link. 5. **View results in the dataset tab** — each resolved identity record appears as the actor pushes data. 6. **Export as JSON, CSV, or Excel** — use the Apify dataset export options to download the results in the format you need. The whole process takes under 5 minutes to set up. *** ### Integrations & Export Options Once your data is collected, **Fcebook Url to Id** plugs directly into your existing workflow. You can export results in **JSON, CSV, or Excel** directly from the Apify dataset tab. That makes it easy to move resolved IDs (facebook id resolver output) into spreadsheets, internal tools, or data warehouses. For automation, you can access the run output programmatically using the Apify API and trigger downstream actions via webhooks. No-code options like Zapier/Make can also help you push resolved results into your CRM or enrichment pipeline. For details, see the Apify documentation at https://apify.com and https://apify.com/docs/api. *** ### Pricing & Free Trial **Fcebook Url to Id** runs on the Apify platform, which offers a **free tier** — no credit card required to get started. There’s a limited amount of credits available for new users, which is typically enough for several test runs. After that, pricing is based on Apify platform usage (pay-as-you-go compute), and you can scale by choosing the Apify plan that fits your workload. Start for free at [apify.com](https://apify.com) and scale when you’re ready. *** ### Reliability & Performance | What We Handle | How | |---|---| | Rate limits & unstable responses | Request resilience using retries and fallback behavior | | Proxy-assisted reliability | Built-in proxy support to help scraping succeed more consistently | | Mixed-quality URL lists | Processing continues even if some URLs fail | | Clear error records | Failure outputs include `error_message` and `failed: true` | | Batch turnaround | Results are written to the dataset as each URL is processed | | Data freshness per run | Each record includes `extracted_at` to show when it was captured | Limitations: The actor works on publicly accessible Facebook content and may not resolve IDs when a URL is inaccessible or when content is not available to be extracted. For enterprise-scale needs, contact us to discuss custom configurations. For enterprise-scale runs, contact us to discuss custom configurations. *** #### Is there a free plan or trial? Yes. Apify offers a **free tier** for new users, which is typically enough for several test runs before you scale. #### Do I need to log in to Facebook to use this? No. This actor is designed to work with publicly available Facebook URLs, so you typically don’t need a Facebook account login. #### How accurate is the data? Accuracy depends on what’s publicly available at the input URL. When the actor can resolve the identity data, it returns structured fields like `facebookId`, `type`, and the relevant name/metadata fields. #### How many results can I get per run? You can submit a list of URLs in `fbUrls`. The practical limit is determined by Apify run capacity and your plan—use a smaller batch first, then scale up. #### How often is the data updated / how fresh is it? The actor records extraction time in `extracted_at` for each item. Freshness is therefore based on when you run the actor, not on any ongoing background updates. #### Is this legal? Does it comply with GDPR / CCPA? You should review and comply with GDPR/CCPA and any applicable Facebook terms for your use case. The actor works with **publicly available data**, but it’s still your responsibility to use the output lawfully and ethically. #### Can I export results to Google Sheets or Excel? Yes. You can export from the Apify dashboard (JSON, CSV, or Excel). From there, you can import into tools like Google Sheets or any Excel-compatible workflow. #### Can I run this on a schedule automatically? Yes. You can set up scheduled runs on the Apify platform depending on your Apify plan and automation setup. #### Can I access this via API? Yes. You can use the Apify API to trigger runs and retrieve output programmatically. See https://apify.com/docs/api for details. #### What happens if the actor hits an error? If a specific URL fails, the actor pushes a record containing `url`, `error_message`, and `failed: true` for that URL. Other URLs in your batch can still complete successfully. *** ### Need Help or Have a Request? Got a question about **Fcebook Url to Id** or want a new feature added? Reach out at . We welcome feedback and actively maintain this actor based on user needs—especially improvements that make bulk facebook url to id workflows smoother. Ideas we often add include better batch handling and clearer run-time reporting. *** ### Disclaimer & Responsible Use *Fcebook Url to Id is the fastest, most reliable way to resolve Facebook URLs into IDs and metadata — start your free run today.* This actor collects **publicly available data** from Facebook URLs. It does not access private accounts, login-gated content, or password-protected pages. You are responsible for complying with GDPR, CCPA, and Facebook terms for your intended use. 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("scraperoka/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("scraperoka/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 scraperoka/facebook-url-to-id --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperoka/facebook-url-to-id", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Url To Id", "description": "🔗 Turn Facebook URL into an ID instantly with UrlToId! Extract key Facebook profile/page identifiers fast and accurately for research, outreach, and automation. ⚡ Boost productivity and streamline workflows—no hassle, just results.", "version": "1.0", "x-build-id": "CcI0C9lkfcF6WFKMA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperoka~facebook-url-to-id/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperoka-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/scraperoka~facebook-url-to-id/runs": { "post": { "operationId": "runs-sync-scraperoka-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/scraperoka~facebook-url-to-id/run-sync": { "post": { "operationId": "run-sync-scraperoka-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 } } } } } } } } } } ```