reddit_ads_get_performance_report

Get Reddit Ads Performance Report

Reddit

Description

Get a performance report for a Reddit ad account over a date range, with optional breakdowns and entity filters.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reddit_ads_get_performance_report",
    "arguments": {}
  }
}
hopkin reddit performance-report get
FlagTypeRequiredDescription
--accountstringRequiredReddit ad account ID.
--campaign-idsarrayOptionalFilter to specific campaign IDs.
--ad-group-idsarrayOptionalFilter to specific ad group IDs.
--ad-idsarrayOptionalFilter to specific ad IDs.
--date-startstringRequiredStart date in YYYY-MM-DD format.
--date-endstringRequiredEnd date in YYYY-MM-DD format.
--breakdownarrayOptionalUp to 3 breakdown dimensions. "community" shows subreddit-level data.
{
  "mcpServers": {
    "reddit-ads": {
      "url": "https://mcp.hopkin.ai/reddit-ads/mcp",
      "transport": "sse"
    }
  }
}

No example prompts available.

Parameters

NameTypeRequiredDescription
account_id string Required Reddit ad account ID.minLength: 1
date_start string Required Start date in YYYY-MM-DD format.
date_end string Required End date in YYYY-MM-DD format.
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (4)
NameTypeRequiredDescription
campaign_ids array Optional Filter to specific campaign IDs.
ad_group_ids array Optional Filter to specific ad group IDs.
ad_ids array Optional Filter to specific ad IDs.
breakdown array Optional Up to 3 breakdown dimensions. "community" shows subreddit-level data.