---
title: "Facebook Group Posts API"
method: GET
path: "/v1/facebook/group-posts"
tags: ["Facebook"]
---

# Facebook Group Posts API

`GET /v1/facebook/group-posts`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/facebook/group-posts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Newest posts from a public Facebook group — caption, author, engagement, sortBy; 1 credit per post.

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.

Docs: https://captapi.com/apis/facebook-group-posts

## Query parameters

- `url` string, required
- `limit` integer
- `sortBy` string
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `url` string: Public Facebook group URL you queried.
    - `totalReturned` integer: Number of items returned in this response.
    - `posts` object[]
      - `platform` string: Platform identifier for this response (matches the endpoint's platform).
      - `url` string: This post's Facebook URL (https://www.facebook.com/groups/{slug}/posts/{id}). There is no permalink twin — that key was an embed-alias of url and did not ship.
      - `id` string: Id of this posts item.
      - `caption` string: Post text. There is no description twin (the old example copied caption into description).
      - `description` string: Description of this posts item.
      - `publishedAt` string: Publish date (ISO 8601) when the platform exposes an absolute timestamp.
      - `author` object: Author name or handle.
        - `displayName` string
      - `engagement` object: Engagement metrics for the item.
        - `likes` integer
        - `comments` integer
      - `isVideo` boolean: Whether the item is a video.
      - `permalink` string: Canonical Instagram permalink for the embed.
      - `thumbnailUrl` string
    - `sortBy` string: Facebook sorting_setting echoed back: TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL | CHRONOLOGICAL_LISTINGS.

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)