List the answers a site's Ask AI assistant generated

Returns a paginated list of individual Ask AI answers generated for a site. Each is the assistant's response to a specific asked question, with the raw question text, channel, and feedback. Use it to review answer quality and what users asked across the site.

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

questionstringOptional

Filter answers to a specific site question ID.

fromstring · date-timeOptional

Filter answers created at or after this timestamp.

tostring · date-timeOptional

Filter answers created at or before this timestamp.

languagestringOptional

Filter answers by ISO language code.

helpfulnessstring · enumOptional

Helpfulness of the response for the end user need.

Possible values:

question.typestring · enumOptional

Type classification of the user question.

Possible values:

topicstringOptional

Filter answers by associated site topic ID.

threadstringOptional

Filter answers by thread root answer ID. Includes the root answer itself.

pagestringOptional

Identifier of the page results to fetch.

limitnumber · max: 1000Optional

The number of results per page

Responses

200

OK

application/json

countnumberOptional

Total count of objects in the list

get/orgs/{organizationId}/sites/{siteId}/answers

GET /v1/orgs/{organizationId}/sites/{siteId}/answers HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "next": {
    "page": "text"
  },
  "count": 1,
  "items": [
    {
      "object": "site-question-answer",
      "id": "text",
      "question": {
        "id": "text",
        "type": "exploring"
      },
      "topics": [
        "text"
      ],
      "input": {
        "text": "text",
        "raw": "text"
      },
      "thread": {
        "id": "text",
        "previous": "text"
      },
      "session": {
        "visitorId": "text",
        "sessionId": "text"
      },
      "feedback": {
        "rating": -1
      },
      "responseId": "text",
      "language": "text",
      "answered": "no",
      "helpfulness": "low",
      "relevance": "relevant",
      "channel": {
        "type": "site"
      },
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "urls": {
        "location": "https://example.com"
      }
    }
  ]
}