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

# Reddit

> The 42 adside commands for Reddit.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside reddit --help` to see what your installed version has.

## reddit account-history

### reddit account-history get

The change log of the connected ad account: who changed what (budgets, bids, statuses, targeting, creation) and when.

Beta: this command may still change.

```bash theme={null}
adside reddit account-history get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--preset` | `today\|yesterday\|last_7d\|last_14d\|last_30d\|this_month\|last_month` | Shortcut for a date range. Default last\_7d when no start\_date/end\_date given. |
| `--start-date` | `<start-date>` | First day, YYYY-MM-DD, in time\_zone\_id. |
| `--end-date` | `<end-date>` | Last day (inclusive), YYYY-MM-DD, in time\_zone\_id. |
| `--time-zone-id` | `<id>` | IANA zone for the date boundaries, e.g. Europe/Paris. Defaults to the ad account's time zone. |
| `--change-types` | `'<json>'` | Only these kinds of change. Default: all. |
| `--entity-id` | `<id>` | Only changes to this campaign / ad group / ad id. |
| `--limit` | `<1-500>=100` | |

## reddit account-overview

### reddit account-overview get

Where the account stands: campaign / ad group / ad counts by status, spend and clicks for the last 7 days versus the 7 before, and the top campaigns by spend.

Beta: this command may still change.

```bash theme={null}
adside reddit account-overview get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |

## reddit ad-accounts

### reddit ad-accounts get

The Reddit ad account this workspace is connected to: currency, time zone, attribution windows, approval state, funding instruments (and whether any can serve), pixels and the profiles ads can be authored from.

Beta: this command may still change.

```bash theme={null}
adside reddit ad-accounts get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |

## reddit ad-groups

### reddit ad-groups get

One Reddit ad group by id: status, budget, bid strategy, optimization goal, pixel, schedule and full targeting.

Beta: this command may still change.

```bash theme={null}
adside reddit ad-groups get --ad-group-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-group-id` (required) | `<id>` | Ad group id (numeric string) from `adside reddit ad-groups list`. |

### reddit ad-groups list

List ad groups on the connected account (optionally one campaign's) with status, budget, bid and a one-line targeting summary.

Beta: this command may still change.

```bash theme={null}
adside reddit ad-groups list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | Only ad groups in this campaign (server-side filter). |
| `--status` | `ACTIVE\|PAUSED\|ARCHIVED\|DELETED` | Filter on configured\_status. ARCHIVED and DELETED objects are hidden unless asked for. |
| `--include-archived` | `true\|false=false` | |
| `--limit` | `<1-500>=100` | Maximum rows to return (bounds the answer, not the scan). |

## reddit ads

### reddit ads get

One Reddit ad by id with its creative (the post behind it): headline, media, destination, click URL and tracking parameters, review/rejection state, preview link.

Beta: this command may still change.

```bash theme={null}
adside reddit ads get --ad-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-id` (required) | `<id>` | Ad id (numeric string) from `adside reddit ads list`. |

### reddit ads list

List ads on the connected account, optionally within one campaign or ad group, with status, creative type and headline.

Beta: this command may still change.

```bash theme={null}
adside reddit ads list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | Only ads in this campaign (server-side filter). |
| `--ad-group-id` | `<id>` | Only ads in this ad group (server-side filter). |
| `--status` | `ACTIVE\|PAUSED\|ARCHIVED\|DELETED` | Filter on configured\_status. ARCHIVED and DELETED objects are hidden unless asked for. |
| `--effective-status` | `ACTIVE\|PAUSED\|PENDING_APPROVAL\|REJECTED\|AD_GROUP_PAUSED\|CAMPAIGN_PAUSED\|COMPLETED\|ARCHIVED\|DELETED` | Filter on Reddit's effective status (server-side). |
| `--include-archived` | `true\|false=false` | |
| `--with-creative` | `true\|false=true` | Resolve each ad's post to show creative type and headline (one extra request per distinct post, max 25). |
| `--limit` | `<1-500>=100` | Maximum rows to return (bounds the answer, not the scan). |

## reddit bids

### reddit bids suggest

Reddit's suggested bid range (min / median / max) for a bid type, objective and targeting, in the account currency.

Beta: this command may still change.

```bash theme={null}
adside reddit bids suggest [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--bid-type` | `CPC\|CPM\|CPV\|CPV6\|CPV15=CPC` | |
| `--objective` | `APP_INSTALLS\|CATALOG_SALES\|CLICKS\|CONVERSIONS\|IMPRESSIONS\|LEAD_GENERATION\|VIDEO_VIEWABLE_IMPRESSIONS=CLICKS` | |
| `--bid-strategy` | `MANUAL_BIDDING\|MAXIMIZE_VOLUME\|TARGET_CPX=MANUAL_BIDDING` | Reddit refuses a suggestion without a delivery config (400 "Missing delivery config: bid\_strategy", measured 2026-09-10). MANUAL\_BIDDING is what a suggested bid is for. |
| `--optimization-goal` | `<optimization-goal>` | e.g. CLICKS, PURCHASE, LEAD. Defaults from the objective (CLICKS → CLICKS, CONVERSIONS → PURCHASE, VIDEO\_VIEWABLE\_IMPRESSIONS → VIDEO\_VIEW\_6S, LEAD\_GENERATION → LEAD, APP\_INSTALLS → MOBILE\_CONVERSION\_INSTALL). |
| `--targeting` | `'<json>'` | Reddit targeting object. Every key optional; omitted = no restriction. |
| `--daily-budget` | `<number>` | Account currency. |

## reddit campaign-readiness

### reddit campaign-readiness check

Can this campaign deliver?

Beta: this command may still change.

```bash theme={null}
adside reddit campaign-readiness check [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` | `<id>` | Campaign id. Give this or campaign\_name. |
| `--campaign-name` | `<campaign-name>` | Exact or partial campaign name, when the id is unknown. |

## reddit campaigns

### reddit campaigns get

One Reddit campaign by id: status, delivery status, objective, budget, funding instrument, pixel, dates.

Beta: this command may still change.

```bash theme={null}
adside reddit campaigns get --campaign-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | Campaign id (numeric string) from `adside reddit campaigns list`. |

### reddit campaigns list

List campaigns on the connected Reddit ad account with status, objective and budget.

Beta: this command may still change.

```bash theme={null}
adside reddit campaigns list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--status` | `ACTIVE\|PAUSED\|ARCHIVED\|DELETED` | Filter on configured\_status. ARCHIVED and DELETED objects are hidden unless asked for. |
| `--name-contains` | `<name-contains>` | Case-insensitive substring of the campaign name. |
| `--include-archived` | `true\|false=false` | Include ARCHIVED and DELETED campaigns (hidden by default). |
| `--limit` | `<1-500>=100` | Maximum rows to return (bounds the answer, not the scan). |

## reddit channel-status

### reddit channel-status get

Self-diagnosis of the Reddit connection: who the token belongs to, the connected ad account and business, rate-limit state observed in this request, and the API spec version this server was built against.

Beta: this command may still change.

```bash theme={null}
adside reddit channel-status get
```

## reddit communities

### reddit communities search

Find subreddits to target: search by name, get suggestions similar to seed communities, or suggestions for a website.

Beta: this command may still change.

```bash theme={null}
adside reddit communities search [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--query` | `<query>` | Search term for community names (e.g. 'marketing'). |
| `--seed-communities` | `'<json>'` | Get suggestions similar to these subreddit names (without r/). |
| `--website-url` | `<url>` | Get suggestions relevant to this website. |
| `--limit` | `<1-100>=25` | |

## reddit creative-assets

### reddit creative-assets list

The asset library (images, videos, headlines, CTAs) of the account's profiles — the inputs Reddit Max campaigns assemble ads from.

Beta: this command may still change.

```bash theme={null}
adside reddit creative-assets list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--profile-id` | `<id>` | Profile whose asset library to list. Omit for every profile on the account. |
| `--limit` | `<1-200>=50` | |

## reddit creatives

### reddit creatives analyze

Creative performance: every ad's spend, impressions, clicks, CTR and conversions joined with its creative type and headline, plus a by-format summary and winners / losers.

Beta: this command may still change.

```bash theme={null}
adside reddit creatives analyze [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | |
| `--preset` | `today\|yesterday\|last_7d\|last_14d\|last_30d\|this_month\|last_month` | Shortcut for a date range. Default last\_7d when no start\_date/end\_date given. |
| `--start-date` | `<start-date>` | First day, YYYY-MM-DD, in time\_zone\_id. |
| `--end-date` | `<end-date>` | Last day (inclusive), YYYY-MM-DD, in time\_zone\_id. |
| `--time-zone-id` | `<id>` | IANA zone for the date boundaries, e.g. Europe/Paris. Defaults to the ad account's time zone. |
| `--min-impressions` | `<min 0>=100` | |

## reddit custom-audiences

### reddit custom-audiences get

One custom audience by id, with the ad groups on this account that target or exclude it.

Beta: this command may still change.

```bash theme={null}
adside reddit custom-audiences get --audience-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--audience-id` (required) | `<id>` | Custom audience id from `adside reddit custom-audiences list`. |

### reddit custom-audiences list

Custom audiences on the connected account (customer lists, pixel and engagement retargeting) with type, status and size range.

Beta: this command may still change.

```bash theme={null}
adside reddit custom-audiences list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--name-contains` | `<name-contains>` | |

## reddit daily-performance

### reddit daily-performance get

Core metrics by day for the account, a campaign, an ad group or an ad, with day-over-day change in spend.

Beta: this command may still change.

```bash theme={null}
adside reddit daily-performance get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--level` | `account\|campaign\|ad_group\|ad=campaign` | One row per object at this level (plus any breakdowns). |
| `--object-id` | `<id>` | |
| `--metrics` | `'<json>'` | Friendly metric names, e.g. impressions, clicks, spend, ctr, cpc, ecpm, reach, video\_watched\_100\_percent, conversion\_purchase\_clicks. Default: the core group. See `adside reddit report-fields list`. |
| `--preset` | `today\|yesterday\|last_7d\|last_14d\|last_30d\|this_month\|last_month` | Shortcut for a date range. Default last\_7d when no start\_date/end\_date given. |
| `--start-date` | `<start-date>` | First day, YYYY-MM-DD, in time\_zone\_id. |
| `--end-date` | `<end-date>` | Last day (inclusive), YYYY-MM-DD, in time\_zone\_id. |
| `--time-zone-id` | `<id>` | IANA zone for the date boundaries, e.g. Europe/Paris. Defaults to the ad account's time zone. |

## reddit delivery

### reddit delivery diagnose

Why isn't it delivering?

Beta: this command may still change.

```bash theme={null}
adside reddit delivery diagnose [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | Only this campaign. Default: every non-archived campaign. |
| `--lookback-days` | `<1-30>=3` | |

## reddit entity

### reddit entity find

Find campaigns, ad groups or ads by name on the connected account (case-insensitive substring).

Beta: this command may still change.

```bash theme={null}
adside reddit entity find --query <query> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--query` (required) | `<query>` | Case-insensitive substring of the name. |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--entity-type` | `campaign\|ad_group\|ad\|any=any` | |
| `--limit` | `<1-50>=20` | |

## reddit funding-instruments

### reddit funding-instruments list

Funding instruments (payment methods / credit lines) on the connected ad account, with whether each can serve and why not.

Beta: this command may still change.

```bash theme={null}
adside reddit funding-instruments list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |

## reddit geolocations

### reddit geolocations search

Resolve geolocation ids for targeting: countries, regions, cities, DMAs and postal codes.

Beta: this command may still change.

```bash theme={null}
adside reddit geolocations search [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--country` | `<country>` | ISO country code to list regions / cities of (e.g. US). |
| `--city-search` | `<city-search>` | City name to search (needs country). |
| `--postal-code` | `<postal-code>` | Postal code to resolve (needs country). |
| `--validate-ids` | `'<json>'` | Check that these geolocation ids are valid for targeting. |

## reddit interests

### reddit interests list

Every interest category Reddit offers for targeting, grouped, with the ids to put in targeting.interests.

Beta: this command may still change.

```bash theme={null}
adside reddit interests list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--filter` | `<filter>` | Substring filter on name or category. |

## reddit keywords

### reddit keywords suggest

Keyword suggestions (with monthly views on Reddit) from seed terms, or validation of the seeds themselves.

Beta: this command may still change.

```bash theme={null}
adside reddit keywords suggest --seed-keywords '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--seed-keywords` (required) | `'<json>'` | Terms to expand. |
| `--validate-only` | `true\|false=false` | Only validate the seeds instead of suggesting more. |

## reddit pacing

### reddit pacing analyze

Is spend on track?

Beta: this command may still change.

```bash theme={null}
adside reddit pacing analyze [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | Only this campaign's ad groups. |
| `--preset` | `today\|yesterday\|last_7d\|last_14d\|last_30d\|this_month\|last_month` | Shortcut for a date range. Default last\_7d when no start\_date/end\_date given. |
| `--start-date` | `<start-date>` | First day, YYYY-MM-DD, in time\_zone\_id. |
| `--end-date` | `<end-date>` | Last day (inclusive), YYYY-MM-DD, in time\_zone\_id. |
| `--time-zone-id` | `<id>` | IANA zone for the date boundaries, e.g. Europe/Paris. Defaults to the ad account's time zone. |

## reddit performance

### reddit performance compare

Side-by-side comparison: either this window versus the previous period at a level, or several objects (campaigns, ad groups or ads) in one window.

Beta: this command may still change.

```bash theme={null}
adside reddit performance compare [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--level` | `account\|campaign\|ad_group\|ad=campaign` | One row per object at this level (plus any breakdowns). |
| `--object-ids` | `'<json>'` | Compare these objects side by side in one window. |
| `--metrics` | `'<json>'` | Friendly metric names, e.g. impressions, clicks, spend, ctr, cpc, ecpm, reach, video\_watched\_100\_percent, conversion\_purchase\_clicks. Default: the core group. See `adside reddit report-fields list`. |
| `--preset` | `today\|yesterday\|last_7d\|last_14d\|last_30d\|this_month\|last_month` | Shortcut for a date range. Default last\_7d when no start\_date/end\_date given. |
| `--start-date` | `<start-date>` | First day, YYYY-MM-DD, in time\_zone\_id. |
| `--end-date` | `<end-date>` | Last day (inclusive), YYYY-MM-DD, in time\_zone\_id. |
| `--time-zone-id` | `<id>` | IANA zone for the date boundaries, e.g. Europe/Paris. Defaults to the ad account's time zone. |
| `--compare-to` | `previous_period\|none=previous_period` | previous\_period = the same number of days immediately before the window. |

### reddit performance rank

Rank a dimension (campaigns, ad groups, ads, communities, keywords, interests, placements, countries, …) by one metric over a window, with a minimum-spend floor.

Beta: this command may still change.

```bash theme={null}
adside reddit performance rank [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--dimension` | `<dimension>=ad` | What to rank: campaign, ad\_group, ad, community, keyword, interest, placement, country, region, os\_type, gender, language. |
| `--metric` | `<metric>=spend` | Metric to rank by. Cost metrics (cpc, ecpm, \*\_ecpa) rank ascending. |
| `--min-spend` | `<min 0>=0` | Ignore rows under this spend (account currency). |
| `--top-n` | `<1-100>=10` | |
| `--preset` | `today\|yesterday\|last_7d\|last_14d\|last_30d\|this_month\|last_month` | Shortcut for a date range. Default last\_7d when no start\_date/end\_date given. |
| `--start-date` | `<start-date>` | First day, YYYY-MM-DD, in time\_zone\_id. |
| `--end-date` | `<end-date>` | Last day (inclusive), YYYY-MM-DD, in time\_zone\_id. |
| `--time-zone-id` | `<id>` | IANA zone for the date boundaries, e.g. Europe/Paris. Defaults to the ad account's time zone. |

## reddit pixel-events

### reddit pixel-events list

When each standard and custom event last fired on the connected account's pixel(s), with age.

Beta: this command may still change.

```bash theme={null}
adside reddit pixel-events list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--pixel-id` | `<id>` | One pixel of the connected account; omit for all of them. |

## reddit pixels

### reddit pixels list

Reddit pixels on the connected ad account with when each standard and custom event last fired.

Beta: this command may still change.

```bash theme={null}
adside reddit pixels list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |

## reddit post-job

### reddit post-job get

Status of a structured-post creation job (QUEUED → PROCESSING → SUCCESS | CLIENT\_ERROR | SERVER\_ERROR) and the post id once it exists.

Beta: this command may still change.

```bash theme={null}
adside reddit post-job get --job-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--job-id` (required) | `<id>` | Structured-post creation job id returned by create\_reddit\_post. |

## reddit posts

### reddit posts get

One post (ad creative) by id: headline, type, media URLs, destination and call-to-action, comment setting, public URL.

Beta: this command may still change.

```bash theme={null}
adside reddit posts get --post-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--post-id` (required) | `<id>` | Post id (t3\_…) from an ad or from `adside reddit posts list`. |

### reddit posts list

Posts (ad creatives) on the connected account's profiles — headline, type, destination, media — or the posts behind specific ads.

Beta: this command may still change.

```bash theme={null}
adside reddit posts list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--profile-id` | `<id>` | Profile whose posts to list. Omit to use every profile shared with the ad account. |
| `--ad-ids` | `'<json>'` | Alternatively, the posts behind these ads. |
| `--limit` | `<1-200>=50` | |

## reddit profiles

### reddit profiles list

Reddit profiles shared with the connected ad account.

Beta: this command may still change.

```bash theme={null}
adside reddit profiles list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |

## reddit reach

### reddit reach estimate

How many people a targeting can reach: Reddit's channel-planning reach curve for a geolocation (7 or 28 days) and, when a targeting object is given, the audience size and delivery estimates (impressions, clicks, reach) for a hypothetical ad group.

Beta: this command may still change.

```bash theme={null}
adside reddit reach estimate --geolocation <geolocation> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--geolocation` (required) | `<geolocation>` | Country or region id, e.g. US. |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--duration-days` | `<number>=7` | |
| `--gender` | `MALE\|FEMALE` | |
| `--min-age` | `<13-65>` | |
| `--max-age` | `<13-65>` | |
| `--targeting` | `'<json>'` | When given, also returns audience size and delivery estimates for this targeting. |
| `--objective` | `APP_INSTALLS\|CATALOG_SALES\|CLICKS\|CONVERSIONS\|IMPRESSIONS\|LEAD_GENERATION\|VIDEO_VIEWABLE_IMPRESSIONS=CLICKS` | |
| `--daily-budget` | `<number>` | For the delivery estimate, in the account currency. Default 50. |
| `--bid-type` | `CPC\|CPM\|CPV\|CPV6\|CPV15=CPC` | |
| `--bid` | `<number>` | Bid in the account currency. Default 0.50. |

## reddit report

### reddit report get

Performance report for the connected Reddit ad account: any level (account, campaign, ad group, ad), friendly metric names or metric groups, optional breakdowns (date, country, community, keyword, placement, …), a date preset or range in the account's time zone.

Beta: this command may still change.

```bash theme={null}
adside reddit report get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |
| `--level` | `account\|campaign\|ad_group\|ad=campaign` | One row per object at this level (plus any breakdowns). |
| `--object-id` | `<id>` | Restrict to one campaign / ad group / ad id (matched to `level`). |
| `--metrics` | `'<json>'` | Friendly metric names, e.g. impressions, clicks, spend, ctr, cpc, ecpm, reach, video\_watched\_100\_percent, conversion\_purchase\_clicks. Default: the core group. See `adside reddit report-fields list`. |
| `--metric-groups` | `'<json>'` | Bundles: core, video, conversions, value, app. |
| `--breakdowns` | `'<json>'` | Extra dimensions: date, hour, country, region, dma, community, interest, keyword, placement, os\_type, gender, language, asset\_id, carousel\_card. Max 3 in total (the level counts as one). Reddit has no age breakdown. |
| `--preset` | `today\|yesterday\|last_7d\|last_14d\|last_30d\|this_month\|last_month` | Shortcut for a date range. Default last\_7d when no start\_date/end\_date given. |
| `--start-date` | `<start-date>` | First day, YYYY-MM-DD, in time\_zone\_id. |
| `--end-date` | `<end-date>` | Last day (inclusive), YYYY-MM-DD, in time\_zone\_id. |
| `--time-zone-id` | `<id>` | IANA zone for the date boundaries, e.g. Europe/Paris. Defaults to the ad account's time zone. |
| `--filter` | `<filter>` | Reddit filter syntax, e.g. `campaign:effective_status==ACTIVE,ad:name=@promo` (== exact, =@ contains, comma = OR). |
| `--conversion-events` | `'<json>'` | Named custom pixel events to include (clicks, views, value). |
| `--sort-by` | `<sort-by>` | Metric to sort rows by (descending). Default spend. |
| `--format` | `markdown\|json=markdown` | json only when fields must be reused programmatically. |
| `--limit` | `<1-1000>=200` | |

## reddit report-fields

### reddit report-fields list

The report vocabulary `adside reddit report get` accepts: metric groups, every metric with its unit (money, count, rate) and every breakdown.

Beta: this command may still change.

```bash theme={null}
adside reddit report-fields list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--filter` | `<filter>` | Substring filter, e.g. 'conversion', 'video', 'app\_install'. |
| `--group` | `core\|video\|conversions\|value\|app` | Only the members of one metric group. |

## reddit saved-audiences

### reddit saved-audiences get

One saved audience by id with its full targeting.

Beta: this command may still change.

```bash theme={null}
adside reddit saved-audiences get --saved-audience-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--saved-audience-id` (required) | `<id>` | Saved audience id from `adside reddit saved-audiences list`. |

### reddit saved-audiences list

Reusable targeting definitions (saved audiences) on the connected account.

Beta: this command may still change.

```bash theme={null}
adside reddit saved-audiences list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |

## reddit targeting-options

### reddit targeting-options list

Static targeting vocabularies: devices, carriers, languages, time zones, industries.

Beta: this command may still change.

```bash theme={null}
adside reddit targeting-options list --kind devices|carriers|languages|time_zones|industries
```

## reddit third-party-audiences

### reddit third-party-audiences list

Third-party (data partner) audiences available for targeting on Reddit, with provider and size where given.

Beta: this command may still change.

```bash theme={null}
adside reddit third-party-audiences list [flags]
```

| Flag | Value |
| - | - |
| `--limit` | `<1-200>=50` |

## reddit third-party-trackers

### reddit third-party-trackers list

The click and impression tracker domains Reddit accepts on an ad's event\_trackers (DoubleVerify, IAS, MOAT, …).

Beta: this command may still change.

```bash theme={null}
adside reddit third-party-trackers list
```

## reddit tracking-health

### reddit tracking-health check

Are conversions being tracked?

Beta: this command may still change.

```bash theme={null}
adside reddit tracking-health check [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--ad-account-id` | `<id>` | Reddit ad account id (a2\_…). Omit it: it defaults to the ad account this workspace is connected to, and any other account is refused. |


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