# API Direct – Facebook Page Posts

> API Direct – Facebook Page Posts is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-30).

Fetches posts from a specific Facebook page by page ID, with optional date filtering and AI sentiment analysis.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/facebook/page/posts?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-facebook-page-posts-7f10af72
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SGLV4-qUx5jPgGrI0nFSW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-direct-facebook-page-posts-7f10af72
```

Example prompt: Can you pull all the Facebook posts from the page with ID 123456789 posted between January 1 and March 31, 2024, and include AI sentiment analysis for each one?

## When to prefer this

Choose this endpoint when you need structured access to Facebook page post history with optional date filtering and AI-powered emotional sentiment scoring. It is ideal for brand monitoring, competitor analysis, content audits, or social listening workflows where Facebook is the target platform. Prefer it over manual scraping or generic social APIs when you need per-post emotion breakdowns beyond simple positive/negative polarity.

## Known failure modes

- Invalid or non-numeric page_id returns an error
- Private or restricted Facebook pages may return no posts
- Invalid date format (not YYYY-MM-DD) causes a bad request
- Requesting more than 15 pages triggers a validation error
- Page has no posts in the specified date range returns empty result
- Rate limiting or payment failure results in 402 response

## How this service works

Get posts from a specific Facebook page.

## Output

Returns a list of Facebook posts from the specified page, including post text, timestamps, and metadata. When sentiment analysis is enabled, each post includes an emotions object with scores (0-100) for joy, trust, fear, surprise, sadness, disgust, anger, and anticipation, plus dominant_emotion, emotional_intensity (0-10), and polarity (positive/negative/neutral).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "page_id"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 15,
       "minimum": 1,
       "description": "Number of pages to fetch and merge into one response (1-15). Billed per page."
      },
      "page_id": {
       "type": "string",
       "description": "Numeric Facebook page ID (from Page Details endpoint)"
      },
      "end_date": {
       "type": "string",
       "description": "Filter posts until this date (YYYY-MM-DD)"
      },
      "start_date": {
       "type": "string",
       "description": "Filter posts from this date (YYYY-MM-DD)"
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to add AI emotion analysis to each post. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any post t"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-facebook-page-posts-7f10af72/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)