> ## 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 API search

> Reddit posts, comments, communities and users read through Reddit's own API, returning title, body, HTML, upvotes, comment count, author and community for each 

Reddit posts, comments, communities and users read through Reddit's own API, returning title, body, HTML, upvotes, comment count, author and community for each post.

<Note>Use as the fast structured Reddit reader for a search query, a subreddit feed, a single post URL or a user profile. Each query, subreddit or URL is a separate job, and a search job always fetches and bills a full page of 25 items, so asking for fewer does not cost less.</Note>

## Price

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

Billing follows actual usage, so a call that returns fewer item\_returneds 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`, `new`, `top`, `comments`, `controversial`, `rising` |          | relevance and comments are search-only. Subreddit feeds use hot, new, top, controversial or rising Defaults to `"relevance"`.                 |
| `time`              | `all`, `day`, `hour`, `month`, `week`, `year`                           |          | Defaults to `"all"`.                                                                                                                          |
| `maxItems`          | `integer`                                                               |          | Maximum results per job. A search job always fetches and bills a full page of 25 items, so values below 25 do not cost less Defaults to `25`. |
| `searches`          | `array`                                                                 |          | Search queries. Each query is a separate billed job. Wrap in quotes for an exact phrase                                                       |
| `startUrls`         | `array`                                                                 |          | Reddit subreddit, post or user URLs. Each URL is a separate billed job                                                                        |
| `includeNSFW`       | `boolean`                                                               |          | Defaults to `false`.                                                                                                                          |
| `searchPosts`       | `boolean`                                                               |          | Defaults to `true`.                                                                                                                           |
| `searchUsers`       | `boolean`                                                               |          | Defaults to `false`.                                                                                                                          |
| `skipComments`      | `boolean`                                                               |          | For a direct post URL, return only the post without its comments Defaults to `false`.                                                         |
| `skipCommunity`     | `boolean`                                                               |          | Defaults to `true`.                                                                                                                           |
| `skipUserPosts`     | `boolean`                                                               |          | Defaults to `false`.                                                                                                                          |
| `searchComments`    | `boolean`                                                               |          | Defaults to `false`.                                                                                                                          |
| `ignorestartUrls`   | `boolean`                                                               |          | Forces search-only mode: startUrls are ignored even when present. Note the lowercase s in the middle, which is how the actor spells it.       |
| `fetchPostComments` | `boolean`                                                               |          | Also attach top-level comments to each post. One extra request per post and materially more billed items Defaults to `false`.                 |

<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.api","input":{"maxItems":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "id": "t3_1rxssfj",
  "url": "https://www.reddit.com/r/apify/comments/1rxssfj/example_post_title/",
  "body": "Hey everyone, the full selftext of the post.",
  "html": "&lt;div class=\"md\"&gt;&lt;p&gt;Hey everyone&lt;/p&gt;&lt;/div&gt;",
  "isAd": false,
  "title": "Example post title",
  "over18": false,
  "isVideo": false,
  "upVotes": 11,
  "dataType": "post",
  "parsedId": "1rxssfj",
  "username": "example_user",
  "createdAt": "2026-03-19T06:20:58.000Z",
  "scrapedAt": "2026-07-30T14:34:01.975Z",
  "communityName": "r/apify",
  "numberOfComments": 16,
  "parsedCommunityName": "apify"
}
```