Skip to content

reddit_get_insights

Native Reddit reporting with metrics and entity/audience breakdowns, explicit UTC dates and pagination.

View as Markdown

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.

Kind
Read
Discovery
Announced in the tool list
Account parameter
adAccountId
Endpoint
https://mcp.getmcpads.com/reddit-ads/mcp

Parameters

Parameters
NameTypeRequiredNotes
adAccountIdstringRequiredSelected Reddit ad account ID (a2_...), not the business ID.
startsAtstringRequired
endsAtstringRequired
fieldsarrayRequiredNative 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.
breakdownsarrayOptionalNative breakdowns, e.g. CAMPAIGN_ID, AD_GROUP_ID or AD_ID. Lowercase spellings are accepted. API compatibility constraints still apply. Default: [].
filterstringOptional
limitintegerOptionalMaximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: 50.
cursorstringOptionalOpaque pagination cursor returned by the preceding response; omit for the first page.

Calling it

json · Directly, since it is announced
{
  "name": "reddit_get_insights",
  "arguments": {
    "adAccountId": "<string>",
    "startsAt": "<string>",
    "endsAt": "<string>",
    "fields": "<array>"
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.

Esc

Type to search