Session Intelligence - Dappier API Guide

Get Session Intelligence

curl --request GET \
  --url https://api.dappier.com/v1/analytics/session-intelligence \
  --header 'Authorization: Bearer <token>'

{
  "session_intelligence": {
    "summary": {
      "total_engaged_sessions": 110,
      "total_queries": 187,
      "average_queries_per_session": 1.7,
      "sessions_with_2_plus_queries": 40,
      "sessions_with_2_plus_queries_percentage": 36,
      "single_query_sessions": 70,
      "single_query_sessions_percentage": 64,
      "max_queries_in_session": 4
    },
    "engagement_time": {
      "total_session_time_seconds": 3170,
      "average_engagement_time_per_session_seconds": 288,
      "median_engagement_time_per_session_seconds": 164,
      "sessions_with_engagement": 11
    },
    "intent_breakdown": [
      {
        "intent_type": "informational",
        "label": "Informational",
        "sessions": 98,
        "percentage": 89
      }
    ],
    "top_queried_topics": [
      {
        "query": "the iht loophole the wealthy don't talk about",
        "category": "Business and Finance",
        "count": 4
      }
    ],
    "category_distribution": [
      {
        "category": "Personal Finance",
        "count": 42,
        "percentage": 27
      }
    ],
    "session_engagement_distribution": [
      {
        "query_depth": "1",
        "sessions": 70,
        "percentage": 64
      }
    ]
  }
}

GET

analytics

session-intelligence

Get Session Intelligence

curl --request GET \
  --url https://api.dappier.com/v1/analytics/session-intelligence \
  --header 'Authorization: Bearer <token>'

{
  "session_intelligence": {
    "summary": {
      "total_engaged_sessions": 110,
      "total_queries": 187,
      "average_queries_per_session": 1.7,
      "sessions_with_2_plus_queries": 40,
      "sessions_with_2_plus_queries_percentage": 36,
      "single_query_sessions": 70,
      "single_query_sessions_percentage": 64,
      "max_queries_in_session": 4
    },
    "engagement_time": {
      "total_session_time_seconds": 3170,
      "average_engagement_time_per_session_seconds": 288,
      "median_engagement_time_per_session_seconds": 164,
      "sessions_with_engagement": 11
    },
    "intent_breakdown": [
      {
        "intent_type": "informational",
        "label": "Informational",
        "sessions": 98,
        "percentage": 89
      }
    ],
    "top_queried_topics": [
      {
        "query": "the iht loophole the wealthy don't talk about",
        "category": "Business and Finance",
        "count": 4
      }
    ],
    "category_distribution": [
      {
        "category": "Personal Finance",
        "count": 42,
        "percentage": 27
      }
    ],
    "session_engagement_distribution": [
      {
        "query_depth": "1",
        "sessions": 70,
        "percentage": 64
      }
    ]
  }
}

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"

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.

Show child attributes