Facebook

List Facebook group posts

List posts from a Facebook group by group URL — List Facebook group posts.

Pass a full Facebook group URL (`facebook.com/groups/{id-or-slug}/…`), not a profile or page URL. Use `sortBy: chronological` for general feeds; use `chronologicalListings` for Buy/Sell marketplace groups. Upstream returns a small number of posts per page (often around three). No server-side keyword filter — filter client-side on `text` after fetching pages.

`lookupStatus: not_found` often means the group URL was wrong or unresolved. Each page bills separately, including `not_found` outcomes.

GET/v1/facebook/groups/posts
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
url*stringquery

Public Facebook group URL whose posts should be listed.

min 1 chars · max 4096 chars

sortBystringoptionalquery

Optional sort order for the returned posts.

one of: top, recentActivity, chronological, chronologicalListings

cursorstringoptionalquery

Opaque pagination cursor from a previous response (`data.page.nextCursor`).

min 1 chars

Response fields
26

Endpoint-specific response payload.

datalookupStatus
string

Whether the group resolved for this request.

one of: found, not_found

Posts returned for the requested group. This array may be empty when the group resolves but no posts are returned.

dataposts[]id
string

Stable identifier for the post.

min 1 chars

dataposts[]url
string

Canonical public URL for this Facebook group post.

min 1 chars

dataposts[]text
stringnullable

Text body of the post when available.

dataposts[]publishedAt
stringnullable

ISO-8601 timestamp for when the post was published, when available.

dataposts[]reactionCount
integernullable

Reaction count for the post when available.

≥ 0

dataposts[]commentCount
integernullable

Comment count for the post when available.

≥ 0

Author summary for this post.

dataposts[]authorid
stringnullable

Platform identifier for the post author when available.

dataposts[]authorname
stringnullable

Display name for the post author when available.

dataposts[]authorurl
stringnullable

Public profile URL for the post author when available.

Embedded video metadata when this post includes video.

dataposts[]videothumbnailUrl
stringnullable

Thumbnail image URL for embedded video when available.

dataposts[]videodurationMs
integernullable

Video duration in milliseconds when available.

≥ 0

dataposts[]videosdUrl
stringnullable

Standard-definition video URL when available.

dataposts[]videohdUrl
stringnullable

High-definition video URL when available.

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.

datapagehasMore
boolean

Whether another page of posts can be requested.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/facebook/groups/posts?url=https://www.facebook.com/groups/rateplate" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Group posts for the requested feed.