Facebook Group Posts API

What is the Facebook Group Posts API?

Pass a public Facebook group URL and get recent posts as clean JSON: caption, publishedAt, author (id when Facebook exposes it — never the group slug as username), url (the post — there is no permalink twin), thumbnailUrl when Facebook exposes a still, optional topComments Facebook embedded on the post, and engagement. sortBy maps to Facebook's sorting_setting (TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL default | CHRONOLOGICAL_LISTINGS). The envelope names the yield: requested, totalReturned, listingHits (distinct candidate posts in this HTML window), hydrateFailures (attempted hydrates that did not become a row), hydrateSkipped (found but not hydrated — the listing hop ate the budget), hasMore (true only when listingHits > limit — raise limit; there is no cursor), truncatedReason=listing-window | hydrate-budget, and fetchedAt (not a second scrapedAt). When hasMore is false: listingHits − hydrateFailures − hydrateSkipped = totalReturned. likes / comments / views / shares are always keyed (null when unknown — never treat a missing key as 0). Every keyed likes/comments/shares count carries *IsApproximate, including when the count is null (then false — unknown is not a compact token). Flat 2 credits. Pass cache=true for the 24h shared cache. The logged-out group feed is intermittently gated — a 200 with posts is not a promise the next call will succeed. Failures are 502 (listing hop finished, Facebook withheld extractable posts) or 503 (90s deadline), both with a body and 0 credits. Retry the call; do not treat a single 200 as a stable integration.

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-Source. 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 2 credits. Pass cache=true for a free 24h cache hit; default is always fresh.

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