`reddit_ads_get_performance_report`

Get Reddit Ads Performance Report

Description

Get a performance report for a Reddit ad account over a date range, with optional breakdowns, entity filters, and opt-in conversion metrics such as sign-ups, leads, purchases, CPA, value, and ROAS.

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

Flag	Type	Required	Description
`--account`	`string`	Required	Reddit ad account ID.
`--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.
`--date-start`	`string`	Required	Start date in YYYY-MM-DD format.
`--date-end`	`string`	Required	End date in YYYY-MM-DD format.
`--breakdown`	`array`	Optional	Up to 3 breakdown dimensions. "community" shows subreddit-level data.
`--metrics`	`array`	Optional	Optional report metrics. Defaults to impressions, clicks, spend, ecpm, ctr, cpc. Conversion examples: signup_total, lead_total, purchase_total, conversion_purchase_roas.

{
  "mcpServers": {
    "reddit-ads": {
      "url": "https://reddit.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`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 (5)

Name	Type	Required	Description
`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.
`metrics`	`array`	Optional	Optional report metrics. Defaults to impressions, clicks, spend, ecpm, ctr, cpc. Conversion examples: signup_total, lead_total, purchase_total, conversion_purchase_roas.

Description

Usage

Parameters

Related Tools