Facebook Group Posts API

What is the Facebook Group Posts API?

Pass a public Facebook group URL and get its newest posts as clean JSON: id (the numeric post id), caption, publishedAt, author (id when Facebook exposes it — never the group slug as username), url (https://www.facebook.com/groups/{slug}/posts/{id} — there is no permalink twin), thumbnailUrl when the post has a still, and engagement. sortBy maps to Facebook's group sort (TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL default | CHRONOLOGICAL_LISTINGS). Up to 80 posts per call (about 7s for a handful, about 35s for 50); a larger limit returns the first 80 with hasMore true and truncatedReason per-call-cap. The envelope names the yield: requested, totalReturned, hasMore (true when the page came back full), truncatedReason (listing-window when the group had fewer posts than limit), and fetchedAt. likes / comments / views / shares are always keyed (null when unknown — never treat a missing key as 0), each with *IsApproximate. Billing is 1 credit per returned post, minimum 2; empty results and failures are 0 credits. Pass cache=true for the 24h shared cache. Private groups (or groups that show nothing to non-members) answer 404 with code FACEBOOK_GROUP_PRIVATE and retryable false at 0 credits. A deleted group is 404. Other failures are 502 or 503 (90s deadline), both with a body and 0 credits — retry those; a recent good page may be served instead as stale: true at 0 credits.

Replacing CrowdTangle? Here is what this endpoint covers, and what it does not. CrowdTangle alternative

Moving this call from ScrapeCreators? Here is the endpoint-by-endpoint map. ScrapeCreators alternative

What you get

• requested / listingHits / hydrateFailures / hydrateSkipped / hasMore / truncatedReason
• sortBy on the envelope (Facebook sorting_setting)
• engagement *IsApproximate on every keyed likes/comments/shares count (null counts as present)

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/facebook/group-posts?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2Fdogspotting" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "url": "https://www.facebook.com/groups/dogspotting",
    "totalReturned": 2,
    "posts": [
      {
        "platform": "facebook",
        "url": "https://www.facebook.com/groups/dogspotting/posts/10165927007174467/",
        "id": "10165927007174467",
        "caption": "Dog in a basket…I repeat…dog in a basket!",
        "description": "Dog in a basket…I repeat…dog in a basket!",
        "publishedAt": "2026-07-27T16:34:51.000Z",
        "author": {
          "displayName": "Beth Oxford"
        },
        "engagement": {
          "likes": 87,
          "comments": 0
        },
        "isVideo": false,
        "permalink": "https://www.facebook.com/groups/dogspotting/posts/10165927007174467/"
      },
      {
        "platform": "facebook",
        "url": "https://www.facebook.com/groups/dogspotting/posts/10165913663824467/",
        "id": "10165913663824467",
        "caption": "Waiting patiently in the Mustang.",
        "description": "Waiting patiently in the Mustang.",
        "publishedAt": "2026-07-24T22:16:11.000Z",
        "thumbnailUrl": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-6/754824625_10163571025602896_890543610805686018_n.jpg?stp=dst-jpg_tt6&cstp=mx2048x1536&ctp=p600x600&_nc_cat=107&ccb=1-7&_nc_sid=63...",
        "author": {
          "displayName": "Chet Rhodes"
        },
        "engagement": {
          "likes": 36,
          "comments": 2
        },
        "isVideo": false,
        "permalink": "https://www.facebook.com/groups/dogspotting/posts/10165913663824467/"
      }
    ],
    "sortBy": "CHRONOLOGICAL"
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Request-Id (include it when contacting support). Where the response has a source field, it names the path that served the data: native, extended, cache or asr. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs ~20 credits (1/result) — billed per result, so the exact amount scales with how many items you request. Pass cache=true for a free 24h cache hit; default is always fresh (metrics refresh within ~1 hour).

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/facebook/group-posts and parse the JSON response.

Use cases

Frequently asked questions

More Facebook APIs