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

# Reddit posts

> Reddit posts and their comments from a search term, subreddit, user profile or direct post URL, with title, body, community, author, timestamps and optionally u

Reddit posts and their comments from a search term, subreddit, user profile or direct post URL, with title, body, community, author, timestamps and optionally upvotes and media links.

<Note>Use for broad Reddit research where you want posts together with their comment threads from public pages. This actor charges a fixed \$0.04 start fee before the first result, so send one larger request rather than many tiny ones.</Note>

## Price

**\$0.0114 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field           | Type                                                   | Required | Notes                                                                                                                       |
| --------------- | ------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| `sort`          | `relevance`, `hot`, `top`, `new`, `rising`, `comments` |          | Defaults to `"new"`.                                                                                                        |
| `time`          | `all`, `hour`, `day`, `week`, `month`, `year`          |          |                                                                                                                             |
| `maxItems`      | `integer`                                              |          | Maximum items saved across the whole run. Billed per item, on top of the fixed \$0.04 start fee Defaults to `10`.           |
| `searches`      | `array`                                                |          | Search terms to run against Reddit. Remove startUrls when you use this                                                      |
| `startUrls`     | `array`                                                |          | Reddit post, subreddit, user or search URLs. Leave empty when you use searches                                              |
| `includeNSFW`   | `boolean`                                              |          | Defaults to `false`.                                                                                                        |
| `maxComments`   | `integer`                                              |          | Maximum comments taken from each post page. Set to 0 to skip comments. Comments count as billed items too Defaults to `10`. |
| `searchMedia`   | `boolean`                                              |          | Also search media posts for the search terms.                                                                               |
| `searchPosts`   | `boolean`                                              |          | Defaults to `true`.                                                                                                         |
| `searchUsers`   | `boolean`                                              |          | Defaults to `false`.                                                                                                        |
| `maxPostCount`  | `integer`                                              |          | Maximum posts taken from each posts page or community page Defaults to `10`.                                                |
| `maxUserCount`  | `integer`                                              |          | Pages of user results to scrape. The actor takes 2 when you leave it out. Each page is more billed items.                   |
| `skipComments`  | `boolean`                                              |          | Do not scrape comments while going through posts Defaults to `false`.                                                       |
| `postDateLimit` | `string`                                               |          | Only posts published after this date                                                                                        |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"reddit.posts","input":{"maxItems":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "id": "t3_1rxssfj",
  "url": "https://www.reddit.com/r/programming/comments/1rxssfj/example_post_title/",
  "body": "The full selftext of the post.",
  "isAd": false,
  "title": "Example post title",
  "over18": false,
  "userId": "sample-id-000",
  "isVideo": false,
  "upVotes": 11,
  "dataType": "post",
  "parsedId": "1rxssfj",
  "username": "example_user",
  "createdAt": "2026-07-29T06:20:58.000Z",
  "scrapedAt": "2026-07-30T14:34:01.975Z",
  "communityName": "r/programming",
  "numberOfComments": 16,
  "parsedCommunityName": "programming"
}
```