# Facebook API

The Facebook API lets you read post details, comments, account profiles and an account's posts, with no Facebook account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Facebook does not give the author's follower count with a post, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-10-17.

- Page: https://socialtoai.com/platforms/facebook/
- Last updated: 2026-10-17
- Last tested: 2026-10-17

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `detail` | One post by link: text, author, likes, comment count, views and publish time. | — | `facebook.detail` | 2 | https://socialtoai.com/facebook-detail-api.md |
| `comments` | The comments under one post: text, likes, reply count and time. | — | `facebook.comments` | 2 | https://socialtoai.com/facebook-comments-api.md |
| `user_profile` | One account: name, bio and followers. | — | `facebook.user_profile` | 2 | https://socialtoai.com/facebook-user-profile-api.md |
| `user_posts` | The recent posts of one account. | — | `facebook.user_posts` | 2 | https://socialtoai.com/facebook-user-posts-api.md |

Not offered on Facebook: search and trending.

## Example call

```bash
curl https://api.socialtoai.com/v1/detail \
  -H "Authorization: Bearer $SOCIALTOAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "facebook",
    "url": "https://www.facebook.com/reel/2166091230582141"
  }'
```

## Fields Facebook cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `title` | detail, user_posts |
| `author.followers` | detail, user_posts |
| `metrics.collects` | detail, user_posts |
| `metrics.reposts` | detail, user_posts |
| `hashtags` | detail, user_posts |
| `is_pinned` | detail, user_posts |
| `url` | comments |
| `parent_id` | comments |
| `root_id` | comments |
| `verified` | user_profile |
| `following` | user_profile |
| `posts_count` | user_profile |
| `author.username` | user_posts |
| `author.verified` | user_posts |
| `metrics.shares` | user_posts |
| `metrics.views` | user_posts |

## Ask in your AI

- Read the comments on this Facebook post and tell me what people complain about. → detail, comments × 3: 8 credits

- How big is this Facebook account, and what has it posted lately? → user_profile, user_posts: 4 credits

- Look up this Facebook account and tell me who it is. → user_profile: 2 credits

## Ready-made tools that read Facebook

- [Comment analysis](https://socialtoai.com/tools/comment-insights.md): The topics in their comments and how big each is, plus questions, buying intent and complaints
- [Account watch](https://socialtoai.com/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Creator profile](https://socialtoai.com/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.com/tools/batch-stats.md): One row per link with its numbers as they are now. Links that no longer work are marked

## Official API

Facebook's Graph API can read public Page posts, comments and metadata only through the Page Public Content Access feature, which requires App Review and business verification and may require additional contracts.

Source: [Facebook's developer documentation](https://developers.facebook.com/docs/features-reference/page-public-content-access), checked 2026-10-17.