Social Fetch
Facebook

List Facebook group posts

Lists posts for a public Facebook group. Pass the full group URL and optional `sortBy` and `cursor` for pagination. Check `data.lookupStatus` for `found` vs `not_found`.

Operation

GET/v1/facebook/groups/posts
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Public Facebook group URL whose posts should be listed.

min 1 chars · max 4096 chars

sortBystring(query)

Optional sort order for the returned posts.

one of: top, recentActivity, chronological, chronologicalListings

cursorstring(query)

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

min 1 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the group resolved for this request.

one of: found, not_found

dataposts
arrayrequired

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

dataposts[]id
stringrequired

Stable identifier for the post.

min 1 chars

dataposts[]url
stringrequired

Canonical public URL for this Facebook group post.

min 1 chars

dataposts[]text
stringrequirednullable

Text body of the post when available.

dataposts[]publishedAt
stringrequirednullable

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

dataposts[]reactionCount
integerrequirednullable

Reaction count for the post when available.

≥ 0

dataposts[]commentCount
integerrequirednullable

Comment count for the post when available.

≥ 0

dataposts[]author
objectrequired

Author summary for this post.

dataposts[]authorid
stringrequirednullable

Platform identifier for the post author when available.

dataposts[]authorname
stringrequirednullable

Display name for the post author when available.

dataposts[]authorurl
stringrequirednullable

Public profile URL for the post author when available.

dataposts[]video
objectrequired

Embedded video metadata when this post includes video.

dataposts[]videothumbnailUrl
stringrequirednullable

Thumbnail image URL for embedded video when available.

dataposts[]videodurationMs
integerrequirednullable

Video duration in milliseconds when available.

≥ 0

dataposts[]videosdUrl
stringrequirednullable

Standard-definition video URL when available.

dataposts[]videohdUrl
stringrequirednullable

High-definition video URL when available.

datapage
objectrequired

Pagination information for the current response.

datapagenextCursor
stringrequirednullable

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

datapagehasMore
booleanrequired

Whether another page of posts can be requested.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Group posts for the requested feed. Check `data.lookupStatus` for `found` vs `not_found`.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page