> ## 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.

# Reddit Posts

> Configure a workflow step that reads a Reddit post from its URL

Use **Reddit Posts** when you have the URL of a Reddit thread and want its details as data: the title, the post text, the votes, the comment count and the subreddit. A typical use is to take Reddit threads found in Google results and read each one.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| URL | Yes | The Reddit post URL, for example `https://www.reddit.com/r/python/comments/1asdf12/how_do_i_start_learning_python/`. 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...**.

Reddit scrapes can sometimes take several minutes, so a run may stay in progress for a while before the records appear.

## 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 Reddit post ID. |
| `url` | The post URL. |
| `title` | The post title. |
| `description` | The post text. |
| `user_posted` | The username of the author. |
| `num_upvotes` | The number of upvotes. |
| `num_comments` | The number of comments. |
| `date_posted` | When the post was published. |
| `tag` | The post flair, if any. |
| `community_name` | The subreddit name. |
| `community_url` | The subreddit URL. |
| `community_description` | The subreddit description. |
| `community_members_num` | How many members the subreddit has. |
| `photos` | Images attached to the post. |
| `videos` | Videos attached to the post. |

## Example

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

Set **Name** to something like `Reddit Posts`.

Enter the Reddit post 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

* The step reads one post per run. To read many, put it inside a loop over a list of URLs.
* Add **Reddit Comments** to read the discussion under the post.
* 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 Comments](https://docs.fetchhive.com/workflows/steps/web-research/reddit-comments.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.