`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. Rows are ordered by the breakdown values by default. For "which drove the most" or "top N" questions pass \

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.
`--limit`	`integer`	Optional	Maximum report rows to return per page (1-1000, default 100). `count` in the response is the total across all pages — rows are NOT all returned in one call. Row order is set by `order_by` (default: by breakdown values; `spend` puts the top spenders first). When more rows remain, the response includes a top-level `nextCursor`; pass it back as `cursor` to continue.
`--order-by`	`string`	Optional	Row order. 'breakdown' (default): sorted by the breakdown values, a stable order for walking every page. 'spend': highest spend first, so page 1 holds the top spenders — use it for "which communities/campaigns drove the most" questions instead of reading every page. A cursor only continues the order it was issued under.
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response's `nextCursor` — pass it back verbatim to continue past that page. Do not construct it yourself.
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "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, maxLength: 64
`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 (9)

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.
`limit`	`integer`	Optional	Maximum report rows to return per page (1-1000, default 100). `count` in the response is the total across all pages — rows are NOT all returned in one call. Row order is set by `order_by` (default: by breakdown values; `spend` puts the top spenders first). When more rows remain, the response includes a top-level `nextCursor`; pass it back as `cursor` to continue.min: 1, max: 1000
`order_by`	`string`	Optional	Row order. 'breakdown' (default): sorted by the breakdown values, a stable order for walking every page. 'spend': highest spend first, so page 1 holds the top spenders — use it for "which communities/campaigns drove the most" questions instead of reading every page. A cursor only continues the order it was issued under. `breakdown` `spend`
`cursor`	`string`	Optional	Opaque pagination cursor from a previous response's `nextCursor` — pass it back verbatim to continue past that page. Do not construct it yourself.
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

Description

Usage

Parameters

Related Tools