Facebook Page Posts API

Endpoint

GET /v1/facebook/page/posts

Parameters

page_id *

Facebook page ID (use Page Details endpoint to get this)

pages

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

start_date

Filter posts from this date (YYYY-MM-DD)

end_date

Filter posts until this date (YYYY-MM-DD)

Response fields

posts

Array of page posts

post_id

Post ID

url

Direct link to the post

message

Post text content

date

Publication date and time

timestamp

Unix timestamp

author_name

Author display name

author_id

Author Facebook ID

author_url

Author profile URL

author_profile_picture

Author profile image URL

comments_count

Number of comments

reactions_count

Total number of reactions

reshare_count

Number of shares

reactions

Breakdown of reaction types

image_url

Attached image URL

video

Attached video data

external_url

External link in the post

count

Number of posts returned

pages

Number of pages fetched

Example Request

curl "https://apidirect.io/v1/facebook/page/posts?page_id=139654476388086&start_date=2026-01-01&end_date=2026-03-01" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/facebook/page/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "page_id": "139654476388086",
        "start_date": "2026-01-01",
        "end_date": "2026-03-01"
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "post_id": "139654476388086_987654321",
      "url": "https://www.facebook.com/Meta/posts/987654321",
      "message": "We are excited to announce our latest updates to the platform...",
      "date": "2026-02-15 10:30:00",
      "timestamp": 1771148200,
      "author_name": "Meta",
      "author_id": "139654476388086",
      "author_url": "https://www.facebook.com/Meta",
      "author_profile_picture": "https://scontent.xx.fbcdn.net/v/t39.30808-1/...",
      "comments_count": 1250,
      "reactions_count": 8430,
      "reshare_count": 2100,
      "reactions": {"like": 5200, "love": 1800, "wow": 430, "haha": 500, "sad": 200, "angry": 300},
      "image_url": "https://scontent.xx.fbcdn.net/v/t39.30808-6/...",
      "video": null,
      "external_url": null
    }
  ],
  "count": 1,
  "pages": 1
}

Frequently asked questions

How do I get the page_id?

Use the Page Details endpoint (/v1/facebook/page) which returns the page_id field along with other page 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.

What engagement data is included?

Each post includes total reactions count, comments count, shares count, and a breakdown of reaction types (like, love, wow, haha, sad, angry).

How does pricing work?

You only pay for successful requests. The Facebook Page Posts 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.