Skip to main content
GET
Get Session Intelligence
Data is sourced from BigQuery — expect a 5–15 minute lag for the most recent events. All dates and timestamps are UTC. Responses are tenant-scoped to the API key and are rate limited (default 60 requests/minute per key; X-RateLimit-* headers are returned, 429 with Retry-After when exceeded) and cached server-side for up to 30 minutes (send Cache-Control: no-cache to skip the cache read; the X-Cache response header reports HIT, MISS, BYPASS, or DISABLED).
Returns a single aggregated payload that powers the marketplace Session Intelligence dashboard — session-engagement distribution, engagement time, intent breakdown, top queried topics, and content-category mix — in one request. Numbers match the Dappier platform analytics dashboard for the same filters.
If either start_date or end_date is omitted, both default to the trailing 7-day window ending today UTC. Explicit ranges must be ≤ 365 days. widget_id is validated against the key’s tenant — an unknown or other-tenant id returns 400 widget_id not found. The seven query-depth buckets ("1", "2", "3", "4", "5", "6-10", "10+") are always returned in session_engagement_distribution, even when empty.

Authorizations

Authorization
string
header
required

Bearer token authentication using your Dappier API key. Get your API key at https://platform.dappier.com/profile/api-keys.

Query Parameters

start_date
string<date>

Inclusive start of the analytics window, formatted YYYY-MM-DD (UTC). Optional — if either start_date or end_date is omitted, both default to the trailing 7-day window ending today_UTC (i.e., start_date = today_UTC - 6).

Example:

"2026-05-15"

end_date
string<date>

Inclusive end of the analytics window, formatted YYYY-MM-DD (UTC). Optional — if either start_date or end_date is omitted, both default to the trailing 7-day window ending today_UTC. Must be on or after start_date; the total range must be ≤ 365 days.

Example:

"2026-05-21"

widget_id
string

External widget id (e.g. wd_...). Validated against the key's tenant — an unknown or other-tenant id returns 400 widget_id not found. Scopes results to that widget's AI agent. Omit for all of the tenant's widgets.

Example:

"wd_abc123"

placement_id
string

External placement id.

deployment_type
string

Deployment type, e.g. brand_agent, widget. Omit for all.

Example:

"brand_agent"

creative_id
string

AdCP creative id filter.

line_item_id
string

AdCP line item id filter.

publisher_id
string

AdCP publisher id filter.

Response

Session intelligence rollup for the requested window and filters.

session_intelligence
object

Single aggregated payload combining six marketplace dashboard reports.