Prompt and response tools

See Filter Compatibility for the authoritative global evidence-filter contract. Those shared parameters (period, custom dates, providers, topics, tags, and funnel stages) apply to get_prompts, get_prompt_answers, and get_answers in addition to the parameters shown below. These three tools default to the last 30 days.

get_prompts

List monitored prompts with their configuration and the number of answers in the selected evidence scope.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`status`	string	No	`PENDING`, `IN_PROGRESS`, or `COMPLETED`
`personaIds`	string[]	No	Keep prompts with historical answers for these persona UUIDs; `"default"` matches answers generated without a persona
`countries`	string[]	No	Keep prompts with historical answers from these countries (ISO 3166-1 alpha-2 codes, up to 50)
`limit`	number	No	Max prompts (default: 50)
`offset`	number	No	Pagination offset (default: 0)

Provider, persona, and country filters must match the same historical answer, across the prompt’s full history. They never filter the prompt’s current persona or model assignments. answersCount uses the selected period and the same filters.

Returns

Field	Type	Description
`id`	string	Prompt ID
`text`	string	The prompt text
`type`	string	Funnel stage: `TOFU`, `MOFU`, `BOFU`, or `POST_PURCHASE`
`topic`	object	Assigned topic (`id`, `text`), or `null`
`tags`	array	Assigned tag IDs, labels, and colors
`personas`	array	Personas currently assigned to the prompt (`id`, `name`, `description`)
`modelIds`	string[]	Model IDs currently configured on the prompt
`monitoringEnabled`	boolean	Whether scheduled monitoring is enabled
`frequency`	string	Effective monitoring frequency
`frequencyInherited`	boolean	Whether frequency comes from the brand default
`boostCount`	number	Responses requested per model and run
`status`	string	Processing status
`lastGenerationDate`	string	Last time responses were generated
`answersCount`	number	Answers in the selected period and filters

Example output

## Monitored Prompts

Showing 3 of 156 prompts

### 1. "best project management software 2025"
   - ID: prompt-abc-123
   - Status: COMPLETED
   - Type: TOFU
   - Topic: Project Management (ID: topic-123)
   - Tags: Priority (ID: tag-456)
   - Monitoring: enabled, weekly (brand default), boost ×2
   - Answers: 48
   - Last checked: 2025-01-28

### 2. "Acme Corp vs Northstar Work"
   - ID: prompt-def-456
   - Status: COMPLETED
   - Type: BOFU
   - Answers: 32
   - Last checked: 2025-01-28

### 3. "how to improve team productivity"
   - ID: prompt-ghi-789
   - Status: COMPLETED
   - Type: TOFU
   - Answers: 56
   - Last checked: 2025-01-27

Example prompts

What prompts am I monitoring?

Show me my BOFU queries

List prompts with the "pricing" tag

OAuth scope

Requires: read:prompts

get_prompt_answers

Get AI responses for one monitored prompt across providers, newest first.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`promptId`	string	Yes	The prompt UUID from `get_prompts`
`limit`	integer	No	Max answers, 1 to 100 (default: 20)

Returns

Field	Type	Description
`id`	string	Answer ID
`text`	string	Response preview (first 500 chars)
`provider`	string	AI provider name
`modelId`	string	Specific model used
`createdAt`	string	Response date
`sentiment`	number	Sentiment score (if brand mentioned)
`status`	string	Processing status: `PROCESSING`, `COMPLETED`, or `PARTIAL_ERROR`. `PROCESSING` means the response text is available but its analyses are still incomplete
`brandMentioned`	boolean or null	Whether brand appears; `null` while `status` is `PROCESSING`, not `false`
`persona`	object	Persona recorded when the answer was generated, or `null`

Example output

## AI Responses for: "best project management software 2025"

Found 8 responses

### 1. ChatGPT (GPT-5)
Date: 2025-01-28
Status: COMPLETED
Brand mentioned: Yes
Sentiment: 82/100

Preview: "For project management in 2025, several excellent options stand out. **Acme Corp** offers robust features for team collaboration..."

### 2. Perplexity Pro
Date: 2025-01-28
Status: COMPLETED
Brand mentioned: No

Preview: "The top project management tools include Northstar Work, TaskHarbor, and Acme Corp. Each offers different collaboration features..."

### 3. Claude (Sonnet)
Date: 2025-01-27
Status: COMPLETED
Brand mentioned: Yes
Sentiment: 79/100

Preview: "Based on recent reviews, I'd recommend considering **Acme Corp** for enterprise teams that need..."

Example prompts

How do AI providers answer "best project management software"?

Show me ChatGPT's response to my pricing query

Compare how different AIs respond to this prompt

OAuth scope

Requires: read:prompts

get_answers

Browse AI responses in the selected evidence scope, newest first. Use get_answer_details for the full text of one response.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`personaIds`	string[]	No	Persona UUIDs recorded on the answer; `"default"` matches answers generated without a persona
`countries`	string[]	No	Answer countries (ISO 3166-1 alpha-2 codes, up to 50)
`limit`	number	No	Max answers (default: 50)
`offset`	number	No	Pagination offset (default: 0)

Returns

Field	Type	Description
`id`	string	Answer ID
`promptText`	string	The prompt that was asked
`provider`	string	AI provider name
`createdAt`	string	Response date
`status`	string	Processing status: `PROCESSING`, `COMPLETED`, or `PARTIAL_ERROR`
`brandMentioned`	boolean or null	Whether the brand appears; `null` until analysis completes
`sourceCited`	boolean or null	Whether the brand domain is cited; `null` until analysis completes
`persona`	object	Persona recorded when the answer was generated, or `null`

Example output

## AI responses

Showing 10 of 2,340 responses

| Date | Provider | Prompt | Brand | Source |
|------|----------|--------|-------|--------|
| 2025-01-28 | ChatGPT | best project management so... | Yes | Yes |
| 2025-01-28 | Perplexity | top collaboration tools | No | No |
| 2025-01-28 | Claude | Acme Corp review | Yes | Yes |
| 2025-01-27 | Gemini | workflow automation soft... | Yes | No |

Example prompts

Show me responses from this week

Find responses where my brand was mentioned

List Perplexity responses from January

OAuth scope

Requires: read:answers

get_answer_details

Get full details of a specific AI response including text, competitors, and sources.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`answerId`	string	Yes	The answer ID (from other tools)

Returns

Section	Description
Response	Full text, provider, model, date, processing status (`PROCESSING`, `COMPLETED`, or `PARTIAL_ERROR`), and the persona recorded on the answer
Prompt	Original prompt text and type
Competitors	All brands mentioned with position and sentiment
Sources	All URLs cited with domain and position
Enrichment	AI-extracted topic, keywords, summary, answer type

While status is PROCESSING, the response text is available but its analyses are still incomplete.

Example output

## AI response details

**Prompt:** "best project management software 2025"
**Provider:** ChatGPT (GPT-5)
**Date:** 2025-01-28
**Status:** COMPLETED

### Response
For project management in 2025, several options stand out. **Acme Corp** offers team collaboration features including real-time editing, Gantt charts, and automated workflows. Other contenders in this synthetic sample include Northstar Work for visual project tracking and TaskHarbor for task management...

### Analysis
- Topic: Project Management Software
- Type: Comparison
- Keywords: project management, collaboration, Gantt charts, workflows

**Summary:** Comparison of project management tools highlighting Acme Corp's collaboration features.

### Competitors mentioned
1. **Northstar Work** #1 - DIRECT (sentiment: 78/100)
2. **Acme Corp** #2 - SELF (sentiment: 82/100)
3. **TaskHarbor** #3 - DIRECT (sentiment: 75/100)

### Sources cited
1. reviews.example (#1)
   https://reviews.example/project-management
2. acme.example [YOUR SITE] (#2)
   https://www.acme.example/features
3. software-guide.example (#3)
   https://software-guide.example/project-management

Example prompts

Show me the full details of that response

What sources were cited in that ChatGPT answer?

Who was mentioned in that response?

OAuth scope

Requires: read:answers

Get started

Clients

Tool reference

Examples

Workflows

get_prompts

Parameters

Returns

Example output

Example prompts

OAuth scope

get_prompt_answers

Parameters

Returns

Example output

Example prompts

OAuth scope

get_answers

Parameters

Returns

Example output

Example prompts

OAuth scope

get_answer_details

Parameters

Returns

Example output

Example prompts

OAuth scope

​get_prompts

​Parameters

​Returns

​Example output

​Example prompts

​OAuth scope

​get_prompt_answers

​Parameters

​Returns

​Example output

​Example prompts

​OAuth scope

​get_answers

​Parameters

​Returns

​Example output

​Example prompts

​OAuth scope

​get_answer_details

​Parameters

​Returns

​Example output

​Example prompts

​OAuth scope

get_prompts

Parameters

Returns

Example output

Example prompts

OAuth scope

get_prompt_answers

Parameters

Returns

Example output

Example prompts

OAuth scope

get_answers

Parameters

Returns

Example output

Example prompts

OAuth scope

get_answer_details

Parameters

Returns

Example output

Example prompts

OAuth scope