Prompt & Response Tools

get_prompts

List monitored prompts (queries) for a brand.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`status`	string	No	Filter: `PENDING`, `IN_PROGRESS`, `COMPLETED`
`topic`	string	No	Filter by topic/keyword ID
`tag`	string	No	Filter by tag ID
`limit`	number	No	Max prompts (default: 50)
`offset`	number	No	Pagination offset

Returns

Field	Type	Description
`id`	string	Prompt ID
`text`	string	The prompt text
`type`	string	Funnel stage: `TOFU`, `MOFU`, `BOFU`
`status`	string	Processing status
`lastGenerationDate`	string	Last time responses were generated
`answersCount`	number	Total response count

Example Output

## Monitored Prompts

Showing 3 of 156 prompts

### 1. "best project management software 2025"
   - ID: prompt-abc-123
   - Status: COMPLETED
   - Type: TOFU
   - Answers: 48
   - Last checked: 2025-01-28

### 2. "Acme Corp vs Monday.com"
   - 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 a specific prompt across all providers.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`promptId`	string	Yes	The prompt ID (from `get_prompts`)
`provider`	string	No	Filter by AI provider
`limit`	number	No	Max answers (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)
`relevance`	number	Relevance score (if brand mentioned)
`brandMentioned`	boolean	Whether brand appears

Example Output

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

Found 8 responses

### 1. ChatGPT (gpt-4o)
Date: 2025-01-28
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
Brand mentioned: No

Preview: "The top project management tools include Monday.com, Asana, and Notion. Each offers unique strengths..."

### 3. Claude (Sonnet)
Date: 2025-01-27
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:answers

get_answers

Browse and filter all AI responses for a brand.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`provider`	string	No	Filter by AI provider
`topic`	string	No	Filter by topic ID
`tag`	string	No	Filter by tag ID
`startDate`	string	No	Start date (YYYY-MM-DD)
`endDate`	string	No	End date (YYYY-MM-DD)
`limit`	number	No	Max answers (default: 50)
`offset`	number	No	Pagination offset

Returns

Field	Type	Description
`id`	string	Answer ID
`promptText`	string	The prompt that was asked
`provider`	string	AI provider name
`createdAt`	string	Response date
`brandMentioned`	boolean	Whether brand appears
`sourceCited`	boolean	Whether brand domain is cited

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
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

Example Output

## AI Response Details

**Prompt:** "best project management software 2025"
**Provider:** ChatGPT (gpt-4o)
**Date:** 2025-01-28

### Response
For project management in 2025, several excellent options stand out. **Acme Corp** offers robust features for team collaboration including real-time editing, Gantt charts, and automated workflows. Other strong contenders include Monday.com for visual project tracking and Asana 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. **Monday.com** #1 - DIRECT (sentiment: 78/100)
2. **Acme Corp** #2 - SELF (sentiment: 82/100)
3. **Asana** #3 - DIRECT (sentiment: 75/100)

### Sources Cited
1. g2.com (#1)
   https://www.g2.com/categories/project-management
2. acme.com [YOUR SITE] (#2)
   https://www.acme.com/features
3. capterra.com (#3)
   https://www.capterra.com/project-management-software/

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

Getting Started

Tools

Examples

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

Getting Started

Tools

Examples

​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