Facebook URL to ID & Entity Resolver avatar

Facebook URL to ID & Entity Resolver

Pricing

from $0.49 / 1,000 results

Go to Apify Store
Facebook URL to ID & Entity Resolver

Facebook URL to ID & Entity Resolver

Resolve public Facebook URLs to numeric IDs and entity details without login: Pages, profiles, groups, posts, videos, reels, photos and Ad Library ads. Returns canonical links, owner IDs, names, usernames, member counts and audit statuses.

Pricing

from $0.49 / 1,000 results

Rating

0.0

(0)

Developer

Xyrelith Data

Xyrelith Data

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

2 days ago

Last modified

Features

Limited permissions

Share

Turn public Facebook links into stable numeric IDs, canonical URLs and readable entity details — without logging in, without cookies and without an API key.

Facebook hides the same object behind many link shapes: profile.php?id=…, vanity names, pfbid… post codes, /share/ codes, fb.watch short links, watch/?v=…, Reels, mobile subdomains and Ad Library links. This actor reads each link the way a signed-out visitor does, follows the redirects, and returns one flat, consistent row per unique object. Every row says whether it resolved, was not found, needed a login, or was not a Facebook URL, so a bulk list can be audited instead of silently containing blank IDs.

What you get

  • Numeric entity ID for Pages, profiles, groups, posts, group posts, videos, Reels, photos and Ad Library ads.
  • Classic Page ID (pageId) beside the current profile ID — the ID that ad tools and Business Manager ask for.
  • Canonical URL, username / vanity slug, display name and verification flag.
  • Owner details for posts, videos, Reels and photos: owner ID, owner type, owner name, owner username, owner classic Page ID and verification.
  • Parent group ID for group posts.
  • Group facts: privacy, member count (exact when Facebook publishes it), posts today and last month, creation date, description, admin count, rules count, locations and tags.
  • Engagement facts: post text and reactions; video views, reactions, comments, shares and duration; photo album ID.
  • Ad Library facts: advertiser Page ID and name, ad status, title, text, CTA, landing link and run dates.
  • Audit status on every row: resolved, not_found, login_required, invalid_url or error.
Link familyExamplesWhat is returned
Page or profilefacebook.com/nintendo, profile.php?id=4, /people/Name/ID/, @zuckEntity ID, classic Page ID, canonical URL, name, username, category, followers, talking-about count, verification
Groupfacebook.com/groups/OPonemillion, /groups/153355514685129Group ID, name, vanity, privacy, exact and rounded member counts, activity, creation date, description, admins, rules, locations, tags
Page post / permalink/Page/posts/123, /Page/posts/pfbid…, permalink.php?story_fbid=…, story.php?…Post ID, owner ID/type, text, creation time, reactions, comments, shares
Group post/groups/Group/posts/123, /groups/Group/permalink/123/Post ID, author ID/type, parent group ID, text and engagement
Video/Page/videos/123, /watch/?v=123, fb.watch/<code>/Video ID, owner ID/type, title, views, reactions, comments, shares, duration
Reelfacebook.com/reel/123Reel/video ID, owner details, title, views, reactions, duration
Photophoto?fbid=…, photo.php?fbid=…, /Page/photos/…/123/Photo ID, album ID, owner details
Ad Libraryads/library/?id=…, ads/library/?view_all_page_id=…Ad archive ID, advertiser Page ID/name, ad status, copy, CTA, landing link, dates
Short and share linksfb.watch/<code>/, /share/v/…, /share/r/…, /share/p/…Followed to the underlying video, Reel or post, then the same fields
Numeric IDsids: ["4", "100064368354094"]Canonical URL and entity type, with the same metadata

Mobile (m.), mbasic., web., locale subdomains, fb.com, http://, trailing slashes and tracking parameters are accepted and normalised.

Inputs

InputDefaultDescription
urls—One link, vanity name or @handle per line. Mixed lists are fine.
ids—Optional bare IDs to turn back into canonical links and typed records.
includeMetadatatrueAdds group About facts, Page category and audience counts, post and video engagement, and Ad Library creative details. Turn it off for the fastest ID-only pass.
maxItems100Hard cap. Duplicate inputs are removed before fetching, and different links that resolve to the same entity produce one row.

Output fields

Every record always contains sourceUrl, inputUrl, recordType, entityType, status and scrapedAt. Fields that Facebook does not publish for a particular object are omitted rather than filled with placeholders.

GroupFields
IdentitynumericId, canonicalUrl, name, username, pageId, isVerified, category
AudiencefollowersCount, talkingAboutCount
Group factsgroupPrivacy, memberCount, memberCountText, groupPostsToday, groupPostsLastMonth, groupCreatedAt, groupDescription, groupAdminCount, groupRulesCount, groupLocations, groupTags
Content ownerownerId, ownerType, ownerName, ownerUsername, ownerPageId, ownerVerified, ownerCategory, ownerFollowersCount, ownerTalkingAboutCount, parentGroupId
Content factscreatedAt, text, albumId, viewCount, viewCountText, playCount, reactionCount, reactionCountText, commentCount, shareCount, durationSeconds
Ad LibraryadArchiveId, adStatus, adTitle, adText, adCta, adLinkUrl, adStartDate, adEndDate

Example

Input:

{
"urls": [
"https://www.facebook.com/nintendo",
"https://www.facebook.com/reel/1505075088176160",
"https://www.facebook.com/ads/library/?id=1568983211690149"
],
"includeMetadata": true,
"maxItems": 10
}

Rows (trimmed):

[
{
"entityType": "page",
"numericId": "100064368354094",
"pageId": "119240841493711",
"name": "Nintendo of America",
"username": "NintendoAmerica",
"category": "Video Game",
"followersCount": 5643055,
"isVerified": true,
"canonicalUrl": "https://www.facebook.com/NintendoAmerica/",
"status": "resolved"
},
{
"entityType": "reel",
"numericId": "1505075088176160",
"ownerId": "100059581807334",
"ownerType": "page",
"ownerName": "sneakernews.com",
"viewCount": 87000,
"viewCountText": "87K",
"reactionCount": 37,
"durationSeconds": 5,
"status": "resolved"
},
{
"entityType": "ad",
"numericId": "1568983211690149",
"adArchiveId": "1568983211690149",
"pageId": "131840030178250",
"ownerName": "Booking.com",
"adStatus": "Active",
"adCta": "Book now",
"status": "resolved"
}
]

How it works

The actor requests the public, logged-out version of each link, follows redirects, and reads the structured data that Facebook itself embeds in those pages: canonical URLs, entity IDs, profile headers, story objects, video objects and group About data. Public Graph oEmbed pages are used as a metadata fallback, and Ad Library pages are handled with their public challenge flow. No account, cookie or access token is involved. The actor selects its connection automatically; no proxy setup is required from you.

Status values

StatusMeaning
resolvedThe entity ID and type were read from public data. Optional metadata may still be absent when Facebook does not publish it.
login_requiredFacebook served a login wall or a private-content notice. The numeric ID may still be present when it was readable from the link itself.
not_foundThe link is valid but Facebook does not expose the object to signed-out visitors, or it was deleted.
invalid_urlThe value is not a Facebook URL, handle or numeric ID.
errorA transient network or parsing error survived the retries. Re-run the same link.

Limitations

  • Event pages are login-walled on Facebook. Event links return their numeric ID and a login_required status, but not event details.
  • Private profiles, friends-only posts and private group content return login_required or not_found. Only public data is read.
  • Share links only work while Facebook still resolves the code. Expired or made-up codes return login_required.
  • Exact group member counts come from Facebook's public About data. When that data is not available, the rounded member text from the group page is returned instead.
  • Optional fields such as a group description, rules, locations or a Page category are omitted when Facebook does not publish them for that object.
  • Facebook changes its page markup from time to time. The actor retries and uses several extraction paths, but a very small number of links may need a re-run after a Facebook change.
  • This actor resolves and enriches links and IDs. It does not bulk-scrape posts, comments or member lists.

FAQ

Do I need to log in or provide cookies? No. The actor reads only what a signed-out visitor can see. There is no cookie, login or API-key input.

How do I get the Page ID used in Ads Manager or the Ad Library? Use the pageId field. It is the classic Page ID. numericId is the profile ID Facebook routes on today.

Can I paste bare IDs instead of links? Yes. Put them in Numeric IDs to reverse, or paste them into the URL list. Page, profile, group, post, video, Reel and photo IDs are recognised.

Why did an event return login_required? Facebook does not show event pages to signed-out visitors. The event ID is still returned so your list stays auditable.

Why is a group member count rounded? Facebook publishes an exact total only on some public group About pages. When it does, memberCount is exact and memberCountText is the full count. Otherwise only the rounded text is available.

Does it follow fb.watch and /share/ links? Yes. Redirects are followed and the resulting video, Reel or post is parsed. A short link that Facebook refuses to resolve is reported as login_required.

Can I use it for several thousand links? Yes, up to the maximum-records limit. Duplicate links are removed before fetching, and links that resolve to the same entity are collapsed into one row.

Why did I get zero records? Check the run status message. An empty URL and ID list returns zero rows with a message; a list of login-walled or deleted links returns rows with login_required or not_found rather than silently dropping them.