Facebook Group Posts API. Public group posts, page by page.
Public group posts with exact counts. We handle the proxies, blocks and platform changes.
Facebook Group Posts API at a glance
Returns a public Facebook group's posts, a page at a time: newest first, most relevant, most recently active, or only its items for sale. Each post has its text with hashtags and mentions, photos, album, video or reel, link card or shared post, publish time, exact reaction, comment and share counts with the reactions by type, a video's views, and the member who posted it. Send the group's link, share link or ID.
GET /v1/facebook/group_posts
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 22 typed fields null when unknown
- 3 public group posts per page, Facebook's New posts: newest first by when a post entered the group's feed
urlis all it needs, e.g.https://www.facebook.com/groups/366190054572553/
Send one request. Get up to 3 public group posts back.
Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.
$ npm install socialtapurl = https://www.facebook.com/groups/366190054572553/const params = new URLSearchParams({
sort: "newest",
url: "https://www.facebook.com/groups/366190054572553/",
});
const res = await fetch(`https://socialtap.dev/v1/facebook/group_posts?${params}`, {
headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/facebook/group_posts",
params={"sort": "newest", "url": "https://www.facebook.com/groups/366190054572553/"},
headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/facebook/group_posts")
uri.query = URI.encode_www_form('sort' => 'newest', 'url' => 'https://www.facebook.com/groups/366190054572553/')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'sort' => 'newest',
'url' => 'https://www.facebook.com/groups/366190054572553/',
]);
$ch = curl_init('https://socialtap.dev/v1/facebook/group_posts?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("sort", "newest")
q.Set("url", "https://www.facebook.com/groups/366190054572553/")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/facebook/group_posts?"+q.Encode(), nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var body struct {
Data json.RawMessage `json:"data"`
Page json.RawMessage `json:"page"`
Meta map[string]any `json:"meta"`
Error *struct {
Code string `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
log.Fatal(err)
}
if body.Error != nil {
log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
}
fmt.Println(string(body.Data), body.Meta["credits_charged"])
}curl -G 'https://socialtap.dev/v1/facebook/group_posts' \
--data-urlencode 'sort=newest' \
--data-urlencode 'url=https://www.facebook.com/groups/366190054572553/' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [],
"author": {
"avatar_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/657732699_4372938149635055_8298649324198958953_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1920x1933&ctp=s80x80&_nc_cat=105&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&…",
"display_name": "Gift Glory Onuoha",
"id": "100007567395235",
"is_verified": false,
"url": "https://www.facebook.com/gift.glory.onuoha.2025",
"username": "gift.glory.onuoha.2025"
},
"coauthors": [],
"duration_ms": null,
"hashtags": [
"Python",
"PythonProgramming",
"CodingChallenge"
],
"id": "1837548820769995",
"is_nsfw": null,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": "May be a graphic of text",
"duration_ms": null,
"expires_at": "2026-10-25T18:00:00Z",
"height": 1280,
"thumbnail_url": null,
"type": "image",
"url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.99422-6/888453030_1934834490835840_4759651598659241080_n.png?stp=dst-jpg_tt6&cstp=mx1024x1280&ctp=s1024x1280&_nc_cat=109&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&…",
"width": 1024
}
],
"mentions": [],
"metrics": {
"comment_count": 0,
"like_count": 1,
"quote_count": null,
"repost_count": null,
"save_count": null,
"share_count": 1,
"view_count": null
},
"platform": "facebook",
"platform_specific": {
"facebook": {
"feedback_id": "ZmVlZGJhY2s6cGZiaWQwSGZWelFmaURCb0xWU2J0Zjk0enlGeE5qN3VWaExUbTQ2ZHpSUjlnNTNTRjVCOG8ydWM2Z2dHTDU4ZTZmdEZMamw=",
"group": {
"id": "366190054572553",
"name": "Python Programming",
"url": "https://www.facebook.com/groups/366190054572553/"
},
"is_attachment_unavailable": false,
"link": null,
"listing": null,
"music": null,
"reactions": [
{
"count": 1,
"type": "like"
}
],
"shared_post": null,
"video_id": null
}
},
"platform_type": "post",
"published_at": "2026-11-03T17:47:58Z",
"text": "DEVELOPER MYSTERIES #074 🕵️\n\nOne function changes a variable. Another function reads it.\n\nNeither function receives that variable as an argument.\n\nSo how do they stay connected?\n\nThis challenge tests your understanding of Python closures and variable scope.\n\nPredict the exact out…",
"thumbnail_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.99422-6/888453030_1934834490835840_4759651598659241080_n.png?stp=dst-jpg_tt6&cstp=mx1024x1280&ctp=s1024x1280&_nc_cat=109&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&…",
"title": null,
"type": "image",
"unknown_fields": [],
"url": "https://www.facebook.com/groups/366190054572553/posts/1837548820769995/"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/795255518_27959759933716428_4332290339331851799_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1568x1556&ctp=s80x80&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED…",
"display_name": "Jamil Ahmed",
"id": "pfbid02tVzjeEoXMnLspija9MeZZfBPwsH4T5796pNLJhq8jhk2QZ8EThUdgbsDi7uPqFMXl",
"is_verified": false,
"url": "https://www.facebook.com/people/Jamil-Ahmed/pfbid02tVzjeEoXMnLspija9MeZZfBPwsH4T5796pNLJhq8jhk2QZ8EThUdgbsDi7uPqFMXl/",
"username": null
},
"coauthors": [],
"duration_ms": null,
"hashtags": [],
"id": "1837472564110954",
"is_nsfw": null,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": "May be a doodle of crowd",
"duration_ms": null,
"expires_at": "2026-10-25T18:00:00Z",
"height": 616,
"thumbnail_url": null,
"type": "image",
"url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-6/886519251_28601992169493198_704461445392669909_n.jpg?stp=dst-jpg_tt6&cstp=mx2000x616&ctp=s2000x616&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&_n…",
"width": 2000
}
],
"mentions": [
"nurul.islam.971932",
"arwy.mhmd.552211",
"talha.qaimkhani.33"
],
"metrics": {
"comment_count": 1,
"like_count": 0,
"quote_count": null,
"repost_count": null,
"save_count": null,
"share_count": 0,
"view_count": null
},
"platform": "facebook",
"platform_specific": {
"facebook": {
"feedback_id": "ZmVlZGJhY2s6cGZiaWQwc3J5VXVYQ3pFaUFQYjVDZWRjbUF3TVlTQTZqQnlZVU1Rb1JIbksxTm9aYXlSUWRQRW0ydm5lTTE3OGVlZHB5Nmw=",
"group": {
"id": "366190054572553",
"name": "Python Programming",
"url": "https://www.facebook.com/groups/366190054572553/"
},
"is_attachment_unavailable": false,
"link": null,
"listing": null,
"music": null,
"reactions": [],
"shared_post": null,
"video_id": null
}
},
"platform_type": "post",
"published_at": "2026-11-03T16:12:44Z",
"text": "Let's welcome our new members!\nEmanuela Salomè,\nAdamu Abdullahi Adamu,\nNurul Islam,\nOlika Abdukerim Hassen,\nاروى محمد,\nMdAlamin Islam,\nAmos Dweh,\nElloy Neves,\nMuhammad Talha,\nAL IF,\nMaesha Jannat,\nLijalem Abera,\nMoosin Abdoo,\nTa Minh Tam,\nMorsalin Fahim,\n燈矢 轟,\nZayn Hosen,\nTasirul…",
"thumbnail_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-6/886519251_28601992169493198_704461445392669909_n.jpg?stp=dst-jpg_tt6&cstp=mx2000x616&ctp=s2000x616&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&_n…",
"title": null,
"type": "image",
"unknown_fields": [],
"url": "https://www.facebook.com/groups/366190054572553/posts/1837472564110954/"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/723111037_2124011641501346_211675270863137924_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx728x735&ctp=p80x80&_nc_cat=111&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_nc…",
"display_name": "Sajid Hamid",
"id": "100016775924657",
"is_verified": false,
"url": "https://www.facebook.com/sajid.hamid.762469",
"username": "sajid.hamid.762469"
},
"coauthors": [],
"duration_ms": null,
"hashtags": [],
"id": "1837467537444790",
"is_nsfw": null,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": "May be an image of text",
"duration_ms": null,
"expires_at": "2026-10-25T18:00:00Z",
"height": 1620,
"thumbnail_url": null,
"type": "image",
"url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.99422-6/887924411_1161885399862305_7654919970390769521_n.png?stp=dst-jpg_tt6&cstp=mx1280x1920&ctp=s1080x2048&_nc_cat=109&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&…",
"width": 1080
}
],
"mentions": [],
"metrics": {
"comment_count": 0,
"like_count": 0,
"quote_count": null,
"repost_count": null,
"save_count": null,
"share_count": 0,
"view_count": null
},
"platform": "facebook",
"platform_specific": {
"facebook": {
"feedback_id": "ZmVlZGJhY2s6cGZiaWQwMnBrODFXZ1UzUlZCUmprZmg2S1F3bVFlUllTUFQ5OURXQVZQNlRuaTZNWnJqZzJYWUtKU1NMOXpiRVM2ZkhkNVJs",
"group": {
"id": "366190054572553",
"name": "Python Programming",
"url": "https://www.facebook.com/groups/366190054572553/"
},
"is_attachment_unavailable": false,
"link": null,
"listing": null,
"music": null,
"reactions": [],
"shared_post": null,
"video_id": null
}
},
"platform_type": "post",
"published_at": "2026-11-03T16:06:16Z",
"text": null,
"thumbnail_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.99422-6/887924411_1161885399862305_7654919970390769521_n.png?stp=dst-jpg_tt6&cstp=mx1280x1920&ctp=s1080x2048&_nc_cat=109&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&…",
"title": null,
"type": "image",
"unknown_fields": [],
"url": "https://www.facebook.com/groups/366190054572553/posts/1837467537444790/"
}
],
"page": {
"has_more": true,
"next_cursor": "c1.EXAMPLE_CURSOR",
"next_cursor_expires_at": "2026-10-26T12:00:00Z",
"end_reason": null
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "facebook",
"source": "api",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 1959,
"fetched_at": "2026-10-25T12:00:00Z",
"input": {
"kind": "community",
"id": "366190054572553",
"url": "https://www.facebook.com/groups/366190054572553/"
},
"credits_remaining": 9999,
"client_request_id": null,
"warnings": []
}
}import { SocialTap } from "socialtap";
const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY
const res = await client.facebook.groupPosts.list({ url: "https://www.facebook.com/groups/366190054572553/", sort: "newest" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "sort=" + encode("newest")
+ "&url=" + encode("https://www.facebook.com/groups/366190054572553/");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/facebook/group_posts?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"sort=" + Uri.EscapeDataString("newest"),
"url=" + Uri.EscapeDataString("https://www.facebook.com/groups/366190054572553/"));
var res = await http.GetAsync("https://socialtap.dev/v1/facebook/group_posts?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/facebook/group_posts")
.query(&[("sort", "newest"), ("url", "https://www.facebook.com/groups/366190054572553/")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/facebook/group_postsLong arrays and strings are shortened here. Real responses are complete.Docs One schema on 21 platforms.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field Facebook doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
The public group: its link (facebook.com/groups/<ID or name>, any tab of it, on any facebook.com host; the legacy group.php?gid=<ID>), its share link (facebook.com/share/g/<code>) or its bare numeric ID.
Write one parser
Facebook, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (tiktok, youtube, …).
idstring- Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring- Canonical post URL.
typestring- Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring- The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring- Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring- Caption, description or body as plain text.
languagestring- BCP-47 language of text, when the platform states it.
Live data from 33 platforms.
What teams build with the Facebook Group Posts API.
Monitor a group for new posts
Follow a community's most active threads
Collect a buy-and-sell group's latest listings
Good to know before you build.
- Each page holds the few posts Facebook's logged-out feed serves at a time; follow next_cursor for more.
- A private group returns private_or_unavailable, since only its members see its posts: the Facebook Group API still returns what it says about itself.
- A link Facebook shows nothing for (an unknown name, a hidden or removed group) returns private_or_unavailable too, without saying which.
- newest follows Facebook's New posts: in a group that approves posts before publishing them, an approved post can sit a little out of date order.
- listings keeps a listing that was taken down in its place in the feed, with listing null and is_attachment_unavailable true: only its photos are left, if any.
- A group's anonymous post names no account: its author is only the label "Anonymous participant", with every other field null.
- Comments are counted, not listed: the Facebook Comments API lists a post's comments.
1 credit per page. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful page | Per 1,000 pages |
|---|---|---|
| Any source | 1 credit | $0.75–$1.97 |
- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.
Questions about the Facebook Group Posts API.
More in the API reference.
How much does the Facebook Group Posts API cost?
A page of up to 3 public group posts costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.
How do I get the next page?
Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 1 hour.
Try it on a link you already have.
Paste it in the playground, or copy the request into your code.
100free credits
- No credit card
- Failed requests are free
- Works on all 218 endpoints