Pages, Reels, and Stories — mind the token expiry.
Facebook supports Page posts, Reels, Stories, and Page Reviews, with some legacy considerations around token management and rate limits.
Supported Content Types
- Page Posts: Text, Link, Image, or Video (0–10 files).
- Reels: Vertical video for Pages (1 video).
- Stories: Image or video (1 file).
- Page Reviews: a separate async import/reply flow.
Page Reviews
Page Reviews operate on a distinct async workflow: initiate an import job, monitor its status, retrieve reviews, and respond where permitted. Full details live in the dedicated API reference.
Quirks & Gotchas
Token Expiration
Facebook Page Access Tokens typically expire after 60 days. Password changes or security updates cause immediate invalidation, requiring a reconnection flow.
Reels Specifications
- Duration: 3 seconds to 8 minutes (not 60 seconds).
- Minimum resolution: 540×960.
- Remix functionality is unavailable via API.
Text & Field Limits
| Field | Maximum |
|---|---|
text | 50,000 characters |
link | 2,048 characters |
mediaTitle | 255 characters |
altText | Optional accessibility descriptions |
Post Options
| Field | Type | Description |
|---|---|---|
type | POST / REEL / STORY | Defaults to POST. |
text | string | Caption content. |
uploadIds | array | Bundle media references. |
mediaItems | array | Per-upload metadata, including altText. |
link | string | URL for POST types only. |
thumbnail | string | Uploaded image URL. |
mediaTitle | string | Video title (255 char max). |
nativeScheduleTime | date | Meta scheduling (30-day maximum). |
Analytics
Profile Analytics (30-day rolling)
impressions,impressionsUnique,views,followers.- Likes / comments / post counts return
0to prevent rate-limit violations.
Post Analytics (lifetime)
impressions,impressionsUnique,views,viewsUnique(video),likes,comments,shares,saves.- "Likes" aggregates all reaction types.
Raw Data Access
Detailed reaction breakdowns (post_reactions_love_total, etc.), video metrics,
and demographic insights are available through the raw analytics payloads.