Facebook Page Reels API

Endpoint

GET /v1/facebook/page/reels

Parameters

reels_page_id *

Reels page ID (from Page Details endpoint)

pages

Number of pages to fetch (1-10, default 1). Billed per page.

Response fields

reels

Array of page Reels

video_id

Video ID

post_id

Associated post ID

url

Direct link to the Reel

description

Reel description/caption

date

Publication date and time

timestamp

Unix timestamp

length_in_seconds

Video duration in seconds

play_count

Number of plays/views

comments_count

Number of comments

reactions_count

Total number of reactions

reshare_count

Number of shares

author_name

Author display name

author_url

Author profile URL

thumbnail

Video thumbnail URL

count

Number of Reels returned

pages

Number of pages fetched

Example Request

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

import requests

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

Example Response

{
  "reels": [
    {
      "video_id": "9876543210987654",
      "post_id": "139654476388086_9876543210987654",
      "url": "https://www.facebook.com/reel/9876543210987654",
      "description": "Behind the scenes at Meta HQ #tech #meta",
      "date": "2026-02-20 16:30:00",
      "timestamp": 1771590600,
      "length_in_seconds": 30,
      "play_count": 1250000,
      "comments_count": 3400,
      "reactions_count": 45000,
      "reshare_count": 8200,
      "author_name": "Meta",
      "author_url": "https://www.facebook.com/Meta",
      "thumbnail": "https://scontent.xx.fbcdn.net/v/t15.5256-10/..."
    }
  ],
  "count": 1,
  "pages": 1
}

Frequently asked questions

Where do I get the reels_page_id?

Use the Facebook Page Details endpoint (/v1/facebook/page) which returns a reels_page_id field. This ID is required for the Reels endpoint.

What engagement data is included?

Each Reel includes play count, reactions count, comments count, and reshare count, plus the video duration and author information.

How does pagination work?

Use the pages parameter to fetch multiple pages of results in a single request (1-10). Each page is billed separately. Default is 1 page.

How does pricing work?

You only pay for successful requests. The Facebook Page Reels API costs $0.008 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.