Skip to main content
GET
/
v1
/
analytics
/
ask-ai
/
logs
Get Ask AI Logs
curl --request GET \
  --url https://api.dappier.com/v1/analytics/ask-ai/logs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "timestamp": "2026-05-18T09:14:22Z",
      "widget_id": "wd_92831",
      "placement_id": "pl_abc",
      "deployment_type": "brand_agent",
      "ai_agent": "Acme Support Agent",
      "referring_url": "https://example.com/pricing",
      "interaction_type": "free_form",
      "prompt": "Do you offer annual billing?",
      "response": "Yes — annual plans include a 20% discount..."
    }
  ],
  "total_pages": 12,
  "count": 573,
  "meta": {
    "timezone": "UTC",
    "generated_at": "2026-05-18T09:20:00Z"
  }
}
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).
This is a record-level endpoint for inspecting individual conversations. For aggregate KPIs and time-series use Ask AI Analytics instead.
If either start_date or end_date is omitted, both default to the trailing 7-day window ending today UTC. page must be ≥ 1; limit defaults to 50 and is clamped to a hard max of 500 (larger values are silently reduced). When interaction_type is omitted the service defaults to free_form, automated_followup, and search.

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-01"

​
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-18"

​
widget_id
string

Filter to one widget. Omit for all widgets the account owns.

Example:

"wd_92831"

​
placement_id
string

Filter to one placement.

​
deployment_type
string

Filter by deployment type (exact match).

Example:

"brand_agent"

​
interaction_type
string

Single value. When omitted, the service defaults to free_form, automated_followup, and search.

Example:

"free_form"

​
page
integer
default:1

1-based page number. Must be ≥ 1.

Required range: x >= 1
Example:

1

​
limit
integer
default:50

Page size. Hard max 500 — larger values are clamped down.

Required range: x <= 500
Example:

100

Response

A page of conversation log rows, newest-first.

​
data
object[]

Conversation log rows, newest-first by timestamp.

​
total_pages
integer

Total pages for the current limit.

Example:

12

​
count
integer

Total matching rows across all pages.

Example:

573

​
meta
object