---
title: "Get Answers"
method: POST
path: "/v1/prompts/answers"
tags: ["Prompts"]
---

# Get Answers

`POST /v1/prompts/answers`

## Request body

- AnswersQuery — Body for the answers endpoint.
  - `category_id` string, uuid, required
  - `start_date` string, date-time, required
  - `end_date` string, date-time, required
  - `pagination` Pagination — Offset-based pagination parameters.
    - `limit` integer — Maximum number of results to return. Default is 10,000, maximum is 50,000.
    - `offset` integer — Offset for the results. Used for pagination.
  - `filters` union[] — List of filters to apply to the answers report.
    - union
      - RegionIdFilter — Filter by region UUID.
        - `field` union, required
          - 'region_id'
          - 'region'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - RegionNameFilter — Filter by region name.
        - `field` 'region_name', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - ModelIdFilter — Filter by AI model/platform UUID.
        - `field` union, required
          - 'model_id'
          - 'model'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - TagIdFilter — Filter by tag (prompt group) UUID.
        - `field` union, required
          - 'tag_id'
          - 'tag'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - AnalysisTypeFilter — Filter by analysis type (visibility, sentiment, or accuracy).
        - `field` 'analysis_type', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - 'visibility' | 'sentiment' | 'sentiment_v2' | 'accuracy'
          - string[]
      - PromptTypeFilter — Filter by prompt type (visibility or sentiment). .. deprecated:: Use :class:`AnalysisTypeFilter` instead. ``prompt_type`` is normalised to ``analysis_type`` at parse time.
        - `field` 'prompt_type', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - 'visibility' | 'sentiment'
          - string[]
      - PromptFilter — Filter by prompt text
        - `field` 'prompt', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
      - PersonaIdFilter — Filter by persona UUID.
        - `field` 'persona_id', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - TopicIdFilter — Filter by topic UUID.
        - `field` union, required
          - 'topic_id'
          - 'topic'
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - AssetIdFilter
        - `field` 'asset_id', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in', required
        - `value` union, required
          - string, uuid
          - string[]
      - ProfoundAnswerEngineInsightsFiltersAssetNameFilter — Filter by asset name
        - `field` 'asset_name', required
        - `operator` 'is' | 'not_is' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'matches' | 'contains_case_insensitive' | 'not_contains_case_insensitive', required
        - `value` union, required
          - string
          - string[]
  - `include` EnabledFieldsResponse
    - `run_id` boolean
    - `created_at` boolean
    - `prompt` boolean
    - `prompt_id` boolean
    - `mentions` boolean
    - `analysis_types` boolean
    - `prompt_type` boolean
    - `response` boolean
    - `citations` boolean
    - `citation_details` boolean
    - `web_search_results` boolean
    - `search_triggered` boolean
    - `themes` boolean — Use 'sentiment_themes' instead
    - `sentiment_themes` boolean — Uses legacy sentiment data.
    - `topic` boolean
    - `topic_id` boolean
    - `region` boolean
    - `model` boolean
    - `model_id` boolean
    - `asset` boolean
    - `asset_id` boolean
    - `tags` boolean
    - `search_queries` boolean
    - `persona` boolean

## Response `200`

Successful Response

- AnswersResponse — Response for the answers endpoint.
  - `info` AnswersResponseInfo, required
    - `total_rows` integer, required
  - `data` AnswersRawData[], required
    - `run_id` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `prompt` string, nullable
    - `prompt_id` string, uuid, nullable
    - `mentions` string[], nullable
    - `analysis_types` string[], nullable
    - `prompt_type` string, nullable
    - `response` string, nullable
    - `citations` string[], nullable
    - `citation_details` CitationDetail[], nullable
      - `url` string, required
      - `clean_url` string, required
      - `title` string, required
      - `text` string, nullable
      - `hostname` string, required
      - `path` string, required
      - `first_cited_at` string, nullable
      - `positions` integer[]
      - `groups` CitationDetailGroup[], nullable
        - `group_id` integer, required
        - `group_position` integer, required
      - `citation_category` string, nullable
    - `web_search_results` string[], nullable
    - `search_triggered` boolean, nullable
    - `themes` string[], nullable
    - `sentiment_themes` SentimentTheme[], nullable — Uses legacy sentiment data.
      - `type` union, required
        - 'positive'
        - 'negative'
      - `name` string, required
    - `search_queries` string[], nullable
    - `topic` string, nullable
    - `topic_id` string, uuid, nullable
    - `region` string, nullable
    - `model` string, nullable
    - `model_id` string, uuid, nullable
    - `asset` string, nullable
    - `asset_id` string, uuid, nullable
    - `tags` string[], nullable
    - `persona` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cooper-square-technologies/apis/external-api.md) · [All operations](https://skmtc.net/cooper-square-technologies/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cooper-square-technologies/external-api/revisions/ab03b3c80494/schema)