> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_facebook_posts

# get_facebook_posts

> Recent posts of a public Facebook Page or profile: text, date, reactions, comments, shares and media, three a page. ₹0.28 per page; a missing or private Page is ₹0.

## What it does

Send the Page's `url` (or its numeric `pageId`) and get `data.posts[]`, three per page, each with `text`, `url`, `author`, `reactionCount` and `reaction_counts` by type, `commentCount`, `share_count`, `videoViewCount`, images and `creation_time`, plus `data.cursor` for the next page. The source hands back only three posts a page, so a month of posts takes several calls.

Use it to see what a brand says on Facebook and how people respond. For the comments under one post use [`get_facebook_comments`](https://parel.si/docs/tools/get_facebook_comments.md), for the ads a brand runs on Facebook and Instagram [`get_meta_ads`](https://parel.si/docs/tools/get_meta_ads.md), for Instagram [`get_social_posts`](https://parel.si/docs/tools/get_social_posts.md).

India: any public Page; most Indian D2C brands post the same creative here and on Instagram.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `url` | string | one of | The public Facebook Page or profile URL ("https://www.facebook.com/boat.lifestyle"). |
| `cursor` | string | no | The cursor from the previous answer, for the next page. |
| `pageId` | string | one of | The Page's numeric id, instead of url. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `url`; `pageId`.

## What drives the cost

Nothing you can turn: flat per page of three posts. A Page that does not exist or is private answers 404 at the source (`class: "vendor_error"`, ₹0). Three to ten seconds; about 12 KB a page.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per page (`cost_paise: 28`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (`hold_paise: 42`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_facebook_posts"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_facebook_posts"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_facebook_posts","input":{"url":"https://www.facebook.com/pacemorby"}}'
```

## What comes back

`data.posts[]` and `data.cursor`. A real answer recorded during the live check of 2026-11-05 (a public Page, three posts in 9.5 s), trimmed to two posts with the Page's name and links replaced:

```json
{
  "posts": [
    {
      "id": "1593991512733150",
      "text": "After meeting 40,000+ people across 100 cities…\n\nI noticed something.\n\nMost people don’t have a lead problem.\n\nThey have a conversation problem.\n\nEveryone is wa…",
      "url": "https://www.facebook.com/[page]/posts/…",
      "author": {
        "name": "[Page name]",
        "id": "100063669491743"
      },
      "reactionCount": 323,
      "share_count": 19,
      "commentCount": 91,
      "videoViewCount": 29033,
      "creation_time": "2026-03-08T15:56:46.000Z"
    },
    {
      "id": "1593164486149186",
      "text": "Yuma showed up big.\n\nI love seeing what happens when you get a room full of people who are serious about changing their life through real estate.\n\nSome people i…",
      "url": "https://www.facebook.com/[page]/posts/…",
      "author": {
        "name": "[Page name]",
        "id": "100063669491743"
      },
      "reactionCount": 70,
      "share_count": 2,
      "commentCount": 12,
      "videoViewCount": null,
      "creation_time": "2026-03-07T15:03:10.000Z"
    }
  ],
  "cursor": "Cg8Ob3JnYW5pY19jdXJzb3IJAAACRE…"
}
```

## Notes

- Flat per page of three posts (the source's limit); pass cursor for the next page. Each page is a call.
- A missing or private Page answers nothing, free.
- For a brand's paid creative use get_meta_ads; this is the organic feed.

## Siblings

- [`get_facebook_comments`](https://parel.si/docs/tools/get_facebook_comments.md) for what people wrote under a post.
- [`get_meta_ads`](https://parel.si/docs/tools/get_meta_ads.md) for the brand's paid creative.
