# snapchat_get_insights

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

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Snapchat Ads](https://www.getmcpads.com/docs/sources/snapchat-ads)

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](https://www.getmcpads.com/docs/sources/snapchat-ads) |
| Kind | Read |
| Discovery | Announced in the tool list |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/snapchat-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `adAccountId` | string | Required | Selected Snapchat ad account UUID; never an organization ID. |
| `level` | string | Optional | One of: `adaccounts`, `campaigns`, `adsquads`, `ads`. Default: `"adaccounts"`. |
| `entityId` | string | Optional | Native Snapchat entity UUID. |
| `startTime` | string | Required |  |
| `endTime` | string | Required |  |
| `granularity` | string | Optional | One of: `TOTAL`, `DAY`, `HOUR`. Default: `"TOTAL"`. |
| `fields` | array | Optional | Default: `["spend"]`. |
| `breakdown` | string | Optional | One of: `campaign`, `adsquad`, `ad`. |
| `reportDimension` | string | Optional | One of: `age`, `gender`, `country`, `region`, `dma`, `device_os`, `interest`. |

## Calling it

Directly, since it is announced

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

- [Snapchat Ads metrics](https://www.getmcpads.com/docs/sources/snapchat-ads/metrics): What you can ask for.
- [Snapchat Ads dimensions](https://www.getmcpads.com/docs/sources/snapchat-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/snapchat-ads/tools/snapchat_get_insights
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.