Reddit Ads

Platform Overview

The Reddit Ads MCP server enables AI assistants to manage and analyze Reddit advertising campaigns through the Reddit Ads API v3. It provides read-only access to campaigns, ad groups, ads, and custom audiences with deep subreddit-level targeting insights. By combining community-driven targeting with performance analytics, users can optimize ad spend and reach niche communities at scale.

Your prompt → Claude + Hopkin → Reddit Ads API
                                    ↓
                              Campaigns & Ad Groups
                              Subreddit Targeting
                              Community Performance
                              Budget & Bid Management

Common Workflows

Performance Reporting

"Show me performance by subreddit for my tech campaign over the last month"

Calls reddit_ads_get_performance_report with breakdown: ['community'] to slice metrics by subreddit. Returns impressions, clicks, spend, and engagement segmented by subreddit, making it easy to identify which communities drive the best ROI.

"What was my account's total spend and conversion rate from March 1-31?"

Calls reddit_ads_get_account_summary with the date range. Returns aggregate metrics including spend, impressions, clicks, and key performance indicators across all campaigns and ad groups in the account.

"Break down the performance of campaign X by both date and device type"

Calls reddit_ads_get_performance_report with breakdown: ['date', 'device_os'] to see how performance varies by day and device. Reddit's API supports up to 3 breakdown dimensions for fine-grained analysis.

Campaign & Ad Group Management

"List all my active Reddit campaigns and show their daily budgets"

Calls reddit_ads_list_campaigns with status: ['ACTIVE'] and returns name, status, objective, daily budget (in micro units), and lifetime budget. Results are cached and include pagination cursors for large account portfolios.

"Show me the ad groups in my product launch campaign with their subreddit targeting"

Calls reddit_ads_list_ad_groups with campaign_id parameter. Returns ad group details including bid strategy, bid amounts, and targeting configuration which prominently displays subreddit targeting lists.

"Find all paused ads in the tech ad group and get their headlines"

Calls reddit_ads_list_ads with ad_group_id and status: ['PAUSED']. Returns creative type, headline, and click/post URLs. Useful for auditing inactive creative or understanding why ads were paused.

Community Targeting

"Which subreddits are getting the most impressions across my account?"

Calls reddit_ads_get_performance_report with breakdown: ['community'] to see a ranked list of subreddits by impression volume. Identify high-performing communities and expand budget to top performers.

"Show me the custom audiences I've built for targeting"

Calls reddit_ads_list_custom_audiences to list all available audience segments. Returns audience type, size, and creation date. Useful for reviewing which interest-based or lookalike audiences exist for reuse across campaigns.

Recipes

"Analyze my spending by campaign and subreddit, then tell me which combination has the lowest cost per click"

Calls reddit_ads_get_performance_report with breakdown: ['campaign', 'community']. Returns performance metrics segmented by both campaign and subreddit, allowing comparison of cost-per-click metrics across different community segments within each campaign.

"Get a summary of my Q1 performance, then list all active campaigns and show which had the highest spend"

First calls reddit_ads_get_account_summary for date range 2024-01-01 to 2024-03-31. Then calls reddit_ads_list_campaigns with status: ['ACTIVE']. Compare the budget figures from both calls to identify which active campaign dominated spend during the quarter.

"Show me all ad groups with their targeting, then pull a detailed performance report filtered to just those ad group IDs"

First calls reddit_ads_list_ad_groups to fetch all ad groups and inspect their targeting configuration. Then calls reddit_ads_get_performance_report with those ad_group_ids and breakdown: ['community', 'ad_group'] to see detailed metrics per subreddit per ad group.

"List all my ads, filter to only inactive ones, then check their parent ad group details including targeting"

Calls reddit_ads_list_ads with status: ['PAUSED', 'ARCHIVED'] to get inactive ads. Extract ad_group_id from results, then call reddit_ads_list_ad_groups with those IDs to see the targeting configuration and bid strategy that shaped those ads.

"Generate a weekly performance report breaking down by both date and device, then compare mobile vs desktop spend efficiency"

Calls reddit_ads_get_performance_report with breakdown: ['date', 'device_os'] and a 7-day date range. Returns spend, impressions, and clicks segmented by calendar date and device type (iOS, Android, Windows, etc.), allowing manual comparison of mobile vs desktop ROI.

"Check if my account has any custom audiences, then list ad groups to see which ones use interest-based targeting"

First calls reddit_ads_list_custom_audiences to see available audience segments. Then calls reddit_ads_list_ad_groups and inspect the targeting field to identify which ad groups have interest or audience_id targeting applied versus pure subreddit targeting.

"Export budget and performance data: list all campaigns with their daily budgets, get account-level spend, then performance by campaign"

Calls reddit_ads_list_campaigns to capture all campaign budgets. Calls reddit_ads_get_account_summary for total account spend. Calls reddit_ads_get_performance_report with breakdown: ['campaign'] to get per-campaign metrics. Combine results into a unified export showing budget allocation vs actual spend per campaign.

Tips

1. Subreddit targeting is the Reddit differentiator — Use breakdown: ['community'] in performance reports to see subreddit-level metrics. Reddit's API is one of the few platforms that exposes performance by specific community, making it ideal for niche audience analysis.

2. Budget values are in micro units — Divide daily_budget_micro and lifetime_budget_micro by 1,000,000 to get the actual currency amount. For example, 5000000 micro equals $5.00 USD.

3. Cache is always fresh — List tools (list_campaigns, list_ad_groups, list_ads, list_custom_audiences) cache results and refresh in the background. Pass refresh: true to force a synchronous fetch if you need the absolute latest data immediately.

4. Targeting is nested in ad groups — The targeting object within ad group details contains subreddit IDs, interest keywords, audience IDs, and placement preferences. This is where you'll find the deepest insight into campaign strategy since ad groups are where Reddit-specific constraints (like subreddit lists) are configured.