> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ScrapeCreators: Facebook Group Posts

> Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations.

> [!NOTE]
>
> Tool ID: `scrapecreators_facebook_group_posts`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_facebook_group_posts',
  {
    "url": "https://example.com",
    "group_id": "group_123",
    "sort_by": "TOP_POSTS"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute scrapecreators_facebook_group_posts --input '{
  "url": "https://example.com",
  "group_id": "group_123",
  "sort_by": "TOP_POSTS"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe scrapecreators_facebook_group_posts --json` for the complete live contract.

## Input reference

Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails, and topComments. Results are chronological by default. Supports TOP\_POSTS, RECENT\_ACTIVITY, CHRONOLOGICAL, and CHRONOLOGICAL\_LISTINGS with cursor-based pagination. posts\[].is\_paid\_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship. null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. shared\_post\_id and shared\_post\_url identify the immediate post being shared when Facebook exposes it. both are nullable strings and are null when the reference is unavailable. Null does not prove the post is not a share. Existing id, post\_id, See the live schema below for the complete notes.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.url` | `string` | No | — | The URL of the group |
| `payload.group_id` | `string` | No | — | The ID of the group |
| `payload.sort_by` | `"TOP_POSTS" \| "RECENT_ACTIVITY" \| "CHRONOLOGICAL" \| "CHRONOLOGICAL_LISTINGS"` | No | — | How to sort the posts. Defaults to CHRONOLOGICAL. Allowed: `TOP_POSTS`, `RECENT_ACTIVITY`, `CHRONOLOGICAL`, `CHRONOLOGICAL_LISTINGS`. |
| `payload.cursor` | `string` | No | — | The cursor to paginate to the next page |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails, and topComments. Results are chronological by default. Supports TOP_POSTS, RECENT_ACTIVITY, CHRONOLOGICAL, and CHRONOLOGICAL_LISTINGS with cursor-based pagination. posts[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. shared_post_id and shared_post_url identify the immediate post being shared when Facebook exposes it; both are nullable strings and are null when the reference is unavailable. Null does not prove the post is not a share. Existing id, post_id, and url values remain unchanged. The original is not automatically fetched, and these fields add no additional upstream requests. Call /v1/facebook/post with shared_post_url separately to retrieve the original's available media.",
    "properties": {
      "url": {
        "type": "string",
        "description": "The URL of the group"
      },
      "group_id": {
        "type": "string",
        "description": "The ID of the group"
      },
      "sort_by": {
        "type": "string",
        "description": "How to sort the posts. Defaults to CHRONOLOGICAL.",
        "enum": [
          "TOP_POSTS",
          "RECENT_ACTIVITY",
          "CHRONOLOGICAL",
          "CHRONOLOGICAL_LISTINGS"
        ]
      },
      "cursor": {
        "type": "string",
        "description": "The cursor to paginate to the next page"
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `unknown` | Yes | — | Provider response payload. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "description": "Provider response payload."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0.02` per pricing unit.

## Related documentation

* [ScrapeCreators provider guide](https://deepline.com/docs/providers/scrapecreators/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.