snapchat_get_insights

Read native Snapchat stats with explicit time interval (end exclusive), granularity and optional entity breakdown.

Read native Snapchat stats with explicit time interval (end exclusive), granularity and optional entity breakdown. Spend and monetary conversion values are micro currency. Empty test-account results are not live performance evidence.

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

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Required	Selected Snapchat ad account UUID; never an organization ID.
`level`	string	Optional	Entity or aggregation level for the requested report. One of: `adaccounts`, `campaigns`, `adsquads`, `ads`. Default: `"adaccounts"`.
`entityId`	string	Optional	Native Snapchat entity UUID.
`startTime`	string	Required	Beginning of the reporting period as an ISO 8601 timestamp with an explicit timezone.
`endTime`	string	Required	End of the reporting period as an ISO 8601 timestamp with an explicit timezone, after startTime.
`granularity`	string	Optional	Time bucket used to aggregate reporting rows. One of: `TOTAL`, `DAY`, `HOUR`. Default: `"TOTAL"`.
`fields`	array	Optional	Native provider fields to return. Select only fields supported by the chosen object or report. Default: `["spend"]`.
`breakdown`	string	Optional	Native reporting breakdown used to group results. One of: `campaign`, `adsquad`, `ad`.
`reportDimension`	string	Optional	Native dimension used to break down the Snapchat report. One of: `age`, `gender`, `country`, `region`, `dma`, `device_os`, `interest`.

Calling itLink to this section

jsonDirectly, since it is announced

{
  "name": "snapchat_get_insights",
  "arguments": {
    "adAccountId": "<string>",
    "startTime": "<string>",
    "endTime": "<string>"
  }
}