Get Ask AI answers over time for a site
Returns how many answers the site's Ask AI assistant gave, and to how many visitors, in each UTC bucket of the interval between from and to, optionally filtered by topic, relevance, channel, visitor type or resolution. Buckets without answers are omitted.
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequiredPattern:
A unique entity identifier
^[a-zA-Z0-9_-]+$siteIdstringRequired
The unique id of the site
Query parameters
fromstring · date-timeRequired
Count answers created at or after this timestamp.
tostring · date-timeRequired
Count answers created at or before this timestamp.
intervalstring · enumRequiredPossible values:
Size of a timeline bucket. Weeks start on Sunday, and every bucket is in UTC.
topicstring[]Optional
Filter answers by associated site topic IDs.
citedPagestring[]Optional
Filter to answers that cited one of these pages as a source, each given as {spaceId}/{pageId}.
Responses
200
OK
application/json
Ask AI answers counted per bucket, oldest first.
get/orgs/{organizationId}/sites/{siteId}/question-timeline
GET /v1/orgs/{organizationId}/sites/{siteId}/question-timeline?from=2026-01-01T00%3A00%3A00.000Z&to=2026-01-01T00%3A00%3A00.000Z&interval=hour HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200
OK
{
"items": [
{
"time": "2026-01-01T00:00:00.000Z",
"answers": 1,
"visitors": 1
}
]
}Last updated
Was this helpful?