Skip to main content
See Using commands 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.

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.

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.

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.

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.

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.

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.

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.

reddit campaign-readiness

reddit campaign-readiness check

Can this campaign deliver? Beta: this command may still change.

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.

reddit campaigns list

List campaigns on the connected Reddit ad account with status, objective and budget. Beta: this command may still change.

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.

reddit communities

Find subreddits to target: search by name, get suggestions similar to seed communities, or suggestions for a website. Beta: this command may still change.

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.

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.

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.

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.

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.

reddit delivery

reddit delivery diagnose

Why isn’t it delivering? Beta: this command may still change.

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.

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.

reddit geolocations

Resolve geolocation ids for targeting: countries, regions, cities, DMAs and postal codes. Beta: this command may still change.

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.

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.

reddit pacing

reddit pacing analyze

Is spend on track? Beta: this command may still change.

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.

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.

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.

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.

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.

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.

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.

reddit profiles

reddit profiles list

Reddit profiles shared with the connected ad account. Beta: this command may still change.

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.

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.

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.

reddit saved-audiences

reddit saved-audiences get

One saved audience by id with its full targeting. Beta: this command may still change.

reddit saved-audiences list

Reusable targeting definitions (saved audiences) on the connected account. Beta: this command may still change.

reddit targeting-options

reddit targeting-options list

Static targeting vocabularies: devices, carriers, languages, time zones, industries. Beta: this command may still change.

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.

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.

reddit tracking-health

reddit tracking-health check

Are conversions being tracked? Beta: this command may still change.