---
title: "The summary of the written answers: themes with counts and quotes, sentiment, a takeaway."
method: GET
path: "/v2/questions/{id}/insights"
tags: ["questions"]
---

# The summary of the written answers: themes with counts and quotes, sentiment, a takeaway.

`GET /v2/questions/{id}/insights`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v2/questions/{id}/insights`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.50heads.com/authorize`, token URL `https://auth.50heads.com/token`; client credentials, token URL `https://auth.50heads.com/token`, scopes: `questions:read`)

Made by a machine from the reasons and free text, never from who answered; counts and quotes are computed from the answers. Written in the account's language, with the question-language original.

## Path parameters

- `id` string, required

## Response `200`

OK

- InsightsResponse
  - `insights` object, nullable, required
    - `questionId` string, required
    - `language` string, required
    - `sourceLanguage` string, required
    - `takeaway` string, required
    - `themes` object[], required
      - `label` string, required
      - `count` integer, required
      - `share` number, required
      - `sentiment` 'positive' | 'neutral' | 'negative', required
      - `option` string, nullable, required
      - `quotes` string[], required
    - `findings` object[]
      - `text` string, required
      - `count` integer, required
      - `option` string, nullable, required
      - `quotes` string[], required
    - `byOption` object[]
      - `option` string, required
      - `n` integer, required
      - `likes` object[], required
        - `label` string, required
        - `count` integer, required
        - `quotes` string[], required
      - `dislikes` object[], required
        - `label` string, required
        - `count` integer, required
        - `quotes` string[], required
    - `followUp` object, nullable
      - `type` 'single_choice' | 'multi_choice' | 'ab_image' | 'pairwise' | 'scale_1_5' | 'ranking' | 'yes_no' | 'yes_mostly_no' | 'free_text' | 'click_test' | 'reaction' | 'rate_each', required
      - `text` string, required
      - `options` string[], required
      - `n` integer, required
      - `tier` union, required
        - 1
        - 2
        - 3
      - `reason` 'off' | 'optional' | 'required', required
    - `sentiment` object, required
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
    - `basedOn` integer, required
    - `answersAtTime` integer, required
    - `original` object, nullable, required
      - `takeaway` string, required
      - `themes` object[], required
        - `label` string, required
        - `quotes` string[], required
      - `findings` object[]
        - `text` string, required
        - `quotes` string[], required
      - `followUp` object, nullable
        - `text` string, required
        - `options` string[], required
    - `kind` 'interim' | 'final', required
    - `generatedAt` string, required
    - `refreshAfter` string, nullable, required
    - `engine` string, required

## Other responses

- `401`: No key or token, or it expired or was revoked.
- `403`: The key or token lacks the scope (`insufficient_scope`), or the action is not allowed.
- `404`: No such question, endpoint or delivery on this account.
- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/ae7392701fe6?raw)