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

# Facebook Group Posts

> Configure a workflow step that reads recent posts from a public Facebook group

Use **Facebook Group Posts** when you want to see what a community talks about. The step reads recent posts from a public Facebook group and returns each post with its author, reactions, comment count and group details.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| URL | Yes | The Facebook group URL, for example `https://www.facebook.com/groups/123456789`. This field supports workflow variables through **Insert Variable**. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Add this step from the **Content & Social** group in **Search steps...**.

## Output

Click **Run** in the step header to test the step. Fetch Hive shows the records in **Output** after the run completes.

Use the variable picker in a later step to insert the exact output path available for that run. The step returns a list of records, so the whole result is:

```text theme={null}
{{step_2.output}}
```

The output is a list. There is no `items` or `results` wrapper. To use the first record:

```text theme={null}
{{step_2.output[0]}}
```

Each record includes:

| Field | Meaning |
| - | - |
| `post_id` | The post ID. |
| `url` | The post URL. |
| `content` | The post text. Can be empty for posts with only media. |
| `date_posted` | When the post was published. |
| `user_username_raw` | The name of the author. |
| `user_url` | The author's profile URL. |
| `num_comments` | The number of comments. |
| `num_shares` | The number of shares. |
| `likes` | The number of reactions, when available. |
| `attachments` | Images, videos or files attached to the post. |
| `post_type` | The kind of post. |
| `group_name` | The group name. |
| `group_url` | The group URL. |
| `group_members` | How many members the group has. |
| `group_category` | Whether the group is public. |

## Example

Add **Facebook Group Posts** from the **Content & Social** group in **Search steps...**.

Set **Name** to something like `Facebook Group Posts`.

Enter the Facebook group URL in **URL**, or click **Insert Variable** to use a value from an earlier step or workflow input.

Click **Run** and review the records in **Output**.

## Notes

* Only public groups can be read.
* Each post is one item. A run returns at most 500 posts, and the charge grows with the number returned.
* `content` and `likes` can be empty, for example on posts that contain only an image.
* Each run costs at least 2 task credits. The cost grows with the number of records returned. See [Task costs](https://docs.fetchhive.com/resources/task-costs.md).

See also: [Reddit Posts](https://docs.fetchhive.com/workflows/steps/web-research/reddit-posts.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md), and [Error Handling](https://docs.fetchhive.com/workflows/error-handling.md)


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