--- title: research reddit description: Research Reddit posts, comments, and communities. canonical_url: https://orchestor.io/docs/en/cli/research/reddit markdown_url: https://orchestor.io/docs/en/cli/research/reddit.md contentType: reference --- # research reddit Research Reddit posts, comments, and communities. Use canonical post URLs returned by search to retrieve details or comments. ## Usage ```bash title="terminal" orc research reddit posts search --query "AI agents" --sort new --workspace YOUR_WORKSPACE_ID --format json ``` *Find recent posts* ## Subcommands ### `posts get` Get Reddit post ```bash title="terminal" orc research reddit posts get [options] ``` #### Unique options ##### `--url` Full HTTPS Reddit post permalink containing /r/{community}/comments/{post_id}. Shortlinks are not accepted.; max 2048 chars Type: `string`. Required. ```bash title="terminal" orc research reddit posts get --url ``` ### `posts comments list` List Reddit post comments ```bash title="terminal" orc research reddit posts comments list [options] ``` #### Unique options ##### `--url` Full HTTPS Reddit post permalink containing /r/{community}/comments/{post_id}. Shortlinks are not accepted.; max 2048 chars Type: `string`. Required. ```bash title="terminal" orc research reddit posts comments list --url ``` ### `comments search` Search Reddit comments ```bash title="terminal" orc research reddit comments search [options] ``` #### Unique options ##### `--query` Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars Type: `string`. Required. ```bash title="terminal" orc research reddit comments search --query ``` ##### `--sort` Source comment search ordering.; enum: relevance|top|new Type: `string`. Optional. ```bash title="terminal" orc research reddit comments search --sort ``` ### `posts search` Search Reddit posts ```bash title="terminal" orc research reddit posts search [options] ``` #### Unique options ##### `--query` Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars Type: `string`. Required. ```bash title="terminal" orc research reddit posts search --query ``` ##### `--sort` Source ranking. timeframe does not apply to new.; enum: relevance|new|top|comment_count Type: `string`. Optional. ```bash title="terminal" orc research reddit posts search --sort ``` ##### `--timeframe` Relative source time window. Ignored with sort=new; on subreddit listing applies only to top ordering.; enum: all|day|week|month|year Type: `string`. Optional. ```bash title="terminal" orc research reddit posts search --timeframe ``` ### `subreddits get` Get Reddit community ```bash title="terminal" orc research reddit subreddits get [options] ``` #### Unique options ##### `--subreddit` Canonical subreddit name without r/, for example AskReddit. Preserve source casing. Type: `string`. Required. ```bash title="terminal" orc research reddit subreddits get --subreddit ``` ### `subreddits posts list` List Reddit community posts ```bash title="terminal" orc research reddit subreddits posts list [options] ``` #### Unique options ##### `--subreddit` Canonical subreddit name without r/, for example AskReddit. Preserve source casing. Type: `string`. Required. ```bash title="terminal" orc research reddit subreddits posts list --subreddit ``` ##### `--sort` Community listing order.; enum: best|hot|new|top|rising Type: `string`. Optional. ```bash title="terminal" orc research reddit subreddits posts list --sort ``` ##### `--timeframe` Relative source time window. Ignored with sort=new; on subreddit listing applies only to top ordering.; enum: all|day|week|month|year Type: `string`. Optional. ```bash title="terminal" orc research reddit subreddits posts list --timeframe ``` ### `subreddits posts search` Search within a Reddit community ```bash title="terminal" orc research reddit subreddits posts search [options] ``` #### Unique options ##### `--subreddit` Canonical subreddit name without r/, for example AskReddit. Preserve source casing. Type: `string`. Required. ```bash title="terminal" orc research reddit subreddits posts search --subreddit ``` ##### `--query` Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars Type: `string`. Required. ```bash title="terminal" orc research reddit subreddits posts search --query ``` ##### `--sort` Source search ordering.; enum: relevance|hot|top|new|comments Type: `string`. Optional. ```bash title="terminal" orc research reddit subreddits posts search --sort ``` ##### `--timeframe` Relative window; ignored for new ordering.; enum: all|year|month|week|day|hour Type: `string`. Optional. ```bash title="terminal" orc research reddit subreddits posts search --timeframe ``` ## Output and continuation Each call returns one page. When continuation is available, pass the top-level `pagination.next_cursor` as `--cursor` with unchanged filters. Never replay `data.next_cursor`. `has_more: null` means unknown, not complete. `--page-all` is unavailable. JSON retains records in `data.data`, continuation in `data.pagination` and provenance in `data.source`. `--raw` removes the CLI envelope; `--field data` selects the API data. Missing and null values do not mean zero. `data.usage.provider_credits` uses the provider’s units, not Orchestor billing units. See each API reference for coverage and provider-specific constraints. ## Permissions Sign in with `orc auth login` using a beta-approved account, or use an API key with the `read` scope. Select an accessible workspace with `--workspace`. No research-specific workspace allowlist is required. ## Global Options The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc research reddit`: - [`--help`](https://orchestor.io/docs/cli/global-flags.md#help) - [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace) - [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format) - [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output) - [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output) - [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager) - [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run) - [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation) - [`--cursor`](https://orchestor.io/docs/cli/global-flags.md) - [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing) For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md). --- [Documentation index](https://orchestor.io/docs/llms.txt)