Facebook Group Posts
Facebook Group Posts are public group updates with message text, author identity, publication time, source links, visible reactions, comments, views, and video media. These records support group activity monitoring, discussion research, engagement comparison, and public-content reporting.
Features
- Public group URL batchesAccept one or more public Facebook group URLs and preserve the originating group URL with every normalized post record.
- Four group ordering modesUse top_posts, recent_activity, chronological, or chronological_listings to select the ordering applied across submitted groups.
- Per-group collection depthApply results_limit separately to each group URL, with a default of 100 and an accepted range from 3 through 2,000.
- Post and author contextReturn post IDs, source URLs, message text, author IDs and names, publication times, and collection times in a consistent structure.
- Visible engagement and videoInclude visible reaction, comment, and video view counts plus normalized video and thumbnail URLs when a public post exposes them.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required public Facebook group URLs, separated by commas or new lines. |
results_limit | Optional | Maximum posts requested for each group URL; defaults to 100 and accepts integers from 3 through 2,000. |
sort_by | Optional | Optional ordering applied to every submitted group: top_posts, recent_activity, chronological, or chronological_listings. |
How to Use
Submit public group URLs with optional ordering and a per-group result limit, then read the asynchronous task results with cursor pagination.
- Prepare one or more public Facebook group URLs.
- POST urls with optional results_limit and sort_by to /v1/facebook/group-posts, then store the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
- Read data.results.items and request the returned next_cursor while has_more remains true.
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Public group activity review: Use recent_activity or chronological ordering with message, author, created_at, and group_url fields to review public updates from selected groups.
- Group discussion archives: Store post IDs, message text, author context, source URLs, publication times, and collection times as attributable public group records.
- Aligned engagement comparison: Apply the same sort_by across group URLs and compare reactions_count, comments_count, and views_count under one ordering.
Pro Tips
- Submit direct public group URLs rather than a group name so every input remains tied to an unambiguous source.
- Calculate requested depth as the number of urls multiplied by results_limit because the limit applies separately to each group.
- Run separate tasks when comparing ordering modes because one sort_by value is applied to every group URL in a request.
- Retain id and extra.group_url together so downstream records remain attributable and can be deduplicated within each group.
- Treat author, message, publication time, video media, and video view counts as optional when a public post does not expose them.
- Follow results.next_cursor until has_more is false when the completed task contains more than one result page.
Related APIs
Use these APIs when you need a different type of public Facebook data.
- Facebook Pages API — Retrieve public Page profiles, contact details, images, and visible audience ratings.
- Facebook Posts API — Collect public posts, media, reactions, comments, and shares from supported Facebook URLs.
- Facebook Comments API — Collect public comments, authors, engagement, media, and source links from post URLs.
- Facebook Video Transcript API — Extract available transcript text and format from known public video post or Reel URLs.
- Facebook Events Search API — Search public events by keyword with schedule, place, attendance, cover media, and event-state fields.
- Facebook Ad Transcript API — Extract available spoken-word text, language, format, and source context from Facebook Ad Library URLs.
- Facebook Comment Replies API — Retrieve public replies for a known comment using its feedback ID and expansion token, with text, author identity, engagement, and parent context.
- Facebook Company Reviews API — Collect public Page reviews with review text, reviewer links, ratings, likes, timestamps, and company context.
- Facebook Event Details API — Collect normalized metadata, schedules, locations, media, and visible engagement from known public event URLs.
- Facebook Profile Events API — Collect public events associated with profile or Page URLs, including names, schedules, locations, media, visible metrics, and source context.
- Facebook Profile Photos API — Collect public photos from profile or Page URLs with captions, author context, engagement, image metadata, and source references.
- Facebook Profiles API — Look up public profiles or Pages from known Facebook URLs with identity, bio, avatar, visible counters, and input context.
- Facebook Reels API — Collect public Reels from profile or Page URLs with captions, author context, video metadata, visible engagement, and source references.