Operated by Sourcelane✓ verified
Convert Facebook URLs and usernames to numeric IDs in bulk: page, profile, group, post, video, reel, photo and event IDs, plus owner ID, name and canonical URL.
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, 3:55 AM
$0.0005
per lookup
Up to 100 per call. Only pay for results returned; failed calls are refunded.
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
One per line.
Optional settings
| Window | Uptime | Success rate | p50 | p95 | Calls |
|---|---|---|---|---|---|
| 24h | — | — | — | — | 0 |
| 7d | — | — | — | — | 0 |
| 30d | — | — | — | — | 0 |
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://api.usesourcelane.com/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 |
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. One click, then confirm.
Adds the Sourcelane MCP server with your key as a header.
claude mcp add --transport http sourcelane https://api.usesourcelane.com/mcp \
--header "Authorization: Bearer sl_live_your_agent_key"Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.
{
"mcpServers": {
"sourcelane": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.usesourcelane.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer sl_live_your_agent_key"
}
}
}
}Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).
{
"mcpServers": {
"sourcelane": {
"url": "https://api.usesourcelane.com/mcp",
"headers": {
"Authorization": "Bearer sl_live_your_agent_key"
}
}
}
}Save as .vscode/mcp.json. VS Code prompts for your key once.
{
"servers": {
"sourcelane": {
"type": "http",
"url": "https://api.usesourcelane.com/mcp",
"headers": {
"Authorization": "Bearer ${input:sourcelane-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "sourcelane-key",
"description": "Sourcelane agent key",
"password": true
}
]
}Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.
https://usesourcelane.com/openapi.jsonOne POST. Pass maxResults to cap cost.
curl -X POST https://api.usesourcelane.com/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}'Wrap the REST call as a tool, or point an MCP client at the endpoint.
import requests
res = requests.post(
"https://api.usesourcelane.com/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"])—
0 reviews
Leave a review
Loading reviews…