Facebook Reels
Facebook Reels are short-form public videos in profile or Page feeds, with captions, author context, playback metadata, timestamps, and visible engagement. These records support content inventories, short-video research, feed monitoring, and comparative analysis.
Features
- Multi-profile Reel feedsCollect public Reel records from one or more Facebook profile or Page URLs, applying the requested limit to each input and retaining extra.input_url for attribution.
- Normalized video mediaReturn video URLs, thumbnails, dimensions, and duration metadata together with Reel IDs and public source links.
- Creator and engagement contextPreserve captions, raw public author context, visible likes, comments, views, plays, shares, and publication times for each normalized Reel.
- Stable feed traversalFollow profile-specific cursors and remove duplicate Reels by ID, post ID, or URL before reaching the per-input limit.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Public Facebook profile or Page URLs, separated by commas or new lines. |
results_limit | Optional | Maximum Reels to collect per input URL, from 20 to 2,000; the default is 100. |
How to Use
Submit public profile or Page URLs as an asynchronous task, poll its task ID, then read normalized Reel records through result cursor pagination.
- Prepare one or more public Facebook profile or Page URLs that expose Reel feeds.
- POST urls with an optional results_limit to /v1/facebook/reels.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read /v1/tasks/{task_id}?limit=50 and pass results.next_cursor when more saved Reels exist.
curl -X POST "https://api.socq.ai/v1/facebook/reels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Best Use Cases
- Profile Reel inventory: Organize Reel IDs, source links, captions, video references, timestamps, and extra.input_url into a profile-specific content index.
- Short-video format research: Compare duration, dimensions, thumbnails, captions, and visible engagement to study how public Reels are packaged and received.
- Reel feed monitoring: Repeat collections for selected profile or Page URLs and use stable Reel identity plus publication time to detect newly exposed records.
Pro Tips
- Use facebook.com, www.facebook.com, or m.facebook.com profile and Page URLs that expose a public Reel feed; host validation alone does not guarantee the target resource is appropriate.
- Set results_limit with the number of input URLs in mind because the 20 to 2,000 limit is applied independently to every URL.
- When combining repeated runs, deduplicate by Reel ID, post ID, or URL together with extra.input_url to preserve the correct source profile.
- Treat captions, author fields, metrics, timestamps, and media metadata as optional, and verify that media contains a video URL before rendering or downloading it.
- When spoken-word text is required, submit the known Reel URL to the Facebook Video Transcript API instead of expecting a transcript in Reel records.
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 Group Posts API — Collect public posts from Facebook group URLs with selectable ordering, per-group limits, author context, video media, and visible engagement.
- 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.