Get daily insights
Fetch daily-breakdown insights (time_increment=1) for the current campaign launch at campaign/adset/ad level.
Tool name: get-insights-daily.
Fetch daily-breakdown insights (time_increment=1) for the current campaign launch at campaign/adset/ad level. Returns ONE ROW PER DAY, not one row per entity: level chooses which entities are read, then every entity for a date is added together, and entities on each day says how many were. There are no per-entity ids in the response, so do NOT report a day as belonging to a single ad. reach is null whenever entities > 1, because reach counts unique people and cannot be summed across entities. Each day carries spend, impressions, clicks, reach, entities, frequency, hook_rate, hold_rate, results, resultActionType, cpa (cost per result), ctr, cpm.
When to use
Daily time-series insights (spend, impressions, CTR, frequency, hook_rate, hold_rate per day), aggregated across the entities at level, one row per day, never per ad. Use for DOW-adjusted baselines and trend analysis. When the user names specific dates, pass startDate/endDate (ISO) so the year is never inferred. For a single fatigue score use computeCreativeFatigue instead.
Access
| Property | Value |
|---|---|
| Required scope | read |
| Publishes | No |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
| Open world | Yes |
Input
| Field | Type | Required | Description |
|---|---|---|---|
campaignLaunchId | string | Yes | Campaign launch ID (a.k.a. batch ID). Read it from the Current Context block when one is in scope, or resolve it from a mention via listAccountCampaigns / the campaign tree when the user @-mentioned a different launch. |
level | string | No | One of campaign, adset, ad. Default "campaign". |
days | number | No | Default 30. Minimum 1, maximum 90. |
startDate | string | No | Explicit window start (YYYY-MM-DD). Pass BOTH startDate and endDate to fetch an exact date range instead of the relative days window, use this when the user names specific dates so the year is never guessed. |
endDate | string | No | Explicit window end (YYYY-MM-DD). Pass together with startDate; overrides days. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
days | object[] | Yes | |
dateRange | object | Yes | |
dataAvailability | string | Yes | One of NO_LIVE_ENTITIES, OUT_OF_WINDOW, AVAILABLE. |
campaignLaunchId | string | No | The launch these days belong to, echoed back so a second read can be scoped to the same launch without guessing. |
level | string | No | Which level the days were summed across, echoed back from the request. One of campaign, adset, ad. |
asOf | string | No | ISO time of the live provider read behind this response. Set on MCP and API responses, which may be served from the short metrics cache. |
REST equivalent
GET /v1/brands/{brandId}/launches/{launchId}/insights/daily, Get daily insights. CLI: koast get-insights-daily.