> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompt & Response Tools

> Tools to browse monitored prompts and analyze AI responses in detail.

## 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 ID from `list_topics`         |
| `tag`     | string | No       | Filter by tag ID from `list_tags`             |
| `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`           |
| `topic`              | object  | Assigned topic ID and label, or `null`         |
| `tags`               | array   | Assigned tag IDs, labels, and colors           |
| `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  | Total response count                           |

### Example Output

```markdown theme={null}
## 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 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) |
| `brandMentioned` | boolean | Whether brand appears                |

### Example Output

```markdown theme={null}
## AI Responses for: "best project management software 2025"

Found 8 responses

### 1. ChatGPT (GPT-5)
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:prompts`

***

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

```markdown theme={null}
## 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

```markdown theme={null}
## AI Response Details

**Prompt:** "best project management software 2025"
**Provider:** ChatGPT (GPT-5)
**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`