Group
GET/v1/facebook/group1 credit
Returns the public details of a Facebook group: name, description, privacy, member count, admins and moderators, recent activity and rules.
01Query parameters
| Name | Type | Description |
|---|---|---|
| urloptional | string | A group URL, e.g. `https://www.facebook.com/groups/366190054572553`. One of `url` or `group_id` is required. |
| group_idoptional | string | The numeric group id. One of `url` or `group_id` is required. |
02Request
curl "https://api.scrapesocial.ai/v1/facebook/group?group_id=366190054572553" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/facebook/group?group_id=366190054572553
{
"success": true,
"credits_remaining": 4980,
"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"
},
{
"id": "202183377053878",
"name": "Engineering"
}
],
"created_at": "2020-10-14T11:05:03.000Z",
"history_summary": "Group created on October 14, 2020. Name last changed on October 16, 2020.",
"member_count": 759475,
"member_count_text": "759,475 total members",
"administrator_count": 3,
"moderator_count": 0,
"administrators": [
{
"id": "pfbid029Z8KQy8d2pzM37zBUykihazPm9wT3dnm1ttPJG7uXNs248vaxAkMxGck959nmALol",
"name": "Nusrat Jahan",
"url": "https://www.facebook.com/people/Nusrat-Jahan/pfbid029Z8KQy8d2pzM37zBUykihazPm9wT3dnm1ttPJG7uXNs248vaxAkMxGck959nmALol/",
"profile_picture_url": "https://scontent.fist20-1.fna.fbcdn.net/v/t39.30808-1/297738489_149183324449711_6655284279259187616_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx720x730&ctp=p64x64&_nc_cat=106&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=e99d92&_nc_ohc=MhgKTobEwTgQ7kNvwHT79mx&_nc_oc=AdrS-YKDBW9Z6QCyZek6KlFUSjLblrcdvgvQsfEARjIzvUpJQl41tZ4uFOHRT5UI-w8&_nc_zt=24&_nc_ht=scontent.fist20-1.fna&_nc_gid=BWR9Vs4W4DvynQx4PSxQ2w&_nc_ss=7b2…"
},
{
"id": "100079525026696",
"name": "Thesoftwarelion",
"url": "https://www.facebook.com/thesoftwarelion",
"profile_picture_url": "https://scontent.fist20-1.fna.fbcdn.net/v/t39.30808-1/242977119_109642788145497_5023972278328162431_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1200x1200&ctp=s64x64&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=qL7C9tgAVfAQ7kNvwE3KKFj&_nc_oc=Adom6__wNFMQ0WbNeCCoPm2_AHEGOJEE3U8tGfXkVUJtNvzgCgEqfMyY-BG_l06VrVc&_nc_zt=24&_nc_ht=scontent.fist20-1.fna&_nc_gid=BWR9Vs4W4DvynQx4PSxQ2w&_nc_ss=7…"
}
],
"moderators": [],
"activity": {
"posts_last_day": 3,
"posts_last_month": 348,
"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. Healthy debates are natural, but kindness is required."
},
{
"id": "366191961239029",
"title": "No Hate Speech or Bullying",
"description": "Make sure everyone feels safe. Bullying of any kind isn't allowed, and degrading comments about things like race, religion, culture, sexual orientation, gender or identity will not be tolerated."
}
],
"about_info": [
{
"type": "XFBPrivacyGroupsAboutInfoItem",
"label": "Public",
"description": "Anyone can see who's in the group and what they post."
},
{
"type": "XFBDiscoverabilityGroupsAboutInfoItem",
"label": "Visible",
"description": "Anyone can find this group."
}
]
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
An unknown group is a free 404 (`Group not found`). A private group, which Facebook shows only to signed-in viewers, returns a free 403.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.