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.

Available in MCP
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

A unique entity identifier

Pattern: ^[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 · enumRequired

Size of a timeline bucket. Weeks start on Sunday, and every bucket is in UTC.

Possible values:
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?

Powered by GitBook