Returns public details of a Facebook page: category, rating, priceRange, services, website, phone, email, address, followerCount, likeCount and talkingAboutCount. talkingAboutCount may be null and appears only when Facebook shows it. You also get pageId plus an adLibrary status describing the page's ads. Set get_business_hours to true to add businessHours. Contact fields reflect what the page published publicly. An 18+ gate still yields 200, setting isPrivate: true and account_status: "age-restricted"; a private gate yields 200 with isPrivate: true and account_status: "private". A missing page returns 404 where isPrivate: false and accountDoesNotExist: true. With include_gated_profile=true, gated or age-restricted pages also return a reduced set of public fields (for example id, name, links, category, profilePicSmall and likeCount); public pages are unaffected and still return the full response.
Query parameters
url
stringrequired
Link to the Facebook page.
get_business_hours
string
Set to true to include the business's opening hours.
include_gated_profile
string
When true, gated or age-restricted pages return a reduced set of public fields. Has no effect on normal public pages.
cache_max_age
string
Accept a stored response up to this age. Inside that window the answer is free and comes back with cached: true and a cached_at time; past it, the request runs live for 1 request.
Returns up to 10 reels per call from a Facebook page that is public. Each reel has id, url, description, view_count, thumbnail, video_url, creation_time, play_time_in_ms and music details. For the next page you must send next_page_id together with cursor, both taken from the last response.
Query parameters
url
stringrequired
Link to the Facebook page.
next_page_id
string
Value from the last response, sent together with cursor to load the next page.
cursor
string
Value from the last response, sent together with next_page_id to load the next page.
Returns a public Facebook page's photos, page by page. Each has photo_id, a thumbnail, a direct url, accessibility_caption, and viewer_image (uri, width, height). For the next page you must send next_page_id together with cursor, both taken from the last response.
Query parameters
url
stringrequired
Link to the Facebook page.
next_page_id
string
Value from the last response, sent together with cursor to load the next page.
cursor
string
Value from the last response, sent together with next_page_id to load the next page.
Returns the publicly visible posts of a Facebook profile, 3 per page because of platform limits. Each post has id, url, text, commentCount, reactionCount, publishTime, videoDetails (sdUrl, hdUrl, thumbnailUrl) and topComments. Identify the profile by url or pageId; pageId is quicker.
Query parameters
url
string
Link to the Facebook profile.
pageId
string
Facebook page ID of the profile. Faster than a URL.
cursor
string
Paging token returned by the last call. Send it to load the next batch of posts.
Fetches one Facebook post or reel that is public, by URL. The response has post_id, description, creation_time, view_count, like_count, comment_count, share_count and author details; the author handle is included if Facebook exposes a vanity URL for the profile. On some reels the post page reports a different view count from the profile Reels grid, so the value may be null or below the public Reels badge; for the badge figure, query /v1/facebook/profile/reels using the author's URL and find the reel by post_id. Video posts add sd_url, hd_url, thumbnail and length_in_second. Comments and a transcript can optionally be included via the get_comments and get_transcript parameters.
Query parameters
url
stringrequired
Link to the Facebook post or reel.
cache_max_age
string
Accept a stored response up to this age. Inside that window the answer is free and comes back with cached: true and a cached_at time; past it, the request runs live for 1 request.
Returns the transcript of a Facebook reel or video post as one string, with line breaks. Works only for videos under 2 minutes.
Query parameters
url
stringrequired
Link to the Facebook post or reel.
cache_max_age
string
Accept a stored response up to this age. Inside that window the answer is free and comes back with cached: true and a cached_at time; past it, the request runs live for 1 request.
Returns comments on a Facebook post or reel, paginated by cursor. Each comment has id, text, reply_count, reaction_count, created_at, and the author's name and profile_picture. Sending feedback_id in place of url makes the call much faster.
Query parameters
url
string
Link to the Facebook post or reel.
feedback_id
string
Post feedback_id from /v1/facebook/post. Much faster than passing url.
cursor
string
Paging token returned by the last call. Send it to load the next batch of comments.
Returns what a public Facebook group shows on its About page: description, privacy and visibility settings, member and activity counts, categories, group history, and rules. Admins and moderators are included when Facebook makes them visible. Send either url or group_id.
Query parameters
url
string
Link to the Facebook group; sub-page links such as /about are accepted.
group_id
string
Numeric group ID, an alternative to url when you already know it.
{
"success": true,
"credits_charged": 1,
"id": "366190054572553",
"url": "https://www.facebook.com/groups/366190054572553",
"name": "Python Programming",
"description": "Let's share our knowledge on Python Programming",
"privacy": {
"label": "Public",
"description": "Anyone can see who's in the group and what they post."
},
"visibility": {
"label": "Visible",
"description": "Anyone can find this group."
},
"categories": [
{
"id": "242504017103922",
"name": "Software & tech"
}
],
"created_at": "2020-10-14T15:45:03.000Z",
"history_summary": "Group created on October 14, 2020. Name last changed on October 16, 2020.",
"member_count": 710386,
"member_count_text": "710,386 total members",
"administrator_count": 3,
"moderator_count": 0,
"administrators": [
{
"id": "pfbid029b9bjf9rZfL4v9EHdxt1uxng857G4UqwpZjbCHySg88UYWu2XL5ivSixWhXBnZMnl",
"name": "Nusrat Jahan",
"url": "https://www.facebook.com/people/Nusrat-Jahan/pfbid029b9bjf9rZfL4v9EHdxt1uxng857G4UqwpZjbCHySg88UYWu2XL5ivSixWhXBnZMnl/",
"profile_picture_url": "https://scontent.xx.fbcdn.net/example.jpg"
}
],
"moderators": [],
"activity": {
"posts_last_day": 16,
"posts_last_month": 512,
"new_members_text": "No new members in the last week"
},
"rules": [
{
"id": "366191957905696",
"title": "Be Kind and Courteous",
"description": "We're all in this together to create a welcoming environment. Let's treat everyone with respect."
}
],
"about_info": [
{
"type": "XFBPrivacyGroupsAboutInfoItem",
"label": "Public",
"description": "Anyone can see who's in the group and what they post."
}
]
}
Lists posts from a public Facebook group. Each page holds up to 3 posts. Every post carries id, url, text, publishTime, reactionCount, commentCount, topComments, and videoDetails. Ordering defaults to chronological; you can also pick TOP_POSTS, RECENT_ACTIVITY, or CHRONOLOGICAL_LISTINGS, and page through results with a cursor.
Facebook