The OG social network. It’s robust, but it carries a lot of legacy baggage. And rate limits. So many rate limits.Documentation Index
Fetch the complete documentation index at: https://info.bundle.social/llms.txt
Use this file to discover all available pages before exploring further.
Supported Content Types
- Page Posts: Text, Link, Image, Video. 0-10 files.
- Reels: Vertical video for Pages. 1 video.
- Stories: Image or video. 1 file.
- Page Reviews: Import and reply to Facebook Page reviews through a separate async flow.
Page Reviews
Facebook Page Reviews run on a separate async flow. You start an import job, poll status, then fetch imported reviews and reply where Facebook allows it. Full guide: Facebook Page ReviewsQuirks & Gotchas
Page Tokens Expire (Important!)
Facebook Page Access Tokens typically expire after 60 days.This is not a bug, it’s a feature. If a user changes their password or security settings, the token dies immediately. You need to build your app to handle re-connection flows gracefully. We handle automatic refreshing where possible, but we can’t perform miracles. If the token dies, the user needs to reconnect.
Reels Limitations
Facebook Reels via API are stricter than mobile uploads:- No “Remix” functionality available via API.
- Duration: 3 seconds to 8 minutes (480s). Not 60s - that’s Stories.
- Minimum resolution: 540x960.
Media Limits
See Platform Limits for the full breakdown of file sizes, resolutions, aspect ratios, and bitrates.Text & Field Limits
| Field | Limit |
|---|---|
text | Max 50,000 characters |
link | Max 2,048 characters |
mediaTitle | Max 255 characters |
altText | Optional. Accessibility description for image posts (screen readers and when images fail to load). |
Alt text applies to image-based Page posts. Pair it with your image
uploadIds when you want Meta to store accessibility text alongside the media.Analytics
For general analytics concepts (refresh rates, data retention, what “Returns 0” means), see the Analytics Overview.Profile Analytics
Period: Rolling window (30 days).Why so many zeros? To avoid hitting Facebook’s aggressive rate limits, we’ve disabled fetching profile-level likes, comments, and post counts. We’d have to scan every single post on your page to get these, and Facebook would block us (and you). It’s not worth it.
| Metric | Description | Note |
|---|---|---|
impressions | Total impressions | |
impressionsUnique | Unique users reached | Uses 28-day period to avoid overcounting |
views | Page views | |
viewsUnique | - | Returns 0 (not provided by API) |
likes | - | Returns 0 (disabled to save rate limits) |
comments | - | Returns 0 (disabled to save rate limits) |
postCount | - | Returns 0 (disabled to save rate limits) |
followers | Page followers | |
following | - | Returns 0 (not applicable to Pages) |
Post Analytics
Period: Lifetime (Snapshot).| Metric | Description | Note |
|---|---|---|
impressions | Total impressions | |
impressionsUnique | Unique impressions | |
views | Video views | Video posts only |
viewsUnique | Unique video views | Video posts only |
likes | Total reactions | Aggregates Like, Love, Wow, Haha, Anger |
comments | Total comments | |
shares | Total shares | |
saves | Total saves |
Reaction Aggregation
When we say “Likes” for Facebook, we mean all reactions combined. Whether someone Loved it, Hated it (Anger), or Laughed at it (Haha) - it all counts as onelikes number. We don’t break down reaction types in the standard schema. If you need that granularity, check the raw analytics data.