Facebook URL to ID Converter

Facebook

Operated by Sourcelane✓ verified

A bulk Facebook link and username resolver that converts lists of Facebook URLs or vanity usernames into canonical numeric IDs and associated metadata. The connector resolves pages, profiles, groups, posts, videos, reels, photos and events by reading numeric IDs from URLs or performing lookups that follow redirects and expand share/short links (including pfbid and fb.watch). Outputs per-input, flat records containing the resolved numeric ID(s), entity type, the legacy/classic page ID used by Ads tools, owner identifier and display name, entity title, vanity username, page category, canonical URL and a status/error indicator. Supports multiple host variants and share link formats, performs parallel lookups for throughput, and can run without a Facebook login or cookies.

Verified Sep 28, 12:10 AM

$0.0005

per lookup

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

Facebook ads and audience tools: obtain the Page ID required by Ads Library and Business Manager
Lead lists and CRM enrichment: convert spreadsheets of Facebook links into stable numeric IDs for record linking
Deduplication: normalize different URL forms and redirects to the same numeric ID for record merging
Social listening and research pipelines: produce numeric page, group and post IDs for downstream scrapers and APIs
Resolving share links: expand shortened or shared links to real post/video/photo IDs and their authors

Trust & reliability

7d uptime trend

Window	Uptime	Success rate	p50	p95
24h	—	—	—	—
7d	—	—	—	—
30d	—	—	—	—

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"facebook-url-to-id","params":{"urls":["https://www.facebook.com/nike","https://www.facebook.com/groups/germtheory.vs.terraintheory","https://www.facebook.com/NintendoAmerica/posts/pfbid09PPhHDZ1wEi19DBTuZJ8L7ZMxiGGpSyfRXPiPx3gKK17KBh2k53HERZzjK7VYZP7l","https://www.facebook.com/reel/2166091230582141/","zuck"]},"maxResults":10}'

Request params

Field	Type	Required	Description
`urls`	array	required	One per line. Pages, profiles (vanity or profile.php?id=), groups, posts (incl. pfbid links), videos, reels, photos, events, share links, or bare usernames like 'nike'.
`includeDetails`	boolean	optional	On: every URL is looked up to add the name, owner ID, classic Page ID, category and canonical URL. Off: URLs that already contain a numeric ID are converted instantly from the URL alone (fastest); only usernames, pfbid posts and share links are looked up.
`useFallback`	boolean	optional	When a profile, page or post cannot be read directly, try a second lookup method before giving up. Groups and events have no backup lookup.
`maxConcurrency`	integer	optional	How many URLs are looked up at the same time.
`useResidentialFallback`	boolean	optional	If Facebook blocks a lookup through the proxy above, retry it through a residential proxy before giving up.

Each result contains

Field	Type	Description
`inputUrl`	string	Input
`status`	string	Status
`type`	string	Type
`facebookId`	string	Facebook ID
`profileId`	string	—
`pageId`	null	Page ID
`groupId`	null	—
`postId`	null	—
`videoId`	null	—
`photoId`	null	—
`eventId`	null	—
`albumId`	null	—
`ownerId`	null	Owner ID
`ownerName`	null	—
`name`	string	Name
`username`	string	Username
`category`	null	—
`canonicalUrl`	string	Canonical URL
`resolvedBy`	string	—
`error`	null	Error

Use Facebook URL to ID Converter from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “Pull the last 30 posts from the Nike page and chart engagement by post type.”

Connect Claude

Web, desktop and mobile. Paste one URL.

1Copy your personal connector URL
2In Claude open Settings → Connectors → Add custom connector
3Paste the URL and click Add — done

Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal

claude mcp add --transport http sourcelane https://cool-puffin-608.convex.site/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cool-puffin-608.convex.site/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json

{
  "mcpServers": {
    "sourcelane": {
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json

{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL

https://sourcelane-amber.vercel.app/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"facebook-url-to-id","params":{"urls":["https://www.facebook.com/nike","https://www.facebook.com/groups/germtheory.vs.terraintheory","https://www.facebook.com/NintendoAmerica/posts/pfbid09PPhHDZ1wEi19DBTuZJ8L7ZMxiGGpSyfRXPiPx3gKK17KBh2k53HERZzjK7VYZP7l","https://www.facebook.com/reel/2166091230582141/","zuck"]},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python

import requests

res = requests.post(
    "https://cool-puffin-608.convex.site/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "facebook-url-to-id",
        "params": {"urls":["https://www.facebook.com/nike","https://www.facebook.com/groups/germtheory.vs.terraintheory","https://www.facebook.com/NintendoAmerica/posts/pfbid09PPhHDZ1wEi19DBTuZJ8L7ZMxiGGpSyfRXPiPx3gKK17KBh2k53HERZzjK7VYZP7l","https://www.facebook.com/reel/2166091230582141/","zuck"]},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

Leave a review

Loading reviews…