Facebook Page Reels

Get reels from a Facebook page. Requires the reels_page_id which can be obtained from the page details endpoint. Returns reel metadata and engagement metrics. Supports fetching multiple pages in a single call.

Endpoint

GET /v1/facebook/page/reels

Price: $0.008 per page Free tier: 50 requests/month

Parameters

Parameter	Required	Description
`reels_page_id`	Yes	Reels page ID (get from the page details endpoint `reels_page_id` field)
`pages`	No	Number of pages to fetch (1-10, default 1). Billed per page.
`get_sentiment`	No	Set to `true` to add AI emotion analysis (Plutchik’s Wheel) to each result. Adds +$0.001 per page to the cost. Returns emotion scores, dominant emotion, intensity, and polarity.

Response Fields

Field	Type	Description
`reels`	array	List of reel objects
`reels[].video_id`	string	Unique video ID
`reels[].post_id`	string	Associated post ID
`reels[].url`	string	URL to the reel on Facebook
`reels[].description`	string	Reel description / caption
`reels[].date`	string	Human-readable date
`reels[].timestamp`	integer	Unix timestamp
`reels[].length_in_seconds`	number	Duration of the reel in seconds
`reels[].play_count`	integer	Number of plays
`reels[].comments_count`	integer	Number of comments
`reels[].reactions_count`	integer	Total number of reactions
`reels[].reshare_count`	integer	Number of shares
`reels[].author_name`	string	Name of the reel author
`reels[].author_url`	string	URL to the author’s profile
`reels[].thumbnail`	string	URL to the reel thumbnail image
`reels[].sentiment`	object/null	Emotion analysis results. Only present when `get_sentiment=true`. Returns `null` if analysis fails.
`reels[].sentiment.emotions`	object	Plutchik emotion scores (0-100) for: `joy`, `trust`, `fear`, `surprise`, `sadness`, `disgust`, `anger`, `anticipation`.
`reels[].sentiment.dominant_emotion`	string	The emotion with the highest score.
`reels[].sentiment.emotional_intensity`	integer	Overall emotional intensity on a scale of 0-10.
`reels[].sentiment.polarity`	string	Overall sentiment polarity: `positive`, `negative`, or `neutral`.
`count`	integer	Number of reels returned
`pages`	integer	Number of pages fetched

Example Request

cURL

curl "https://apidirect.io/v1/facebook/page/reels?reels_page_id=YXBwX2NvbGxlY3Rpb246cGZiaWQwcTlLYm..." \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

# First, get the reels_page_id from the page details endpoint
details = requests.get(
    "https://apidirect.io/v1/facebook/page",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"url": "https://www.facebook.com/facebook"}
).json()

reels_page_id = details["page"]["reels_page_id"]

response = requests.get(
    "https://apidirect.io/v1/facebook/page/reels",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"reels_page_id": reels_page_id}
)
print(response.json())

Example Response

{
  "reels": [
    {
      "video_id": "894523017483261",
      "post_id": "894523017483261_100064860875397",
      "url": "https://www.facebook.com/reel/894523017483261",
      "description": "What happens when you bring people together? Amazing things.",
      "date": "2025-12-08 16:45:00",
      "timestamp": 1733676300,
      "length_in_seconds": 28.4,
      "play_count": 1842093,
      "comments_count": 4312,
      "reactions_count": 67481,
      "reshare_count": 12094,
      "author_name": "Facebook",
      "author_url": "https://www.facebook.com/facebook",
      "thumbnail": "https://scontent.xx.fbcdn.net/v/t15.5256-10/894523_..._n.jpg",
      "sentiment": {
        "emotions": {
          "joy": 40,
          "trust": 55,
          "fear": 0,
          "surprise": 10,
          "sadness": 0,
          "disgust": 0,
          "anger": 0,
          "anticipation": 30
        },
        "dominant_emotion": "trust",
        "emotional_intensity": 5,
        "polarity": "positive"
      }
    },
    {
      "video_id": "851749203847192",
      "post_id": "851749203847192_100064860875397",
      "url": "https://www.facebook.com/reel/851749203847192",
      "description": "3 features you probably didn't know about",
      "date": "2025-11-29 12:00:00",
      "timestamp": 1732881600,
      "length_in_seconds": 15.7,
      "play_count": 934571,
      "comments_count": 1829,
      "reactions_count": 42318,
      "reshare_count": 7203,
      "author_name": "Facebook",
      "author_url": "https://www.facebook.com/facebook",
      "thumbnail": "https://scontent.xx.fbcdn.net/v/t15.5256-10/851749_..._n.jpg"
    }
  ],
  "count": 2,
  "pages": 1
}