# Get action plan details by ID Source: https://docs.firstanswer.ai/api-reference/action-plans/get-action-plan-details-by-id /api-reference/openapi.yaml get /v1/action-plans/{action_plan_id}/ # List action plans for a brand Source: https://docs.firstanswer.ai/api-reference/action-plans/list-action-plans-for-a-brand /api-reference/openapi.yaml get /v1/action-plans/ # Authentication Source: https://docs.firstanswer.ai/api-reference/authentication Learn how to authenticate your requests to the First Answer API using API keys. ## API Key Authentication The First Answer API uses **API keys** to authenticate requests. Every request to the `/v1/` endpoints must include a valid API key in the request headers. ```bash theme={null} curl -H "api-key: YOUR_API_KEY" \ https://api.firstanswer.ai/v1/brands/ ``` > [!WARNING] > > API keys grant access to your account data. Keep them secure and never expose them in client-side code, public repositories, or browser requests. ## Obtaining an API Key **1. Navigate to API settings** Log in to the First Answer platform and go to **Settings → API Keys**. **2. Create a new key** Click **Create API Key** and give it a descriptive name (e.g. "Production Dashboard", "Internal Analytics"). **3. Copy your key** Your API key will be displayed **only once**. Copy it and store it securely. If you lose it, you'll need to generate a new one. ## Using Your API Key Include the API key in the `api-key` header of every request: ```bash cURL theme={null} curl -H "api-key: YOUR_API_KEY" \ https://api.firstanswer.ai/v1/brands/ ``` ```python Python theme={null} import requests headers = {"api-key": "YOUR_API_KEY"} response = requests.get( "https://api.firstanswer.ai/v1/brands/", headers=headers, ) print(response.json()) ``` ```javascript JavaScript theme={null} const response = await fetch("https://api.firstanswer.ai/v1/brands/", { headers: { "api-key": "YOUR_API_KEY", }, }); const data = await response.json(); console.log(data); ``` ## Key Expiration API keys are valid for **6 months** from the date of creation. After expiration, requests made with the key will return a `401` error: ```json theme={null} { "error": { "code": "AUTHENTICATION_FAILED", "message": "API key has expired." } } ``` Generate a new key before the current one expires to avoid service interruptions. ## Error Responses ### Missing API Key If no `api-key` header is provided, the API will return: ```json 401 theme={null} { "error": { "code": "AUTHENTICATION_FAILED", "message": "Authentication credentials were not provided." } } ``` ### Invalid API Key If the key is incorrect or has been revoked: ```json 401 theme={null} { "error": { "code": "AUTHENTICATION_FAILED", "message": "Invalid or inactive API key." } } ``` ### Expired API Key If the key has passed its expiration date: ```json 401 theme={null} { "error": { "code": "AUTHENTICATION_FAILED", "message": "API key has expired." } } ``` ## Best Practices > **Use environment variables** > > Never hardcode API keys in your source code. Store them as environment variables: > > ```bash theme={null} > export FIRSTANSWER_API_KEY="your-key-here" > ``` > > ```python theme={null} > import os > api_key = os.environ["FIRSTANSWER_API_KEY"] > ``` > **Rotate keys periodically** > > Don't wait for keys to expire. Create a new key, update your integrations, then revoke the old one. > **Use descriptive names** > > Name your keys after their purpose (e.g. "Looker Dashboard", "Internal Slack Bot") so you can easily manage and revoke them. > **Revoke unused keys** > > If a key is no longer needed, revoke it immediately in your API settings. This prevents unauthorized access. > **Never expose keys client-side** > > API keys should only be used in server-side code. Never include them in frontend JavaScript, mobile apps, or any publicly accessible code. # Get brand details Source: https://docs.firstanswer.ai/api-reference/brands/get-brand-details /api-reference/openapi.yaml get /v1/brands/{brand_id}/ # List all brands Source: https://docs.firstanswer.ai/api-reference/brands/list-all-brands /api-reference/openapi.yaml get /v1/brands/ # List all cited URLs across all domains Source: https://docs.firstanswer.ai/api-reference/cited-sources/list-all-cited-urls-across-all-domains /api-reference/openapi.yaml get /v1/cited-sources/urls/ # List cited sources Source: https://docs.firstanswer.ai/api-reference/cited-sources/list-cited-sources /api-reference/openapi.yaml get /v1/cited-sources/ # List cited sources URLs for a domain Source: https://docs.firstanswer.ai/api-reference/cited-sources/list-cited-sources-urls-for-a-domain /api-reference/openapi.yaml get /v1/cited-sources/{domain_id}/urls/ # List prompts related to a cited source domain Source: https://docs.firstanswer.ai/api-reference/cited-sources/list-prompts-related-to-a-cited-source-domain /api-reference/openapi.yaml get /v1/cited-sources/{domain_id}/related-prompts/ # List prompts related to a cited source URL Source: https://docs.firstanswer.ai/api-reference/cited-sources/list-prompts-related-to-a-cited-source-url /api-reference/openapi.yaml get /v1/cited-sources/{domain_id}/urls/{url_id}/related-prompts/ # Get dashboard data Source: https://docs.firstanswer.ai/api-reference/dashboard/get-dashboard-data /api-reference/openapi.yaml get /v1/dashboard/ # List all groups Source: https://docs.firstanswer.ai/api-reference/groups/list-all-groups /api-reference/openapi.yaml get /v1/groups/ # Introduction Source: https://docs.firstanswer.ai/api-reference/introduction Welcome to the First Answer API. Access your AI visibility monitoring data programmatically. ## Overview The First Answer API gives you programmatic access to the data available in the First Answer platform. Use it to integrate AI visibility insights into your own workflows, dashboards, and tools. All endpoints are **read-only** (HTTP `GET`) and return data in JSON format. The API follows RESTful conventions and uses standard HTTP status codes. ## Base URL All API requests should be made to: ```text theme={null} https://api.firstanswer.ai ``` ## Available Resources | Resource | Description | | - | - | | [Brands](/api-reference/brands) | Your monitored brands and their visibility data | | [Groups](/api-reference/groups) | Prompt groups for organization | | [Monitored Competitors](/api-reference/monitored-competitors) | Competitor brands and their visibility data | | [Monitored Prompts](/api-reference/monitored-prompts) | AI prompts being tracked, with responses, citations, and search queries | | [Cited Sources](/api-reference/cited-sources) | Domains and URLs cited in AI responses, with related prompts | | [Action Plans](/api-reference/action-plans) | Suggested action plans for improving AI visibility | | [Dashboard](/api-reference/dashboard) | Aggregated dashboard metrics | ## Response Format All successful responses follow a consistent structure. **Single resource:** ```json theme={null} { "data": { "id": 1, "name": "Example Brand" } } ``` **Paginated list:** ```json theme={null} { "pagination": { "current_page": 1, "per_page": 100, "total_pages": 3, "total_records": 250 }, "data": [ { "id": 1, "name": "Example Brand" } ] } ``` ## Pagination List endpoints return paginated results. Use the `page` and `per_page` query parameters to control pagination: | Parameter | Type | Default | Description | | - | - | - | - | | `page` | integer | `1` | Page number (1-indexed) | | `per_page` | integer | `100` | Number of items per page (min: `1`, max: `100`) | ## Error Format All errors return a consistent JSON structure: ```json theme={null} { "error": { "code": "ERROR_CODE", "message": "A human-readable description of the error." } } ``` ### Error Codes | HTTP Status | Code | Description | | - | - | - | | `401` | `AUTHENTICATION_FAILED` | Missing, invalid, or expired API key | | `403` | `PERMISSION_DENIED` | API key does not have access to this resource | | `404` | `NOT_FOUND` | The requested resource does not exist | | `405` | `METHOD_NOT_ALLOWED` | HTTP method not supported for this endpoint | | `429` | `RATE_LIMIT_EXCEEDED` | Project rate limit exceeded — see [Rate limits](/api-reference/rate-limits) | | `500` | `INTERNAL_SERVER_ERROR` | An unexpected error occurred on the server | ## Quick Start **1. Get your API key** Go to your [account settings](https://app.firstanswer.ai/settings/api-keys) and generate a new API key. Copy it immediately — it won't be shown again. **2. Make your first request** ```bash theme={null} curl -H "api-key: YOUR_API_KEY" \ https://api.firstanswer.ai/v1/brands/ ``` **3. Explore the data** Use the response to navigate related resources like monitored prompts, citations, and competitors. ## Need Help? If you have questions or run into issues, reach out to our support team at [support@firstanswer.ai](mailto:support@firstanswer.ai). # Get monitored competitor details Source: https://docs.firstanswer.ai/api-reference/monitored-competitors/get-monitored-competitor-details /api-reference/openapi.yaml get /v1/monitored-competitors/{monitored_competitor_id}/ # List all monitored competitors Source: https://docs.firstanswer.ai/api-reference/monitored-competitors/list-all-monitored-competitors /api-reference/openapi.yaml get /v1/monitored-competitors/ # Get monitored prompt citations Source: https://docs.firstanswer.ai/api-reference/monitored-prompts/get-monitored-prompt-citations /api-reference/openapi.yaml get /v1/monitored-prompts/{monitored_prompt_id}/citations/ # Get monitored prompt details Source: https://docs.firstanswer.ai/api-reference/monitored-prompts/get-monitored-prompt-details /api-reference/openapi.yaml get /v1/monitored-prompts/{monitored_prompt_id}/ # Get monitored prompt responses Source: https://docs.firstanswer.ai/api-reference/monitored-prompts/get-monitored-prompt-responses /api-reference/openapi.yaml get /v1/monitored-prompts/{monitored_prompt_id}/responses/ # Get monitored prompt search queries Source: https://docs.firstanswer.ai/api-reference/monitored-prompts/get-monitored-prompt-search-queries /api-reference/openapi.yaml get /v1/monitored-prompts/{monitored_prompt_id}/search-queries/ # List all monitored prompts Source: https://docs.firstanswer.ai/api-reference/monitored-prompts/list-all-monitored-prompts /api-reference/openapi.yaml get /v1/monitored-prompts/ # Rate Limits Source: https://docs.firstanswer.ai/api-reference/rate-limits Understand how rate limits work on the First Answer API and how to handle them gracefully. ## How It Works The First Answer API enforces rate limits **per project** on a **per-minute** sliding window. All API keys within the same project share the same rate limit counter. The rate limit for your project is determined by your plan. ## Rate Limit Headers Every API response includes headers to help you track your usage: | Header | Description | | - | - | | `X-RateLimit-Limit` | Maximum requests allowed per minute | | `X-RateLimit-Remaining` | Requests remaining in the current window | | `Retry-After` | Seconds to wait before making another request (only on `429` responses) | ## Exceeding the Limit When you exceed your rate limit, the API returns a `429 Too Many Requests` response: ```json 429 theme={null} { "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded.", "retry_after_seconds": 23 } } ``` The `retry_after_seconds` field tells you exactly how many seconds to wait before retrying. ## Handling Rate Limits ### Retry with Backoff The simplest approach is to respect the `retry_after_seconds` value: ```python Python theme={null} import time import requests API_KEY = "YOUR_API_KEY" BASE_URL = "https://api.firstanswer.ai/v1" def api_request(endpoint): response = requests.get( f"{BASE_URL}{endpoint}", headers={"api-key": API_KEY}, ) if response.status_code == 429: retry_after = response.json()["error"]["retry_after_seconds"] print(f"Rate limited. Retrying in {retry_after}s...") time.sleep(retry_after) return api_request(endpoint) return response.json() ``` ```javascript JavaScript theme={null} const API_KEY = "YOUR_API_KEY"; const BASE_URL = "https://api.firstanswer.ai/v1"; async function apiRequest(endpoint) { const response = await fetch(`${BASE_URL}${endpoint}`, { headers: { "api-key": API_KEY }, }); if (response.status === 429) { const { error } = await response.json(); const retryAfter = error.retry_after_seconds; console.log(`Rate limited. Retrying in ${retryAfter}s...`); await new Promise((r) => setTimeout(r, retryAfter * 1000)); return apiRequest(endpoint); } return response.json(); } ``` ### Spread Requests Over Time If you need to make many requests, spread them evenly within your rate limit window instead of sending them in bursts: ```python theme={null} import time import requests API_KEY = "YOUR_API_KEY" BASE_URL = "https://api.firstanswer.ai/v1" RATE_LIMIT = 10 # requests per minute DELAY = 60 / RATE_LIMIT # 6 seconds between requests endpoints = [ "/brands/", "/monitored-prompts/", "/cited-sources/", "/monitored-competitors/", "/dashboard/", ] for endpoint in endpoints: response = requests.get( f"{BASE_URL}{endpoint}", headers={"api-key": API_KEY}, ) print(f"{endpoint}: {response.status_code}") time.sleep(DELAY) ``` ## Best Practices > **Cache responses** > > Store API responses locally and reuse them when the data hasn't changed. Most monitoring data updates on a daily or weekly basis. > **Use pagination wisely** > > Each page returns up to 100 items by default. Use the `page` and `per_page` parameters to control page size and iterate through results efficiently. > **Request only what you need** > > Target specific endpoints and resources rather than fetching everything on every sync. > **Monitor your usage** > > Track `429` responses in your application logs to identify when you're approaching your limits. ## Need Higher Limits? If your integration requires a higher rate limit, [contact our team](mailto:support@firstanswer.ai) to discuss Enterprise plans with custom limits. # Action Plan Source: https://docs.firstanswer.ai/features/action-plan Get AI-generated action plans with concrete steps to improve your brand's visibility in AI responses.  ## What is the Action Plan? The Action Plan feature generates intelligent, actionable recommendations based on your monitored prompt data. Instead of just showing you where your brand is missing from AI responses, it tells you **what to do about it**. Each action plan analyzes your prompt performance and produces a set of concrete steps you can take to improve your brand's presence in AI-generated answers. ## How it works Action Plans are generated from your monitored prompts. When you create a new plan, First Answer analyzes: * Which prompts have low or zero visibility for your brand * What competitors appear instead * Which sources AI models cite in their responses * Patterns across your best and worst performing prompts Based on this analysis, it generates a prioritized list of actions — from content creation suggestions to SEO recommendations — tailored to improve your AI visibility. ## Understanding action plans Each plan includes: | Field | Description | | - | - | | **Prompt** | The monitored prompt the plan is based on | | **Actions** | The number of recommended action items | | **Date** | When the plan was generated | | **Status** | Open or Archived | ### Action items Each action within a plan is a specific, implementable recommendation. Actions may include: * **Content creation**: Write a blog post or landing page targeting a specific topic * **Content optimization**: Update existing pages to better address the prompt's intent * **Source building**: Get mentioned on high-authority sites that AI models frequently cite * **Technical improvements**: Structured data, page speed, or indexing fixes ## Tabs: Open and Archived * **Open**: Active action plans you are currently working on * **Archived**: Completed plans you have already addressed, kept for historical reference ## How to use Action Plans **1. Generate a new plan** Click **+ New Plan** to create an action plan. Select the monitored prompts you want to analyze. **2. Review recommended actions** Click on a plan to see its full list of actions. Each action includes context about why it was recommended and what impact it may have. **3. Prioritize and execute** Focus on actions that target your highest-value prompts first. Low-visibility prompts with high search intent should be your top priority. **4. Track progress** As you implement actions, monitor the corresponding prompts to see if visibility improves. Archive completed plans to keep your workspace clean. > [!TIP] > > Generate action plans regularly — at least monthly. As AI models update their training data and sources, new opportunities emerge that weren't previously available. # AI Analytics Source: https://docs.firstanswer.ai/features/ai-analytics Track real traffic arriving at your website from AI-generated responses and understand how AI visibility converts to actual visitors.  ## What is AI Analytics? AI Analytics closes the loop between AI visibility and real business impact. While other features track how your brand appears in AI responses, AI Analytics tracks what happens next — **how many users actually visit your website after seeing your brand mentioned by an AI model**. This is the ultimate measure of your AI visibility strategy's effectiveness. Appearances in AI responses only matter if they drive real traffic and engagement. ## How it works AI Analytics integrates with your website to detect visitors arriving from AI platforms. When a user clicks a link in an AI-generated response (e.g., a citation link in Perplexity or a reference in ChatGPT), that visit is tracked and attributed to the originating AI model. ## Dashboard sections ### Visitors Over Time A time-series chart showing the number of AI-referred visitors per day. Each AI model is represented by a distinct color, making it easy to see which models drive the most traffic. Toggle between **Daily**, **Weekly**, and **Monthly** views. ### Traffic by AI Source Shows which AI models are driving the most visitors to your site: * **AI Model**: The source of the traffic (e.g., ChatGPT, Gemini, Perplexity) * **Visit count**: Total number of visitors from this model * **Percentage**: This model's share of your total AI traffic ### Traffic by Country Geographic breakdown of your AI-referred visitors. This helps you understand which markets are discovering your brand through AI models and can inform localization or market expansion decisions. ### Traffic by Page Shows which pages on your site receive the most visitors from AI sources: * **Page URL**: The landing page receiving AI traffic * **Visit count**: Number of visitors arriving at this page * **Percentage**: This page's share of total AI traffic ## Filters * **Date range**: Default is last 7 days, adjustable for longer trends * **Models**: Filter by specific AI model to see traffic from only that source ## Key concepts ### From visibility to traffic The relationship between AI visibility and AI traffic is not always linear. You may have high visibility (your brand is mentioned often) but low traffic (users don't click through). This can happen when: * AI responses mention your brand but don't link to your site * Your brand is mentioned in a way that doesn't inspire curiosity or action * The AI model doesn't provide a direct URL Conversely, some models like Perplexity consistently provide source links, making it easier to drive traffic from AI responses. ### AI traffic attribution Not all AI-referred traffic is equal. Understanding the source helps you prioritize: * **Perplexity**: High click-through rates because responses always include source links * **ChatGPT**: Variable — depends on whether the response includes links * **Gemini / Google AI Mode**: Growing source as Google integrates AI into search * **Bing Copilot**: Traffic from Copilot often comes with purchase intent ### Measuring ROI AI Analytics lets you quantify the ROI of your AI visibility efforts. By tracking: 1. How much AI traffic you receive 2. Which pages receive the most AI traffic 3. How this traffic grows over time You can connect your visibility improvements directly to business metrics. ## Setting up AI Analytics To start tracking AI-referred traffic, you need to add the FirstAnswer tracking script to your website. There are two ways to do this. ### Adding the script directly to your site Copy the snippet from your account settings and paste it inside the `
` tag of every page you want to track: ```html theme={null} ``` Replace `YOUR_PROJECT_ID` with the value shown in your account settings. ### Adding the script via Google Tag Manager If your site uses Google Tag Manager, you can deploy the tracking script without editing your HTML directly. **1. Open Google Tag Manager** Go to [tagmanager.google.com](https://tagmanager.google.com) and open the **workspace** for your website. **2. Create a new tag** In the left sidebar, click **Tags**, then click **New**.  **3. Configure the tag** Click **Tag Configuration** to choose the tag type.  Search for **Custom HTML** and select it.  Paste the following snippet into the HTML field: ```html theme={null} ``` Replace `YOUR_PROJECT_ID` with the value shown in your FirstAnswer account settings.  **4. Set the trigger** Scroll down to the **Triggering** section and click on it. Choose the parameters that make sense for your site. For all pages, select **All Pages** to ensure the script runs on every page of your site. Otherwise, select the event that makes sense for your site.  **5. Save and publish** Give the tag a name (e.g., `FirstAnswer AI Analytics`), click **Save**, then click **Submit** to publish your changes.  After saving, the tag appears in your Tags list ready to be published.  > [!TIP] > > After publishing, visit a page on your site to verify the tag fires. In GTM, use **Preview** mode before publishing to confirm the tag loads correctly. ## How to use AI Analytics **1. Set up tracking** Ensure your website has AI Analytics properly configured by following the setup instructions in your account settings. **2. Identify top traffic sources** Check the Traffic by AI Source section to see which AI models drive the most visitors to your site. **3. Optimize high-traffic pages** Focus on pages that receive the most AI traffic. Ensure they have clear calls-to-action, relevant content, and a good user experience. **4. Correlate with visibility data** Cross-reference AI Analytics with your [Monitored Prompts](/features/monitored-prompts) and [Cited Sources](/features/cited-sources) data. High visibility + low traffic means you need more direct links. High traffic + low visibility means a few key sources are doing the heavy lifting. **5. Track growth over time** Use the Visitors Over Time chart to measure the impact of your AI visibility improvements. As you optimize content and get cited by more sources, AI traffic should trend upward. > [!TIP] > > AI Analytics is especially powerful when combined with your existing web analytics (Google Analytics, Plausible, etc.). Compare AI-referred traffic against organic search traffic to understand the relative impact of AI on your overall traffic mix. # Brands Source: https://docs.firstanswer.ai/features/brands Manage multiple brands from a single account — each with its own prompts, competitors, and visibility tracking.  ## What are Brands? Brands lets you manage multiple brands, products, or business units from a single First Answer account. Each brand operates as an independent workspace with its own set of monitored prompts, competitors, cited sources, and analytics. This is essential for agencies managing client brands, enterprises with multiple product lines, or businesses operating in different markets. ## How it works When you create a brand in First Answer, you define: * **Brand name**: The primary name AI models should recognize * **Description**: A brief description that helps First Answer understand your brand's context and industry * **Country/Region**: The primary market for this brand, which influences how prompts are executed and analyzed All other features (Dashboard, Monitored Prompts, Competitors, etc.) operate within the context of the currently selected brand. You can switch between brands using the brand selector in the top navigation bar. ## Brand list The Brands page shows all brands in your account. For each brand, you can see: * **Brand icon**: A visual identifier (typically the brand's favicon) * **Brand name**: The primary name * **Description**: A summary of what the brand is about * **Country**: The primary market with country flag * **Region**: Additional geographic context ## Key concepts ### Brand context Every metric, prompt, and analysis in First Answer is scoped to a specific brand. When you switch brands in the top navigation, the entire interface updates to show data relevant to that brand. This means: * The Dashboard shows metrics for the selected brand * Monitored Prompts are specific to the selected brand * Competitors are tracked relative to the selected brand * Cited Sources reflect what AI models cite when your selected brand's prompts are executed ### Multi-brand strategy Managing multiple brands lets you: * **Compare strategies**: See which content or SEO approaches work better for different brands * **Share learnings**: If one brand achieves high visibility for a certain type of prompt, apply that strategy to other brands * **Segment markets**: Track the same brand across different countries or languages ### Brand description quality The brand description you provide matters. First Answer uses it to better understand your brand context, which improves the accuracy of: * Sentiment analysis (understanding whether a mention is positive or negative) * Competitor suggestions (recommending relevant competitors) * Action plan recommendations (generating relevant content suggestions) > [!NOTE] > > Write brand descriptions that clearly explain what your company does, who your customers are, and what makes you different. The more context you provide, the more accurate your analysis will be. ## How to use Brands **1. Create your first brand** Click **+ New Brand** and fill in your brand details. Include a thorough description that covers your industry, products, and target audience. **2. Configure the brand** After creating a brand, switch to it using the brand selector. Then set up [Monitored Prompts](/features/monitored-prompts) and [Competitors](/features/competitors) for that brand. **3. Add additional brands** For agencies or multi-product companies, repeat the process for each brand you want to track. **4. Switch between brands** Use the brand selector dropdown in the top navigation bar to switch between brands. The entire interface updates to show data for the selected brand. > [!TIP] > > If you manage brands across different countries, create separate brand entries for each market. AI model behavior and citations vary significantly by language and region. # Cited Sources Source: https://docs.firstanswer.ai/features/cited-sources Discover which websites and domains AI models reference when generating responses to your monitored prompts.  ## What are Cited Sources? Cited Sources reveals which websites AI models reference when answering your monitored prompts. When ChatGPT, Perplexity, Gemini, or other AI models generate a response, they often cite or link to specific web pages as sources. Understanding these sources is critical because **the content AI cites directly influences what it recommends**. If an AI model cites a page that mentions your competitor but not your brand, you are losing visibility at the source level. Cited Sources helps you identify these opportunities and take action. ## How it works Every time First Answer collects an AI response, it extracts all cited URLs and domains. These are aggregated and ranked by impact — a proprietary score that reflects how much influence each source has on your brand's visibility across AI responses. ## Domains and Pages tabs Cited Sources is split into two tabs that you can switch between freely, without reloading the data: * **Domains** — the default view. Each row is a website domain, aggregated and ranked by impact. * **Pages** — the individual cited URLs. By default it is filtered to the domain you drilled in from, but you can clear the domain filter to see every cited page across all domains, or use the **domain selector** to switch to a different domain without leaving the tab. The Pages tab presents its data differently depending on whether a domain filter is active: * **No domain filter (all domains)** — the table includes a **Domain** column so you can tell sources apart, and the URL column shows the page path.  Pages tab with no domain filter: every cited URL across all domains, with a Domain column. * **Filtered by a domain** — the **Domain** column drops away (every row shares the same domain) and the URL column expands to show the full address of each cited page.  Pages tab filtered by a single domain: the Domain column is gone and full URLs are shown. ## Understanding the table The Domains tab shows the following columns: | Column | Description | | - | - | | **Domain** | The website domain (e.g., reddit.com, linkedin.com, semrush.com) | | **Pages** | The number of unique pages from this domain that have been cited | | **Related Prompts** | How many of your monitored prompts have responses that cite this domain | | **Model** | Which AI models cite this source (shown as model icons) | | **Impact** | A percentage score reflecting the source's influence on AI responses to your prompts | ### Impact score The Impact score is one of the most valuable metrics in First Answer. It quantifies how much a specific domain influences AI-generated responses for your monitored prompts. A higher impact means: * The domain is cited more frequently * It appears across more prompts and models * Responses that cite this domain are more likely to shape AI opinions about your industry > [!NOTE] > > Reddit, LinkedIn, and YouTube are consistently among the most cited sources across AI models. Having your brand mentioned on these platforms can significantly boost your AI visibility. ## Filters You can refine the Cited Sources view with: * **Search by domain**: Find a specific domain quickly * **AI model**: Filter to see which sources a specific AI model cites * **Group**: Filter by prompt group to see sources relevant to specific topics * **Date range**: See how source citations change over time ## Key concepts ### Why cited sources matter AI models do not generate responses from nothing. They rely on training data and, increasingly, on real-time web content. When an AI model cites a source, it is signaling that it trusts that content to inform its answer. If you want to appear in AI responses, you need to be present in the sources that AI models trust. ### Domains vs. pages A domain like `reddit.com` may have hundreds of cited pages. There are two ways to reach them: * From the **Domains** tab, click a domain's page count to open the **Pages** tab pre-filtered to that domain. * Open the **Pages** tab directly, then use the **domain selector** to filter by any domain — or clear it to see every cited URL across all domains in one list. Because the domain selector lives on the Pages tab, you can switch the domain you are inspecting without going back to the Domains view. This level of detail helps you understand: * Which Reddit threads mention your competitors * Which blog posts on industry sites drive AI recommendations * Where you need to create or optimize content ### Filters persist as you navigate When you open a page's details, your filters travel with you: * The date range you set on Cited Sources carries into the page detail view, so you stay within the same time window. * When you go back — using your browser or the breadcrumb — your filters are preserved, so you don't lose your place or have to reapply them. ### Cross-model citations The Model column shows which AI platforms cite each source. Some sources are universally cited (appearing across all models), while others are model-specific. This helps you prioritize sources that influence the broadest set of AI models. ## How to use Cited Sources **1. Identify high-impact sources** Sort by Impact to find the domains that most influence AI responses for your prompts. Focus on the top 10-20 sources. **2. Check your brand presence** For each high-impact source, visit the cited pages and check if your brand is mentioned. If not, this is a visibility gap. **3. Create or contribute content** Get your brand mentioned on high-impact sources. This could mean writing guest posts, participating in Reddit discussions, publishing on LinkedIn, or creating content that these sources reference. **4. Monitor changes** Return to Cited Sources regularly to see if new sources emerge or if existing sources gain or lose influence. **5. Export for analysis** Click **Export CSV** to download the full list of cited sources for deeper analysis or sharing with your content team. > [!TIP] > > Focus on sources that are cited across multiple AI models (shown with multiple model icons). Getting your brand mentioned on these universally trusted sources gives you the broadest visibility boost. # Competitors Source: https://docs.firstanswer.ai/features/competitors Track and compare how competitor brands appear in AI-generated responses alongside your brand.  ## What is Competitor Monitoring? Competitor Monitoring lets you track how other brands appear in the same AI responses where your brand is (or should be) mentioned. By comparing your visibility, position, and sentiment against competitors, you can understand your relative standing in the AI landscape and identify strategic opportunities. When AI models answer questions about your industry, they often mention multiple brands. Knowing which competitors appear — and how often — gives you actionable intelligence for improving your own AI visibility. ## How it works When First Answer collects AI responses for your monitored prompts, it scans each response for mentions of your brand **and** all your tracked competitors. This means every data point you collect is also a data point for your competitive analysis. ## Filters The controls at the top of the page apply to every tab: * **AI model** — limit the analysis to a single model (for example only ChatGPT or only Gemini). * **Groups** — focus on a specific prompt group. * **Date range** — the time window for the data (defaults to **Last 30 days**). ## The three tabs Competitors is organized into three tabs: * **Visibility** — how your share of AI mentions trends over time and across models. * **Comparisons** — head-to-head breakdowns of your brand against each competitor. * **Manage** — add, edit, and curate the competitors and suggestions you track. ## Visibility The **Visibility** tab shows how much of the AI conversation your brand owns compared to your competitors. ### Visibility over time A line chart plots the visibility of your brand and each competitor over the selected period. Switch between **Daily**, **Weekly**, and **Monthly** granularity to spot trends and inflection points. ### Share of voice by AI model A stacked bar chart breaks down share of voice **per AI model** (ChatGPT, Perplexity, Bing Copilot, Google AIO, Gemini, Grok, and Google AI Mode). Each bar shows the percentage of mentions captured by your brand versus each competitor in that model, so you can see where you are strong and where a competitor dominates.  ## Comparisons The **Comparisons** tab shows a card for each competitor, comparing them head-to-head with your brand across the prompts you both appear in.  Each card summarizes: * **The share of shared prompts where your brand appears higher** than that competitor. * **How many prompts you share** (prompts where both brands are mentioned). * **Which topics each brand leads in**, with the leading percentage. ### Full analysis Click **View full analysis** on a card to open a detailed, prompt-by-prompt breakdown:  The modal shows: * The active **date range** and **AI model** filters. * A summary of how many shared prompts your brand **leads**, are **tied**, and the competitor **leads**. * A toggle to switch between **All** shared prompts and just your **Wins** (or **Losses**) so you can focus on where to defend or improve. * A table with each shared prompt and the visibility score for your brand, the competitor, and the **difference** between them. ## Manage The **Manage** tab is where you curate who you track. Use **+ Add competitor** at the top right to start tracking a new brand.  ### Monitored competitors The left panel lists the competitors you currently track. For each one you can see: * **Name** — the competitor brand name. * **Website** — the competitor's URL. * **Associated names** — alternative names or variations the AI might use for this competitor. * **Actions** — edit competitor details or remove them from tracking. #### Associated names AI models may reference a competitor using different names, abbreviations, or product names. Associated names ensure that all variations are captured and counted. For example, if you track "Microsoft," you might add associated names like "MS," "MSFT," or "Microsoft Corporation." ### Competitor suggestions The right panel shows **AI-powered suggestions** for competitors you might want to track, generated from brands that frequently appear in the same AI responses as your monitored prompts. Each suggestion shows the brand name and how many times it was mentioned across all your responses. Suggestions are split into two sub-tabs: * **Suggested** — new brands worth considering. Click the **+** button to start tracking one. * **Ignored** — brands you've dismissed. Use the **ignore** icon (the crossed-out eye) on any suggestion to move it here and keep your suggestions list focused. > [!NOTE] > > Competitor suggestions are dynamic — they update as you collect more data. A brand that appears frequently in your AI responses is likely a meaningful competitor in the AI visibility space, even if you don't consider them a traditional competitor. ## How to use Competitor Monitoring **1. Add your key competitors** On the **Manage** tab, click **+ Add competitor** to add brands you want to track. Start with your most direct competitors — the brands users would consider as alternatives to yours. **2. Configure associated names** After adding a competitor, click the edit icon to add associated names. This ensures all brand variations are captured in the analysis. **3. Curate your suggestions** Check the **Suggested** list regularly. Add brands that appear often in your AI responses, and **ignore** the ones that aren't real competitors to keep the list relevant. **4. Track your share of voice** Use the **Visibility** tab to watch how your share of AI mentions trends over time and across models. **5. Dig into head-to-head gaps** Open the **Comparisons** tab and **View full analysis** on a competitor to find the exact prompts where you trail, then prioritize content and optimization work there. > [!TIP] > > Don't limit yourself to traditional competitors. AI models may recommend brands from adjacent industries or emerging players you haven't considered. The suggestions panel is specifically designed to surface these non-obvious competitors. # Content Creation Source: https://docs.firstanswer.ai/features/content-creation Generate AI-optimized content directly from your monitored prompt data to improve your brand's visibility in AI responses.  ## What is Content Creation? > [!NOTE] > > Content Creation is currently in **Beta**. Features and functionality may change as we refine the experience. Content Creation helps you produce content that is specifically designed to improve your brand's visibility in AI-generated responses. Instead of guessing what to write, it uses data from your monitored prompts, cited sources, and competitor analysis to generate targeted content recommendations and drafts. The goal is simple: create content that AI models will cite and reference when answering questions relevant to your brand. ## How it works Content Creation analyzes your First Answer data to understand: * **What questions your audience asks** (from monitored prompts) * **What sources AI models trust** (from cited sources) * **Where your brand is missing** (from low-visibility prompts) * **What competitors are doing right** (from competitive analysis) Using these insights, it generates content that addresses the gaps in your AI visibility. ## Key concepts ### AI-optimized content Content that is "optimized for AI" differs from traditional SEO content in important ways: * **Answers questions directly**: AI models prefer content that clearly and concisely answers specific questions * **Includes structured data**: Well-organized content with headings, lists, and clear hierarchy is easier for AI models to parse * **Cites authoritative information**: Content that references credible data and sources is more likely to be trusted by AI models * **Covers topics comprehensively**: AI models prefer in-depth, thorough content over thin or superficial pages ### From prompt to content The connection between your monitored prompts and content creation is direct: 1. A monitored prompt shows 0% visibility for your brand 2. Content Creation analyzes what AI models currently cite for that prompt 3. It generates a content brief or draft that targets that specific question 4. You publish the content on your site or relevant platforms 5. Over time, AI models discover and cite your new content 6. Your visibility for that prompt improves ## How to use Content Creation **1. Identify content opportunities** Start by reviewing your [Monitored Prompts](/features/monitored-prompts) with the lowest visibility. These are the prompts where new content could have the biggest impact. **2. Create new content** Click **+ New content** and select a monitored prompt to base it on. The tool will analyze the prompt and generate a targeted content brief. **3. Review and customize** Review the generated content suggestion. Customize it to match your brand voice, add proprietary insights, and ensure accuracy. **4. Publish and monitor** Publish the content on your website or relevant platforms. Add the URL to [Monitored Pages](/features/monitored-pages) to track when AI models begin citing it. > [!TIP] > > Focus content creation efforts on prompts that are both low-visibility and high-value to your business. Not every zero-visibility prompt is worth creating content for — prioritize based on business relevance and search intent. # Crawler Logs Source: https://docs.firstanswer.ai/features/crawler-logs Monitor how AI crawlers access your website, track crawl frequency by model, and understand which pages AI models prioritize.  ## What are Crawler Logs? Crawler Logs tracks how AI model crawlers (bots) access and index your website. Just like search engine crawlers (Googlebot, Bingbot), AI models have their own crawlers that visit web pages to gather information. Understanding this crawl behavior is essential for optimizing your site's AI visibility. If AI crawlers are not visiting your key pages, AI models may not have up-to-date information about your brand — which directly impacts your visibility in AI-generated responses. ## How it works First Answer integrates with your website's server logs or analytics to detect visits from known AI crawlers. It then categorizes and visualizes this activity so you can understand: * How often each AI model crawls your site * Which pages they visit most frequently * How crawl patterns change over time ## Dashboard sections ### Crawls Over Time A time-series chart showing the total number of crawl events per day, week, or month. You can toggle between **Daily**, **Weekly**, and **Monthly** views. Each AI model is represented by a different color, making it easy to see which models are most actively crawling your site. ### Events by Crawler A breakdown of total crawl events by AI model. This shows: * **Crawler name**: The AI model's crawler (e.g., ChatGPT, Perplexity, Claude) * **Event count**: Total number of crawl events in the selected period * **Percentage**: The crawler's share of total crawl activity > [!NOTE] > > ChatGPT's crawler (GPTBot) is typically the most active, but crawl patterns vary by site. If a specific crawler is not visiting your site, check your `robots.txt` to ensure you are not blocking it. ### Traffic by Page Shows which pages on your site receive the most crawl traffic from AI bots. This reveals: * **Page URL**: The specific page being crawled * **Visit count**: How many times the page was crawled * **Percentage**: The page's share of total crawl visits ## Filters * **Date range**: Default is last 7 days, but you can adjust to see longer trends * **Models**: Filter by specific AI model crawlers ## Key concepts ### Why crawl frequency matters AI models can only include information from pages they have crawled. If a crawler hasn't visited your page recently, the AI model may not know about: * New products or services you've launched * Updated pricing or features * Recent blog posts or content Higher crawl frequency generally means the AI model has more up-to-date information about your brand. ### robots.txt and AI crawlers Your `robots.txt` file controls which crawlers can access your site. Some websites unintentionally block AI crawlers. Key AI crawler user agents include: | AI Model | User Agent | | - | - | | ChatGPT | GPTBot | | Google Gemini | Google-Extended | | Perplexity | PerplexityBot | | Claude | ClaudeBot | | Bing Copilot | Bingbot | > [!WARNING] > > Before making changes to your `robots.txt`, ensure you understand the implications. Allowing AI crawlers means your content may be used to train or inform AI model responses. ### Page prioritization AI crawlers don't visit all pages equally. They prioritize pages based on: * **Authority**: Pages with more inbound links get crawled more often * **Freshness**: Recently updated pages may be re-crawled sooner * **Sitemap inclusion**: Pages listed in your sitemap are easier for crawlers to discover * **Internal linking**: Well-linked pages get crawled more frequently ## How to use Crawler Logs **1. Verify AI crawlers can access your site** Check that your `robots.txt` does not block AI crawler user agents. If you see zero crawl events for a specific model, this is likely the issue. **2. Identify your most-crawled pages** Review the Traffic by Page section. Your most important pages (product pages, key landing pages) should be among the most frequently crawled. **3. Monitor crawl trends** Use the Crawls Over Time chart to spot changes in crawl behavior. A sudden drop may indicate a technical issue (blocked in robots.txt, server errors, or site downtime). **4. Optimize underperforming pages** If important pages are not being crawled, improve their discoverability through internal linking, sitemap inclusion, and fresh content updates. # Dashboard Source: https://docs.firstanswer.ai/features/dashboard Get a high-level overview of your brand's AI visibility, mentions, sentiment, and competitive positioning — all in one place.  ## What is the Dashboard? The Dashboard is your central command center for understanding how your brand appears across AI-generated responses. It aggregates data from all your monitored prompts and presents the most important metrics at a glance. Every time AI models like ChatGPT, Perplexity, Gemini, Google AI Mode, Bing Copilot, or Grok respond to a user's question, your brand may or may not appear in the answer. The Dashboard tracks this over time and gives you a clear picture of your brand's AI presence. ## Key metrics ### Total prompts The number of prompts you are actively monitoring across all AI models. Each prompt is a question or query that gets regularly executed against multiple AI platforms to check whether your brand appears in the responses. ### Competitors The total number of competitor brands you are tracking. Competitors are other brands whose visibility you want to compare against your own across AI responses. ### Mention Rate The percentage of AI responses that mention your brand out of all responses collected. This is one of the most critical metrics — it tells you how often AI models recommend or reference your brand when users ask relevant questions. > [!NOTE] > > A low mention rate does not necessarily mean poor performance. It depends on how broad or niche your monitored prompts are. Focus on improving mention rates for prompts that are most relevant to your business. ### Total responses The total number of individual AI-generated responses collected across all models and all monitored prompts. Since each prompt runs against multiple AI models, the total response count is typically much higher than the prompt count. ### Total mentions How many times your brand was specifically mentioned across all collected responses. A single response may mention your brand multiple times, but this counts distinct response-level mentions. ### Sentiment An aggregate sentiment score for how AI models talk about your brand. The score ranges from 0 to 100: * **0–40**: Negative — AI models tend to describe your brand unfavorably * **40–60**: Neutral — mentions are factual without strong positive or negative tone * **60–100**: Positive — AI models describe your brand favorably ## Best and lowest performing prompts The Dashboard highlights your **top 3 best performing** and **top 3 lowest performing** prompts based on visibility score. This helps you quickly identify: * **Best performing**: Prompts where your brand consistently appears in AI responses with high visibility. These represent your strengths. * **Lowest performing**: Prompts where your brand rarely or never appears. These are opportunities for improvement through content optimization, SEO for AI, or content creation. ## Competitive Positioning The bottom section of the Dashboard shows a competitive ranking table that compares your brand against all tracked competitors. For each brand, you can see: * **Visibility**: The percentage of responses where the brand appears * **Average position**: Where the brand typically appears in ranked lists within AI responses (lower is better) * **Sentiment**: How positively or negatively the AI talks about each brand > [!TIP] > > Use the competitive positioning table to identify which competitors outperform you in AI visibility. Then review their mentioned content to understand what drives their higher rankings. ## Filters You can refine the Dashboard view using: * **Date range**: Focus on a specific time period (default is last 30 days) * **Group**: Filter by prompt groups if you organize your prompts into categories * **AI model**: View data from a specific AI model only (e.g., ChatGPT, Perplexity, Gemini) ## How to use the Dashboard **1. Review your mention rate** Start by checking your overall mention rate. If it is below your target, navigate to the lowest performing prompts to understand where you are missing. **2. Check sentiment** A neutral or positive sentiment is healthy. If sentiment drops, investigate which prompts or responses are driving negative language about your brand. **3. Compare against competitors** Scroll to the Competitive Positioning section. Identify competitors with higher visibility and analyze what they are doing differently. **4. Drill into prompts** Click "View all" on either the best or lowest performing prompts section to navigate to the full [Monitored Prompts](/features/monitored-prompts) page for deeper analysis. # FAQ Source: https://docs.firstanswer.ai/features/faq Answers to common questions about using First Answer. ## How do I view my invoices? Your invoices are available in the **Plans and Billing** section of the **Settings** page.  **1. Open Settings** Click your name in the top-right corner, then select **Settings** from the dropdown menu. **2. Go to Plans and Billing** Scroll down to the **Plans and Billing** section. **3. Click View invoices** Click **View invoices**. You are redirected to a secure billing portal, hosted by our payment provider (Stripe), where you can see your invoice history and update your payment method. When you finish, use the link back to First Answer in the billing portal to return to the **Settings** page. > [!WARNING] > > If you can't see the **Plans and Billing** section or access your invoices, contact the First Answer team through the chat button in the bottom-right corner of the app, and we'll send you the invoices you need. # Monitored Pages Source: https://docs.firstanswer.ai/features/monitored-pages Track specific web pages to see how often they are cited by AI models in responses to your monitored prompts.  ## What are Monitored Pages? While [Cited Sources](/features/cited-sources) gives you a broad view of all domains cited by AI models, Monitored Pages lets you **zoom in on specific URLs** that matter to your brand. You can track individual pages — your own blog posts, landing pages, competitor content, or industry articles — and see exactly how often AI models cite them. This is especially useful when you publish content specifically designed to improve your AI visibility. By monitoring the page, you can measure whether AI models actually pick it up and cite it in their responses. ## How it works You add specific URLs to your monitoring list. First Answer then cross-references these URLs against all AI responses collected for your monitored prompts. When an AI model cites one of your monitored pages, it is recorded and tracked over time. ## Filters and search | Filter | Description | | - | - | | **Search by URL** | Find a specific page in your monitored list | | **Filter by domain** | View only pages from a specific domain | | **Sort** | Order by most citations, most recent, or alphabetically | | **Date range** | Filter citations to a specific time period | ## Key concepts ### Your pages vs. competitor pages You can monitor both your own pages and competitor pages: * **Your pages**: Track which of your content AI models cite. This helps you measure the effectiveness of your content strategy for AI visibility. * **Competitor pages**: Track competitor content that gets cited in AI responses to your prompts. Understanding what content AI models trust from competitors helps you create better content. ### Citation frequency Not all pages are cited equally. Some pages may be cited by multiple AI models for many prompts, while others are cited only occasionally. Citation frequency helps you identify your most influential content. ### Content lifecycle AI models refresh their sources over time. A page that was heavily cited last month may lose influence as newer content emerges. Monitoring pages over time helps you understand the lifecycle of your content's AI influence. ## How to use Monitored Pages **1. Add your key pages** Click **+ Add page** and enter URLs of pages you want to track. Start with your most important landing pages, product pages, and blog posts. **2. Add competitor content** From the [Cited Sources](/features/cited-sources) page, identify competitor pages that are frequently cited. Add them to your monitored pages to track their influence over time. **3. Measure content impact** After publishing new content aimed at improving AI visibility, add the URL to monitored pages and track how quickly and frequently AI models begin citing it. **4. Identify declining pages** Monitor for pages whose citation count drops over time. These may need content refreshes or updates to maintain their AI influence. > [!TIP] > > When you create new content targeting a specific monitored prompt, add the page URL to Monitored Pages immediately. This creates a direct measurement loop between your content efforts and AI citation results. # Monitored Prompts Source: https://docs.firstanswer.ai/features/monitored-prompts Track how your brand appears in AI-generated responses by monitoring specific questions and queries across multiple AI models.  ## What are Monitored Prompts? Monitored Prompts are the core of First Answer's tracking system. Each monitored prompt is a question or query — like *"What are the best CRM tools?"* or *"How do I improve my brand's AI visibility?"* — that First Answer periodically executes against multiple AI models to collect responses. By monitoring these prompts, you can see exactly when and how AI models mention your brand, track changes over time, and identify opportunities to improve your visibility. ## How it works 1. You add a prompt (a question your target audience might ask an AI) 2. First Answer runs that prompt against all supported AI models on a regular schedule 3. Each response is analyzed for brand mentions, position, and sentiment 4. Results are aggregated and displayed in the Monitored Prompts table ## Understanding the table columns | Column | Description | | - | - | | **Prompt** | The question or query being tracked | | **Responses** | Total number of AI-generated responses collected for this prompt | | **Mentions** | How many of those responses mention your brand | | **Visibility** | The percentage of responses that include your brand (mentions / responses) | | **Average Position** | Where your brand typically appears in the response (1 = first mentioned, higher = mentioned later) | | **Sentiment** | How positively or negatively AI models talk about your brand in responses to this prompt | | **Creation Date** | When you started monitoring this prompt | > [!NOTE] > > **Visibility vs. Mention Rate**: Visibility is calculated per prompt, while the Dashboard's mention rate is an aggregate across all prompts. A prompt with 5% visibility means your brand appears in 5% of all responses collected for that specific question. ## Key concepts ### Visibility score Visibility measures how frequently your brand appears when AI models answer a specific question. A visibility score of 10% means that in 1 out of every 10 responses, the AI includes your brand. Factors that influence visibility: * **Content quality**: AI models pull from web content. High-quality, authoritative content about your brand improves mentions. * **Source citations**: If AI models cite pages that mention your brand, you are more likely to appear. * **Prompt relevance**: Broad prompts (e.g., "best software tools") may yield lower visibility than niche ones (e.g., "best AI visibility monitoring tools"). ### Average position When AI models produce lists or rankings, your brand's position matters. Being mentioned first carries more weight than being listed last. Average position tracks where your brand typically falls in these rankings. * **1–3**: Strong position — your brand is among the first mentioned * **4–10**: Moderate — your brand appears but is not the top recommendation * **10+**: Weak — your brand is mentioned far down in the response ### Sentiment per prompt Each prompt has its own sentiment score that reflects how AI models describe your brand when answering that specific question. This helps you identify prompts where your brand might be mentioned but in a negative context. ## Filters and search You can narrow down your prompt list using: * **Date range**: Filter by time period to see how metrics have changed * **Group**: Filter by prompt group (if you organize prompts into categories) * **AI model**: View results from a specific AI platform only * **Search**: Search for specific prompts by keyword * **Sort**: Order prompts by any column to find top or bottom performers ## Prompt groups Organize your prompts into groups for easier management. Groups let you categorize prompts by topic, product line, market segment, or any other dimension that makes sense for your business. Click **View Groups** at the top of the page to manage your prompt groups. ## How to use Monitored Prompts **1. Add prompts your audience asks** Click **+ New Prompt** and enter questions your target audience might ask AI assistants. Think about questions related to your industry, product category, or brand. **2. Organize into groups** Group your prompts by category (e.g., "Product Comparisons," "Industry Questions," "Brand-Specific") for easier analysis. **3. Monitor visibility trends** Check back regularly to see how your visibility changes. Sort by visibility to quickly find your best and worst-performing prompts. **4. Investigate low-visibility prompts** For prompts where your brand does not appear, click into the prompt detail to see which competitors are mentioned instead. Use this insight to create content that targets those specific questions. **5. Export data** Click **Export CSV** to download your prompt data for further analysis or reporting. > [!TIP] > > Start with 10-20 prompts that are most relevant to your business. As you learn which types of questions drive the most valuable visibility, expand your prompt list strategically. # Generate Prompts with AI Source: https://docs.firstanswer.ai/features/monitored-prompts-create-ai Get AI-generated prompt suggestions based on your brand profile, pick the ones that make sense and add them to monitoring. ## What is generating prompts with AI? First Answer uses artificial intelligence to suggest prompts based on your brand profile. You pick the suggestion type, select the ones you want to track, and they're added to the list on the **New prompt** page. It's the fastest way to get started when you don't know yet which questions to monitor. > [!TIP] > > Already have your list of prompts? Use [Add prompts manually](/features/monitored-prompts-create-manual) or [spreadsheet import](/features/monitored-prompts-import). ## Suggestion types | Type | What it generates | When to use it | | - | - | - | | **Organic Prompts** | Natural, informative questions based on your brand's characteristics. | To understand how your audience searches for and discovers your brand in everyday queries. | | **Comparison Prompts** | Questions that place your brand in direct comparison with other options. | To track competitive contexts, when users evaluate alternatives before deciding. | | **Keyword-based Prompts** | Questions built from a keyword you define. | To explore a topic, a trend or a specific product in your market. | ## Step by step **1. Open the New prompt page** In the sidebar, click **Monitored Prompts**, then the **New Prompt** button in the top-right corner.  **2. Pick the suggestion type** Click **Generate prompts with AI** and choose **Organic Prompts**, **Comparison Prompts** or **Keyword-based Prompts**. For the last one, type the keyword and click **Generate prompts**. **3. Select the prompts** The AI shows a list of suggestions, each with its type badge (for example, **Organic**). Select the ones you want to monitor. The button shows how many you picked, like **Add 4 prompts**.  Want more options? Scroll to the end of the list and click **Generate more suggestions**. New suggestions don't repeat the ones already on the page. **4. Add them to the list** Click **Add N prompts**. The prompts are added to the list on the page with the **AI** badge and their type badge.  **5. Review and save** Use the pencil to adjust a prompt's text and the trash can to remove it. When the list is ready, click **Save Monitoring**. > [!NOTE] > > Nothing is saved until you click **Save Monitoring**. Once saved, the prompts appear in [Monitored Prompts](/features/monitored-prompts) and the first metrics arrive after the next collection. ## Plan limit You can only select suggestions while your plan has room. When you reach the limit, the remaining suggestions are disabled and the modal shows the **Don't miss out on monitoring more prompts!** notice, with a **See plans** button to upgrade. ## Tips * **Combine the types.** Generate organic prompts to cover brand discovery and comparison prompts to track competitors. * **Use keywords for niches.** A keyword like *"cloud storage"* generates questions focused on one product or topic. * **Edit before saving.** Suggestions are a starting point: tweak the text so it sounds like your audience. * **Mix with your own list.** You can generate with AI, add manually and import from a spreadsheet on the same page before saving. # Add Prompts Manually Source: https://docs.firstanswer.ai/features/monitored-prompts-create-manual Add monitored prompts by typing or pasting a list on the New prompt page, one prompt per line. ## What is adding prompts manually? It's the most direct way to add prompts: you type or paste the questions you want to track, one per line, and they're added to the list on the **New prompt** page. Use it when you already know exactly which prompts you want to monitor. > [!TIP] > > To add many prompts at once, already organized into groups, use [spreadsheet import](/features/monitored-prompts-import). To get ready-made suggestions, use [Generate prompts with AI](/features/monitored-prompts-create-ai). ## Step by step **1. Open the New prompt page** In the sidebar, click **Monitored Prompts**, then the **New Prompt** button in the top-right corner.  **2. Open the add modal** Click **Add prompts manually**. **3. Type or paste the prompts** In the **Prompts** field, write one prompt per line. You can also paste a whole list from another file. Blank lines are skipped.  **4. Add them to the list** Click **Add**. The prompts are added to the list on the page and the counter above it is updated.  **5. Review and save** Use the pencil to fix a prompt's text and the trash can to remove it. When the list is ready, click **Save Monitoring**. > [!NOTE] > > Nothing is saved until you click **Save Monitoring**. Once saved, the prompts appear in [Monitored Prompts](/features/monitored-prompts) and the first metrics arrive after the next collection. ## Plan limit The counter above the list shows how many prompts you've added and how many still fit in your plan, for example **(2/1988) Prompts**. * If you paste more prompts than your plan allows, only the ones that fit are added. * If you've already reached the limit, First Answer offers a plan upgrade before opening the modal. ## Tips for writing good prompts * **Write the way your audience asks.** Use full, natural questions, like *"What's the best search engine for academic research?"*, not just loose keywords. * **Vary the intent.** Mix discovery questions (*"what is"*), comparison questions (*"which is the best"*) and decision questions (*"is it worth it"*). * **Avoid repeating prompts.** Two nearly identical questions get similar answers and use up plan slots. * **Organize later.** Group prompts by topic in [Prompt Groups](/features/monitored-prompts-groups) to analyze visibility by subject. # Prompt Details Source: https://docs.firstanswer.ai/features/monitored-prompts-detail Dive deep into a single monitored prompt to analyze visibility trends, AI responses, cited sources, and search queries — all in one place.  ## What is the Prompt Details page? The Prompt Details page gives you a full breakdown of how a single monitored prompt performs across all AI models over time. While the [Monitored Prompts list](/features/monitored-prompts) gives you a high-level overview, this page lets you go deeper — investigating every response collected, every source cited, and every search query that AI models used when generating answers. Think of it as your investigation hub for one specific question: exactly when, how, and why your brand appears (or doesn't) in AI-generated answers. ## Key metrics ### Total Responses The total number of AI-generated responses collected for this prompt across all tracked models and collection cycles. Because each prompt runs against multiple AI models on a regular schedule, this number grows over time. ### Total Mentions How many of those collected responses specifically mentioned your brand. Combined with Total Responses, this gives you the raw data behind your Mention Rate. ### Mention Rate The percentage of responses that include your brand: ``` Mention Rate = (Total Mentions / Total Responses) × 100 ``` A 100% mention rate means your brand appears in every response this prompt generates — you own the answer for this question across all AI models. ### Sentiment How positively or negatively AI models describe your brand in responses to this specific prompt. Scores range from 0 to 100: * **60–100**: Positive / Very Positive * **40–60**: Neutral * **0–40**: Negative Prompt-level sentiment lets you identify questions where AI models portray your brand negatively even when they do mention you. ### Average Position When AI models list multiple brands or options in a response, your brand's position matters. Average Position tracks where your brand typically falls in those ranked lists: * **1**: First mentioned — highest authority signal * **2–3**: Strong presence * **4+**: Mentioned but not a top recommendation A trophy icon appears when your average position is 1, indicating you are the top-mentioned brand for this prompt. ## Next data collection The countdown below the prompt text shows when First Answer will next run this prompt against all AI models. Prompts are collected on a regular cadence so you always have fresh data. ## Tabs The detail page has four tabs that break down different angles of the data: | Tab | What it shows | | - | - | | **Overview** | Summary metrics, competitive positioning chart, and visibility trends over time | | **Responses** | The actual AI-generated text collected for this prompt, with your brand highlighted | | **Sources** | Web pages and domains that AI models cited when generating responses | | **Search Queries** | The web searches AI models performed as part of generating their answers | ### Overview tab The Overview tab includes the **Competitive Positioning** chart, which plots your brand's visibility or sentiment against any tracked competitors over time. Toggle between: * **Visibility**: How often each brand appears in responses * **Sentiment**: How positively each brand is described Use the **Daily / Weekly / Monthly** selector to smooth out the trend line and spot longer-term patterns. ### Responses tab See the raw AI outputs collected for this prompt. Each response shows which AI model produced it, the date it was collected, and whether your brand was mentioned. This is invaluable for understanding the exact language AI models use when describing your brand. ### Sources tab AI models like Perplexity and Google AI Mode cite web sources when answering questions. The Sources tab shows which URLs and domains were cited in responses to this prompt. Domains that consistently appear here have significant influence over what AI models say about this topic — and about your brand. ### Search Queries tab Some AI models perform live web searches before generating responses. The Search Queries tab reveals exactly what search terms these models used. This data helps you understand what content you need to rank for in order to influence the AI's answer. ## Action Plan The **Action Plan** button in the top-right corner takes you to a recommended action plan for improving this prompt's performance. First Answer analyzes the responses, sources, and your brand's positioning, then suggests concrete content and SEO actions to increase your visibility. ## How to use the Prompt Details page **1. Check your Mention Rate and Position** Start with the summary metrics. A high mention rate with a low position means you're being mentioned but not as the top recommendation — work on authority signals for this topic. **2. Review the Competitive Positioning chart** Toggle between Visibility and Sentiment to understand how your brand compares. If a competitor has higher visibility, switch to the Sources tab to see what content they're getting cited from. **3. Read actual Responses** Click the Responses tab and read how AI models describe your brand. If the language is neutral or negative, note the specific phrasing — that's what you need to counter with better content. **4. Investigate cited Sources** Go to the Sources tab. If high-authority domains are frequently cited but your brand isn't on those pages, that's a clear content gap. Contribute to or appear on those sources. **5. Analyze Search Queries** Use the Search Queries tab to find the exact terms AI models search when answering this prompt. These are keywords you should target in your content strategy. **6. Take action** Click Action Plan to get specific, AI-generated recommendations for improving your performance on this prompt. > [!TIP] > > Prompts with 0% mention rate are the highest-priority opportunities. Use the Sources and Search Queries tabs to understand what content you need to create to start appearing in AI answers. # Prompt Groups Source: https://docs.firstanswer.ai/features/monitored-prompts-groups Organize your monitored prompts into logical groups to analyze performance by topic, product line, market segment, or any other category that matters to your business.  ## What are Prompt Groups? Prompt Groups let you organize your monitored prompts into meaningful categories. Instead of managing all your prompts as a flat list, you can cluster them by topic, product area, competitor context, buyer persona, or any other dimension relevant to your strategy. Once grouped, you can analyze aggregate performance per group — understanding not just how individual prompts perform, but how entire topic areas perform together. ## Why groups matter As your prompt library grows, groups become essential for making sense of your data: * **Topic analysis**: Are prompts about your pricing performing differently than prompts about your features? * **Market segmentation**: How does your visibility differ across enterprise vs. SMB-related questions? * **Campaign tracking**: Group prompts related to a product launch to measure AI visibility before and after. * **Team workflows**: Different team members can focus on different groups without getting lost in the full prompt list. ## Understanding the Groups table | Column | Description | | - | - | | **Name** | The group name you assigned when creating it | | **Total Prompts** | How many prompts belong to this group, shown as a badge with a drill-down arrow | | **Responses** | Total AI responses collected across all prompts in this group | | **Mentions** | Total brand mentions across all responses in this group | | **Group Visibility** | Aggregated visibility percentage for the group — the share of all responses in which your brand was mentioned | ### Group Visibility bar The Group Visibility column shows both a percentage and a progress bar for visual comparison across groups. A group with 0% visibility means no responses in that group mention your brand at all — a clear signal that this topic area needs attention. ## Filters * **Filter date**: Scope the metrics to a specific time period * **Search group**: Find a group by name when you have many * **All models**: Filter group metrics to a specific AI model only ## How to use Prompt Groups **1. Go to the Prompt Groups tab** On the [Monitored Prompts](/features/monitored-prompts) page, click **Prompt Groups** at the top of the page to switch from the prompt list to the groups view. **2. Review group-level visibility** Scan the Group Visibility column to quickly identify which topic areas have the strongest and weakest AI presence for your brand. **3. Drill into a group** Click the prompt count badge (e.g., **5 →**) next to a group to see all prompts belonging to it, filtered by that group. **4. Create a new group** Click **+ New Group** to open the [Create Group](/features/monitored-prompts-groups-create) form and organize more prompts. **5. Manage an existing group** Click the **⋯** (three dots) menu on any group row to rename or delete the group. ## Key concepts ### Aggregate vs. individual visibility Group Visibility is an aggregate — it reflects performance across all prompts in the group combined. A group might have high visibility because a few prompts perform exceptionally well, even if many prompts in that group have 0% visibility. Always drill into the individual prompt list to understand the distribution. ### Groups and filters interact When you select a group in the **Select group** filter on the main Prompts tab, the prompt list automatically filters to show only prompts in that group. This makes groups useful not just for aggregate reporting, but also for day-to-day triage. > [!TIP] > > Start with 3–5 broad groups aligned to your main business topics. Refine and add sub-groups as you learn which prompt categories matter most for your brand's AI strategy. # Create a Prompt Group Source: https://docs.firstanswer.ai/features/monitored-prompts-groups-create Learn how to create a new prompt group to organize your monitored prompts by topic, product, or any category that helps you analyze AI visibility more effectively.  ## What is the Create Group form? The Create Group form lets you build a new prompt group by giving it a name and selecting which monitored prompts belong to it. Groups help you organize your prompt library into logical categories so you can analyze visibility, mentions, and sentiment at a topic level — not just per individual prompt. ## Form structure The form is divided into two panels: ### Left panel — Group This is where your group takes shape. It starts empty ("No prompts added") and fills as you add prompts from the right panel. The header shows **Added prompts: N** so you always know how many prompts are in the group before saving. ### Right panel — All prompts A list of all your existing monitored prompts. Each prompt has a **+** button on the right to add it to the group. Use the **Search prompt** field at the top to quickly find a specific prompt when you have a large library. ## How to create a group **1. Open the New Group form** From the [Monitored Prompts](/features/monitored-prompts) page, click **+ New Group** in the top-right corner. You can also reach this page directly from the [Prompt Groups](/features/monitored-prompts-groups) tab. **2. Enter a group name** Type a descriptive name in the **Group name** field. Use names that reflect the category, topic, or purpose — for example: *"Product Comparisons"*, *"Brand Awareness"*, *"Competitor Questions"*, or *"IELTS Preparation"*. **3. Add prompts to the group** Browse the **All prompts** panel on the right. Click the **+** button next to each prompt you want to include. The prompt moves to the left panel as it's added. Use the search bar to find specific prompts by keyword. **4. Review your selection** Check the left panel to confirm the right prompts are in the group. The **Added prompts** count in the header should match your expectations. **5. Create the group** Click **Create group** to save. You will be taken back to the [Prompt Groups](/features/monitored-prompts-groups) list where your new group appears with aggregated metrics. > [!NOTE] > > You must add at least one prompt before you can create a group. The **Create group** button is disabled if the group is empty. ## Best practices for naming groups Good group names make it easier to navigate your prompt library and communicate insights to teammates: | Pattern | Examples | | - | - | | **By topic** | "Language Learning", "IELTS Prep", "English Courses" | | **By intent** | "Brand Comparisons", "Feature Questions", "Pricing Queries" | | **By audience** | "Enterprise Buyers", "Brazilians Abroad", "Students" | | **By campaign** | "Q2 Launch", "Product Update", "Back to School" | ## Key concept: group taxonomy Think of your groups as a lightweight taxonomy for your AI visibility strategy. A well-designed taxonomy lets you answer questions like: * "Which topic categories drive the most AI mentions?" * "Where are my biggest gaps — are they in product questions or brand awareness queries?" * "How has visibility evolved across different topic areas over time?" Once groups are created, you can filter the main prompts view by group, compare groups in the Prompt Groups table, and use group-level data to prioritize your content and SEO efforts. > [!TIP] > > Group prompts that share a common improvement strategy together. If a set of prompts all target the same buyer persona or product area, grouping them lets you track the impact of your content changes on that entire category at once. # Import Prompts from a Spreadsheet Source: https://docs.firstanswer.ai/features/monitored-prompts-import Add many prompts at once using the First Answer template spreadsheet. Organize prompts into existing groups and create new groups right in the spreadsheet. ## What is spreadsheet import? Spreadsheet import lets you add many monitored prompts at once. You download your brand's template spreadsheet, fill in one prompt per row, mark the groups for each prompt, and upload the file back. It's the fastest way to: * Add dozens or thousands of prompts without typing them one by one. * Put each prompt in one or more [prompt groups](/features/monitored-prompts-groups). * Create new groups while you build the list. > [!NOTE] > > The import only **creates new prompts**. It doesn't change or delete the prompts you already monitor. ## Step by step **1. Open the New prompt page** In the sidebar, click **Monitored Prompts**, then the **New Prompt** button in the top-right corner. On the "New prompt" page, click **Import prompts from a spreadsheet**.  **2. Download the template** In the modal, click **Download template (.xlsx)**. The spreadsheet already has one column for each group your brand has today.  **3. Fill in the spreadsheet** Write one prompt per row in the `prompt` column and mark **YES** on the columns of the groups it belongs to. See [How to fill in the spreadsheet](#how-to-fill-in-the-spreadsheet) for details. **4. Upload the file** Go back to the modal and click **Select file**. First Answer reads the spreadsheet right away and shows how many prompts and groups it found, or what needs fixing. **5. Import the prompts** Click **Import N prompts**. The prompts are added to the list on the page with the **Spreadsheet** badge and their groups already selected. **6. Review and save** Check the list, adjust the text or groups of any prompt, and click **Save Monitoring**. Only then are the prompts saved and start being monitored. ## How to fill in the spreadsheet The template always has the same structure:  | Row | What it has | What you do | | - | - | - | | **1** | Colored bands: **PROMPTS**, **GROUPS** (groups that already exist) and **NEW GROUPS** (where you create groups) | Nothing. This row is just guidance. | | **2** | Headers: `prompt` and the name of each group | Only edit it to [create a new group](#create-a-new-group-from-the-spreadsheet). | | **3 onward** | Blank rows | One prompt per row. | ### Write the prompts In the `prompt` column, write one prompt per row, the way a user would ask an AI. For example: *"Where can I take a pottery class in São Paulo?"*. Fully blank rows are skipped, so you don't need to delete the leftover rows from the template. ### Mark the groups of each prompt Each group has its own column. To put a prompt in a group, click the cell in that group's column and pick **YES** from the list. Leave the cell empty when the prompt doesn't belong to the group. * A prompt can be in **several groups**: mark YES on as many columns as you want. * A prompt can have **no group**: leave all group columns empty. * Besides YES, the spreadsheet also accepts `SIM`, `x` and `1`. This helps when you paste data from another spreadsheet. Example for a brand with the groups **Single classes** and **Workshops**: | | A · prompt | B · Single classes | C · Workshops | | - | - | - | - | | **3** | How much does a single pottery class cost? | YES | | | **4** | Weekend pottery wheel workshop | | YES | | **5** | Pottery class with a workshop included | YES | YES | | **6** | Pottery studios near me | | | ## Create a new group from the spreadsheet You don't need to create the group in First Answer first. After the existing group columns, the spreadsheet has free columns under the blue **NEW GROUPS** band. **1. Write the group name** Click the header (row 2) of a column under **NEW GROUPS** and type the group name. For example: *Beginners*. When you select the cell, Excel shows a help balloon. **2. Mark the group's prompts** On the rows of the prompts that belong to the group, pick **YES** in that column. **3. Import as usual** When you upload the file, the modal shows **New groups will be created: Beginners (2 prompts)**. The group is created when you click **Import**. Example, with the new group **Beginners** in column D: | | A · prompt | B · Single classes | C · Workshops | D · Beginners | | - | - | - | - | - | | **3** | Pottery class for beginners near me | | | YES | | **4** | First pottery wheel class | YES | | YES | | **5** | Weekend pottery wheel workshop | | YES | | In this example, the **Beginners** group is created with the prompts on rows 3 and 4, and row 4 also goes into **Single classes**. ### Need more groups? The **NEW GROUPS** columns are just a starting point. To create more groups, type the name in row 2 of the column right after them, marked by the note *"More groups? Type the name right below ↓"*, or in the columns after that. Any column with a name becomes a group. ### New group rules | Situation | What happens | | - | - | | The name matches an existing group (even with different capitalization, like "workshops") | The existing group is used. No duplicate group is created. | | Two columns with the same name | They become a single group. | | A column with a name but no YES | It's ignored. No empty group is created. | | A column with YES but no name in the header | The spreadsheet is rejected and the modal points to the column. Type the name or clear the marks. | | A name longer than 255 characters | The spreadsheet is rejected and the modal points to the column. | > [!WARNING] > > New groups are created when you click **Import**, before you save. If you leave the page without saving the prompts, those groups still exist, only empty. You can delete them in [Prompt Groups](/features/monitored-prompts-groups). ## Can I change the spreadsheet? Yes. The spreadsheet is read by each column's **name**, not by its position. You can: * **Reorder the columns**: prompts still go to the right groups. * **Delete the column of a group** you won't use: prompts just don't go into that group. * **Use a spreadsheet downloaded earlier**: if someone created a group after the download, the spreadsheet still works. The new group just isn't in it. What you **can't** do is rename or delete the `prompt` column. Without it, the spreadsheet is rejected. > [!TIP] > > First Answer only reads the **first sheet** of the spreadsheet. If you use other sheets for drafts or notes, always keep the prompts in the first one. ## Fill in the spreadsheet with help from an AI Already have your prompts in another file, a list or loose notes? You can ask an AI, like Claude or ChatGPT, to move everything into the template format. **1. Download the template** Click **Download template (.xlsx)** in the import modal. This way the AI gets the right columns, with the groups your brand already has. **2. Send the template and your prompts to the AI** Attach the template and the file with your prompts, or paste the list into the chat. **3. Ask the AI to fill in the spreadsheet** Explain what you want and ask for an `.xlsx` file back. See an example request below. **4. Review and import** Open the file the AI returned, check the prompts and groups, and upload it through the modal as usual.  Example request: ```text theme={null} I attached the First Answer template spreadsheet and a file with my prompts. Fill in the template with these prompts and return an .xlsx file: - One prompt per row in the "prompt" column, starting at row 3. - For each prompt, write YES in the column of each group it belongs to. A prompt can be in more than one group. - If a group doesn't exist yet, write its name in row 2 of an empty column under the NEW GROUPS band and mark YES on the rows of its prompts. - Don't rename or delete the "prompt" column and don't change row 1. - Remove duplicate prompts. - Keep the prompts in the first sheet and save as .xlsx. ``` > [!TIP] > > You can also ask the AI to suggest new prompts or to split the list into groups by topic, intent or product. It's a quick way to build a complete list from a few examples. > [!WARNING] > > The AI can make mistakes: move a prompt to the wrong group, change its text or rename columns. Review the file before importing. The modal also checks the spreadsheet and shows what's wrong. Also keep in mind that you'll be sharing your brand's prompts and group names with the AI tool. Follow your company's rules for using these tools. ## Limits | Limit | Value | | - | - | | Format | `.xlsx` only (the template) | | File size | Up to 5 MB | | Prompts per spreadsheet | Up to 3,000 | | Length of each prompt | Up to 1,000 characters | | Total prompts | Your plan's limit. If the spreadsheet has more prompts than you can still add, the modal shows how many rows to remove. | Need to import more than that? Split the prompts into more than one spreadsheet and import them one at a time. ## Skipped rows Some rows don't block the import but are left out. When this happens, the modal shows a yellow warning, for example **22 prompts ready · 2 rows will be skipped**. Click **Show details** to see each row and the reason: | Reason | What to do | | - | - | | **Duplicate prompt in the spreadsheet** (same as another row) | Nothing. The first occurrence is imported and the repeats are skipped. | | **The prompt is already in your list** | Nothing. It's already on the New prompt page, so it isn't added again. | | **Empty prompt** | Write the prompt or clear the row's marks. | | **Prompt longer than 1,000 characters** | Shorten the prompt. | You can import the ready rows anyway, or fix the spreadsheet and upload it again with **Change file**. ## Error messages When the file can't be used, the field turns red and the **Import** button is disabled. Fix the spreadsheet and upload it again. > **Unsupported format** > > The file isn't `.xlsx`. Use the template. If you edited it in Google Sheets, download it with **File > Download > Microsoft Excel (.xlsx)**. > **The file is over the 5 MB limit** > > Split the prompts into more than one spreadsheet. > **The columns don't match the template** > > The `prompt` column wasn't found. Download the template again and don't rename the `prompt` column. > **We couldn't read the file** > > The file is corrupted or password-protected. Open the spreadsheet, remove the password, save it as `.xlsx` and upload it again. > **The spreadsheet has no prompts filled in** > > No row from row 3 onward has a prompt. Fill in the `prompt` column and upload it again. > **The spreadsheet has more than 3,000 prompts** > > Split the prompts into more than one spreadsheet. > **The spreadsheet has more prompts than you can add** > > Your plan doesn't have room for all the prompts. Remove the rows shown in the modal or upgrade your plan. > **The column has marks but no group name** > > A column has YES on its rows, but its header (row 2) is empty. Type the group name in the header or clear the marks. > **The group name is longer than 255 characters** > > Shorten the group name in the header of the column shown. > **We couldn't import the prompts** > > There was a connection problem. The file is still selected: click **Try again**. ## After importing Imported prompts are added to the list on the **New prompt** page, together with the ones you added manually or with AI: * Each prompt shows its origin badge: **Manual**, **AI** or **Spreadsheet**. * The groups marked in the spreadsheet appear in each row's group selector. You can select, clear or create groups right there before saving. * Nothing is saved until you click **Save Monitoring**. If you try to leave the page before that, First Answer warns you that the prompts will be lost. Once saved, the prompts appear in [Monitored Prompts](/features/monitored-prompts) and the first metrics arrive after the next collection. ## FAQ > **Can I use Google Sheets, Numbers or LibreOffice?** > > Yes. Open the template in the app you prefer and, when you're done, save or download it as `.xlsx`. Some apps don't show the options list or the help balloon on the columns. In that case, type **YES** directly in the cell. > **Can I write prompts and group names in other languages?** > > Yes. The spreadsheet's titles are always in English, but prompts and group names can be in any language. > **Does the import change the prompts I already monitor?** > > No. It only creates new prompts. To change the groups of prompts you already monitor, use the [Prompt Groups](/features/monitored-prompts-groups) page. > **Can I put an already monitored prompt in a new group from the spreadsheet?** > > No. The spreadsheet only handles the prompts you're adding now. For prompts you already monitor, edit the group in [Prompt Groups](/features/monitored-prompts-groups). # Workspaces Source: https://docs.firstanswer.ai/features/workspaces Organize your team's AI visibility monitoring in a shared environment. Invite members, manage access, and switch between workspaces — all from one place. ## What is a Workspace? A Workspace is your team's shared home inside First Answer. Every brand you monitor, every prompt you track, and every analysis you run lives inside a workspace — and everyone you invite to that workspace can access all of it together. When you create your First Answer account, a personal workspace is created for you automatically. You can rename it, invite teammates, and manage access from the Workspace settings page.  ## Switching workspaces If you belong to more than one workspace — either as the owner or as a member invited by someone else — you can switch between them using the workspace selector in the top navigation bar.  Click the workspace name in the top-left header. A dropdown appears listing all your workspaces, each labeled with your role: **Owner** or **Member**. Click any workspace to switch to it instantly. > [!NOTE] > > Each workspace is fully independent. Brands, monitored prompts, analyses, and members are not shared across workspaces. ## Roles Every workspace has three role types: | Role | What they can do | | - | - | | **Owner** | Everything an Admin can do, plus promote and demote Admins, remove Admins, and access billing | | **Admin** | Invite members, remove regular members, manage pending invites, rename the workspace, and view the activity log. Admins don't have access to billing | | **Member** | View and use all brands, prompts, and analyses within the workspace | There is always exactly one owner per workspace. Ownership cannot be transferred, and the owner can't leave the workspace. Admins are created by promotion: the owner turns an existing member into an Admin (see [Changing a member's role](#changing-a-members-role)). An Admin counts toward the seat limit just like a member, and can leave the workspace at any time. ## Accessing Workspace settings To open the Workspace settings page, click your name in the top-right corner. A dropdown menu appears — select **Workspace**. This option is only available to the owner and Admins of the selected workspace.  This takes you to the **Workspace settings page**, where you can see all current members, manage pending invites, and invite new teammates. ## Inviting members The owner and Admins can send invitations. To invite a teammate: **1. Open Workspace settings** Click your name in the top-right corner, then select **Workspace** from the dropdown menu. **2. Click Invite member** On the Workspace page, click the **Invite member** button in the top-right corner. **3. Enter the email address** Type the teammate's email address into the **Email** field and click **Send invitation**.  First Answer handles two scenarios automatically: **If the email already has a First Answer account** — the person is added as a member immediately and receives an email notification. **If the email is not yet registered** — an invite link is sent to that address. The link is valid for **7 days**. When they sign up, they are automatically added to your workspace. In both cases, the person joins as a **Member**. To give them Admin permissions, the owner promotes them afterwards. > [!NOTE] > > Invite links are tied to the email address they were sent to. Forwarding the link to a different email will not work — the recipient must sign up with the exact email address the invite was sent to. ## Seat limits The number of people you can have in your workspace depends on your plan. The seat count includes: * Active Members and Admins (the owner does not count toward the seat limit) * Pending invitations that have not yet expired The Workspace settings page shows how many seats are still available (for example, **1 of 2 invites available**). If you have reached your plan's limit, upgrade your plan or remove an existing member before sending new invites. ## Managing members From the Workspace settings page, the owner and Admins can manage the member list: * **View member details** — each row shows the member's name, email, role badge, join date, and date of last activity * **Remove a member** — click the **···** menu next to a member and select **Remove member**. Their access is revoked immediately. The owner can remove Members and Admins; Admins can only remove regular Members Removed members lose access to the workspace right away. Their data — brands, analyses, and results — stays in the workspace and is not deleted. ### Changing a member's role Only the owner can change roles. Click the **···** menu next to a member and select: * **Make admin** — promotes a Member to Admin * **Revert to member** — turns an Admin back into a regular Member The change takes effect immediately. ## Managing pending invites Invitations that have been sent but not yet accepted appear in the **Pending Invites** section of the Workspace settings page. From there, the owner and Admins can: * **Resend** — generates a fresh invite link and sends a new email. Also resets the 7-day expiry timer * **Revoke** — cancels the invite so the existing link stops working ## Activity log The activity log shows who changed what inside the workspace, and when. Use it to follow changes made by your team and as evidence for internal or customer audits. ### Who has access Only the workspace **Owner** and **Admins** can see the activity log. Regular members don't see the section and can't query the records, and this is enforced on the server, not only in the interface. Each record belongs to a single workspace. You only see the activity of the currently selected workspace, never that of other workspaces. ### How to access it **1. Open Workspace settings** Click your name in the top-right corner and select **Workspace** from the dropdown menu. **2. Open the log** At the bottom of the page, on the **Activity log** card, click **View log**. The list shows the most recent activity first, with the **Date**, **User**, **Action**, and **Item** columns. When the change is on something tied to a brand, the brand name appears next to the item. You can narrow the list with the **Item type**, **Action**, **User**, and **Period** filters, and go back to the full list with **Clear filters**. ### What is recorded A record is created whenever someone in the workspace makes a change through the platform, for example: * **Brands**: creation, editing, deletion, onboarding completion, and regeneration * **Competitors**: monitored competitors (creation, editing, deletion, assignment) and ignored detected competitors * **Prompts**: creation and deletion of monitored prompts, prompt groups, and assigning prompts to groups * **Monitored URLs**: creation and deletion * **Recommended actions and content**: status changes, content creation and editing, feedback, and version restores * **Workspace and team**: renaming the workspace, invites (sending, resending, revoking), role changes, members being removed or leaving * **Integrations**: linking and unlinking Google Search Console properties, and assigning AI Analytics and Crawler Logs projects Each record stores: * **Who** made the change (user and email) * **When** it was made (date and time) * **What** was done (created, updated, deleted, or a specific action such as archiving or resending an invite) * **Which item** (item type and name, and the brand when there is one) * **What changed**, for edits: the previous and new value of each changed field For security purposes, the IP address and browser used are also recorded. This information is not shown in the interface and is only available to the First Answer team for internal investigation. ### What is not recorded * **Views**: opening pages, browsing dashboards, or exporting data doesn't create a record. Only changes are recorded. * **Automatic processes**: data collection and analyses that the platform runs in the background don't appear in the log. * **Sensitive data**: passwords, access tokens, and API keys are never stored. For API keys, only the name and prefix are recorded. Long text, such as the body of a piece of content, isn't copied into the log either; only the fact that it changed is recorded. ### Integrity and retention Records can't be edited or deleted, not by the Owner and not by the First Answer team through the platform. If a user leaves the workspace or has their account deleted, their records remain available, with the email they used at the time. Records are currently kept indefinitely. ## Renaming your workspace The owner and Admins can rename the workspace at any time. On the Workspace settings page, click the pencil icon next to the workspace name, type the new name, and save. Names must be between 3 and 60 characters. > [!TIP] > > Your plan limits and billing are tied to the workspace you own — not to workspaces you belong to as a member. If you are a member of multiple workspaces, only your own workspace counts toward your subscription. # Introduction Source: https://docs.firstanswer.ai/mcp/introduction Connect AI assistants to your First Answer data via the Model Context Protocol (MCP). ## What is the First Answer MCP? The First Answer MCP server enables AI assistants like **Claude**, **Cursor**, and other MCP-compatible clients to query your First Answer data directly. Instead of switching between tools, you can ask your AI assistant questions about your brand's AI visibility and get answers powered by real data. With the MCP server, your AI assistant can: * **Query brand visibility** across ChatGPT, Perplexity, Gemini, Google AI Mode, Bing Copilot, and Grok * **Analyze citation sources** that AI models reference in their responses * **Track competitors** and compare visibility across AI platforms * **Explore monitored prompts** and their responses over time * **Access dashboard metrics** for quick brand overviews For a full list of tool names and how they fit together, see [MCP tools](/mcp/tools). ## Getting Started In Claude, you connect by signing in with your First Answer account. No API key needed. Other MCP clients (Cursor, Claude Code, scripts) authenticate with an API key instead. **1. Connect your MCP client** Choose your preferred AI assistant and follow the setup instructions below. > [!NOTE] > > Setting up a client other than Claude? Create an API key in your [account settings](https://app.firstanswer.ai/settings/api-keys) first and copy it immediately, it won't be shown again. Treat it like a password: never expose it in client-side code or public repositories. > **Claude (Desktop and Web)** > > 1. Open **Settings → Connectors** in Claude. > > 2. Look for **First Answer** in the connectors directory. If it isn't listed, click **Add custom connector** and fill in: > > | Field | Value | > | - | - | > | Name | First Answer | > | Remote MCP server URL | `https://mcp.firstanswer.ai` | > > 3. Click **Connect**. Claude opens the First Answer sign-in page in your browser. > > 4. Sign in with your First Answer email and password, then click **Allow** on the consent screen. > > You're redirected back to Claude and the connector is ready to use. Every First Answer tool is read-only. > **Cursor** > > Add the following to your `.cursor/mcp.json` file: > > ```json theme={null} > { > "mcpServers": { > "firstanswer": { > "url": "https://mcp.firstanswer.ai", > "headers": { > "Authorization": "Bearer YOUR_API_KEY" > } > } > } > } > ``` > **Claude Code** > > Run the following command in your terminal: > > ```bash theme={null} > claude mcp add --transport http firstanswer \ > https://mcp.firstanswer.ai \ > --header "Authorization: Bearer YOUR_API_KEY" > ``` > > Verify the connection: > > ```bash theme={null} > claude mcp list > ``` > **Claude Desktop (config file)** > > Prefer editing JSON directly instead of the Connectors UI above? Add the following to your Claude Desktop configuration file. > > **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` > > **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` > > ```json theme={null} > { > "mcpServers": { > "firstanswer": { > "command": "npx", > "args": [ > "mcp-remote", > "https://mcp.firstanswer.ai", > "--header", > "Authorization: Bearer YOUR_API_KEY" > ] > } > } > } > ``` > **Other MCP clients** > > Use the following remote server URL with your MCP client: > > ```text theme={null} > https://mcp.firstanswer.ai > ``` > > Include the `Authorization` header with your API key: > > ```text theme={null} > Authorization: Bearer YOUR_API_KEY > ``` > > Refer to your MCP client's documentation for specific configuration instructions. **2. Start using it** Once connected, try asking your AI assistant questions like: * *"What is my brand's visibility score this month?"* * *"Which AI models mention my brand the most?"* * *"What are the top cited sources for my monitored prompts?"* * *"How does my brand compare to competitors on Perplexity?"* * *"Show me the prompts where my brand is not being mentioned."* * *"Generate a full weekly report for `BRAND NAME` from 2026-03-20 to 2026-03-27, including the overall dashboard, ranking vs competitors, top 5 best and worst prompts, performance by AI model (ChatGPT, Gemini, Perplexity), and the main cited sources."* * *"Which prompts had the most and fewest mentions of my brand last week?"* * *"Compare `BRAND NAME` visibility on ChatGPT vs Gemini vs Perplexity over the last week."* ## Need higher limits? MCP requests use the same backend as the First Answer API, so your project’s [rate limits](/api-reference/rate-limits) apply. If you often hit those limits or need a higher quota for your assistants and automations, [contact our team](mailto:support@firstanswer.ai) to discuss Enterprise plans with custom limits. ## Support If you have questions or run into issues, reach out to our support team at [support@firstanswer.ai](mailto:support@firstanswer.ai) or visit [firstanswer.ai](https://firstanswer.ai). # MCP tools Source: https://docs.firstanswer.ai/mcp/tools Reference for all 16 tools exposed by the First Answer MCP server to analyze brand AI visibility. The First Answer MCP server exposes **16 read-only tools** your assistant can call to explore brands, prompts, competitors, and cited sources. Use this page as a map of what each tool does and how tools fit together. > [!NOTE] > > **Start here:** call `list_brands` first to obtain `brand_id` values. Almost every other tool requires a `brand_id`. ## Brands | Tool | What it does | | - | - | | `list_brands` | Lists brands in your workspaces (paginated). **Entry point** — use returned `id` as `brand_id` everywhere else. | | `get_brand` | Returns full detail for one brand (description, features, website, country, language). | ## Groups | Tool | What it does | | - | - | | `list_groups` | Lists prompt **groups** (categories) for a brand. Use `group_id` from results to filter `get_dashboard`, `list_monitored_prompts`, and `list_cited_sources`. | ## Dashboard | Tool | What it does | | - | - | | `get_dashboard` | Aggregated metrics for a date range: prompt counts, mention rates, sentiment, competitor count, **brands\_ranking**, top and lowest performing prompts. Optional filters: `group_id`, `ai_model`. | ## Monitored prompts | Tool | What it does | | - | - | | `list_monitored_prompts` | Lists monitored prompts with summary stats (mentions, mention rate, sentiment, positions). Requires `brand_id`, `start_date`, `end_date`. | | `get_monitored_prompt` | Deep dive on **one** prompt: metrics plus **daily** time series for your brand vs competitors. | | `get_monitored_prompt_responses` | Full **text** of AI responses (markdown/plain), mentions, sentiment, citations, and search queries per response. | | `get_monitored_prompt_citations` | Domains and URLs cited **for that prompt only**. | | `get_monitored_prompt_search_queries` | Search queries the AI ran while answering that prompt. | ## Competitors | Tool | What it does | | - | - | | `list_monitored_competitors` | Lists competitors tracked with the brand (ids, names, descriptions). | | `get_monitored_competitor` | Detail for one competitor (`monitored_competitor_id`). | ## Cited sources | Tool | What it does | | - | - | | `list_cited_sources` | Brand-wide list of **domains** cited across prompts (impact, counts, AI models). Optional `search`, `group_id`. | | `list_cited_urls` | Flat ranking of **URLs** across all domains; optional `search`, `monitored_prompt_id`. | | `get_cited_source_urls` | URLs inside **one** domain; needs `domain_id` from `list_cited_sources`. | | `get_cited_source_related_prompts` | Which prompts cite a given **domain**. | | `get_cited_source_url_related_prompts` | Which prompts cite a specific **URL** (`domain_id` + `url_id`). | **Typical drill-down:** `list_cited_sources` → `get_cited_source_urls` → `get_cited_source_url_related_prompts`. ## Common parameters > [!TIP] > > * **Dates:** use `start_date` and `end_date` in **`YYYY-MM-DD`** where required. > * **`ai_model` (optional):** `chat_gpt`, `perplexity`, `bing_copilot`, `google_ai`, `gemini`, `grok`, `google_ai_mode`. > * **Pagination:** tools that list data accept `page` (default `1`) and `per_page` (default `100`, max `100`). Fetch additional pages when results exceed one page. ## Related * [Introduction](/mcp/introduction) — connect Cursor, Claude, and other MCP clients. # First Answer Crawler Source: https://docs.firstanswer.ai/resources/first-answer-crawler The FirstAnswerBot user agent, what it is for, and how to manage it in robots.txt. ## Overview First Answer uses a single crawler, **FirstAnswerBot**, to check whether your site is ready for AI search engines and to power the recommendations we generate for your brand. | Crawler | User agent | Purpose | | - | - | - | | **FirstAnswerBot** | `FirstAnswerBot/1.0 (+https://docs.firstanswer.ai/resources/first-answer-crawler)` | Powers First Answer's AI-visibility recommendations for your brand. | ## Key points * FirstAnswerBot content is **not used to train AI models**. * It does **not collect personal data**. * It is identified by the `FirstAnswerBot` token in its User-Agent. Match on that token (not the full string) when writing `robots.txt` or firewall rules. ## Managing FirstAnswerBot in robots.txt **Allow it (recommended):** ``` User-agent: FirstAnswerBot Allow: / ``` **Block it:** ``` User-agent: FirstAnswerBot Disallow: / ``` > [!NOTE] > > If you block FirstAnswerBot, we may stop generating some of your recommendations. It does not affect your visibility in AI answers.