Skip to main content
GET
Get a public Facebook group's posts

Authorizations

x-api-key
string
header
required

Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.

Query Parameters

url
string

Required — provide one of url or groupId. Public Facebook group URL, e.g. https://www.facebook.com/groups/cristianoronaldo404.

groupId
string

Required — provide one of url or groupId. Numeric group id (faster than url).

cursor
string

The paging.cursor from a previous call, to fetch the next page.

sortBy
enum<string>
default:CHRONOLOGICAL

Feed ordering (default CHRONOLOGICAL). CHRONOLOGICAL = newest first; TOP_POSTS = Facebook's "Most relevant"; RECENT_ACTIVITY = most recent activity first; CHRONOLOGICAL_LISTINGS = newest buy/sell listings (only groups with marketplace listings return anything). Case-insensitive; spaces are accepted (e.g. "recent activity").

Available options:
CHRONOLOGICAL,
TOP_POSTS,
RECENT_ACTIVITY,
CHRONOLOGICAL_LISTINGS
cache_max_age
enum<string>

Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.

Available options:
1d,
3d,
7d,
14d,
30d

Response

The group posts.

data
object
required
meta
object
required

requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt).