What is the Facebook Reels API?

Facebook Reels API is a programmatic interface for collecting short-video records from the public Reel feed of a specified Facebook profile or Page, simplifying bulk inventory and ongoing observation. Content teams can use those records for account monitoring and comparative research, but only Reels accessible through the target’s public feed are covered.

Which Facebook URLs can I submit?

Use public profile or Page targets on facebook.com, www.facebook.com, or m.facebook.com. Validation checks the host, so a different Facebook resource can still return no appropriate Reel feed.

Which fields are returned for each Reel?

A record can include Reel ID, canonical URL, caption text, raw public author context, visible metrics, video URL, thumbnail, dimensions, duration, created_at, collected_at, and extra.input_url.

Does the Facebook Reels API return transcripts?

No. Reel records contain captions and video metadata, while available spoken-word text is handled by the dedicated Facebook Video Transcript API for supported Reel URLs.

Can I discover Reels by keyword or trend?

No. This endpoint reads Reel feeds for known public profile or Page URLs; it does not provide keyword search, trending discovery, or audio-based discovery.

How does results_limit work with multiple URLs?

Set results_limit from 20 to 2,000, with 100 used by default. The limit applies separately to each submitted URL.

Will the endpoint return every historical Reel?

No. Collection stops at the per-URL limit, the end of the available feed, or 100 feed pages, and private, restricted, deleted, login-only, or otherwise unavailable Reels can be absent.

How is Facebook Reels API usage billed?

Each saved Reel record costs 0.7 credits, with no base task charge. Estimates multiply the per-URL result limit by the number of submitted URLs.

Facebook Reels API: Public Reel Data

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.

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.

Combine Facebook data with public data from other supported social platforms.