AI answers
get_ai_answersThe answers themselves: what ChatGPT, Perplexity, Gemini, Claude, Mistral and Google AI Overviews said to this workspace's prompts, each with the brands it mentions and the URLs it cites.
Use this tool when the user wants to read or quote what an AI said -- phrases like 'what does ChatGPT say about us', 'show me the answers to the prompt about X', 'how do AI models describe our competitor', 'show answers where we are not mentioned' -- or to explain a number another Refora tool returned. For numbers (visibility, share of voice, trends, sentiment, sources), use those tools: they count every answer, this one returns a page.
Filter by prompt (its text or a distinctive part of it), model, brand (brand_mentioned=true for answers that mention it, false for answers that don't; without brand_name it is the workspace's own brand) and window. Answers come newest first, 10 per page; when next_offset is set, call again with offset=next_offset. An answer longer than 2,000 characters is cut (truncated: true); to read it whole, call again with its prompt_text, model, its date as start_date and end_date, and full_text=true.
Example: 'What did Perplexity say when asked for the best CRM?'
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspace_id": "<workspace_id>"
},
"name": "get_ai_answers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty. | |
| limit | No | Answers per page. Default 10, max 25. A page can hold fewer when its answers are long. | |
| model | No | Optional: only this AI model's answers. openai = ChatGPT, anthropic = Claude, mistral = Le Chat, google-aio = Google AI Overviews. Omit for every model. | |
| offset | No | How many matching answers to skip. Pass the previous page's next_offset. Default 0. | |
| end_date | No | Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future. | |
| full_text | No | true to return answers whole (up to 20,000 characters each) instead of cut at 2,000. Narrow the filters first: meant for reading one or a few answers. Default false. | |
| brand_name | No | Optional: a brand to filter on. Alone, it keeps the answers that mention it; with brand_mentioned=false, the ones that don't. Omit it and set brand_mentioned to filter on the workspace's own brand. | |
| start_date | No | Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days. | |
| prompt_text | No | Optional: only answers to this prompt. Its text as another Refora tool returned it, or a distinctive part of it, matched case-insensitively. If several prompts match, the response lists them so the user can pick. Omit for every prompt. | |
| workspace_id | Yes | The workspace's numeric id, as returned by list_workspaces. | |
| brand_mentioned | No | Optional: true for only answers that mention the brand, false for only answers that don't. The brand is brand_name, or the workspace's own brand. Omit for answers either way. |