reddit get insights
reddit_get_insightsRetrieve Reddit Ads performance insights with native metrics, entity and audience breakdowns, pagination, and explicit UTC date ranges for campaign analysis.
Instructions
Native Reddit reporting with metrics and entity/audience breakdowns, explicit UTC dates and pagination. Empty results validate transport only. Reported audience demographics differ from configured targeting.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"adAccountId": "<adAccountId>",
"startsAt": "<startsAt>",
"endsAt": "<endsAt>",
"fields": "<fields>"
},
"name": "reddit_get_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Items per page, 1 to 100. Defaults to 50. | |
| cursor | No | Opaque next_cursor returned by the previous page. Omit it for the first page. | |
| endsAt | Yes | Report end in UTC on the hour, after startsAt. Hourly breakdowns cover at most seven days. | |
| fields | Yes | Native Reddit field names, e.g. IMPRESSIONS, CLICKS, SPEND, CONVERSION_SIGN_UP_CLICKS, CONVERSION_SIGN_UP_VIEWS. Use reddit_get_reporting_schema for supported fields; never guess names. Lowercase spellings are accepted. | |
| filter | No | Optional native Reddit report filter expression, passed unchanged. | |
| startsAt | Yes | Report start in UTC on the hour, such as 2026-10-01T00:00:00Z. | |
| breakdowns | No | Native breakdowns, e.g. CAMPAIGN_ID, AD_GROUP_ID or AD_ID. At most three. Lowercase spellings are accepted. API compatibility constraints still apply. | |
| adAccountId | Yes | Reddit ad account ID (a2_...) listed in REDDIT_ADS_ACCOUNT_IDS, not the business ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |