Skip to main content

​
Understanding Scores & Metrics

The GEO Score is a composite score from 0 to 100 built from 4 weighted sub-scores:On top of the base score, Qwairy adds bonus points (up to 23) for:
  • Progression — score is improving over time (up to 10 pts)
  • Quality — high sentiment (up to 5 pts)
  • Multi-provider presence — visible across multiple AI models (up to 5 pts)
  • Top position — frequently ranked first in lists (up to 3 pts)
The final score is capped at 100.
  • Mention — your brand name appears in the AI-generated text (e.g., “Qwairy is a GEO platform”). The AI talks about you, but may not link to your site.
  • Citation (or source citation) — the AI references a specific URL from your domain as a source. This means the model not only knows you exist, but trusts your content enough to cite it.
A high mention rate with a low citation rate means AI talks about your brand but relies on third-party sources to back it up. The goal is to improve both.You can see the breakdown in Cockpit > Overview (Brand Mention Visibility vs. Source Citation Visibility).
Out of all brand mentions in AI responses, Share of Voice (SoV) is the percentage that is yours. The denominator is every brand mention detected — yours plus all competitors.Formula: Your brand mentions ÷ All brand mentions (yours + competitors) × 100For example, if your brand and competitors together generate 100 mentions and 25 of them are yours, your SoV is 25%.Track it in Cockpit > Overview and compare it against competitors in Cockpit > Compare.
Each AI provider (ChatGPT, Claude, Gemini, Perplexity, etc.) uses different training data, retrieval methods, and ranking algorithms. This means:
  • A provider with web search (Perplexity, AI Overview) may cite your recent content
  • A provider relying on training data (ChatGPT, Claude) may reflect older information
  • Some providers weight certain source types (Reddit, Wikipedia, review sites) more than others
Use the Cockpit > GEO Matrix to see your score per provider, and the Cockpit > Compare breakdown to benchmark against competitors on each provider.
The GEO Matrix is a heatmap that maps your brand’s AI visibility across two dimensions: rows (topics, tags, funnel stages, or individual prompts) and columns (AI providers).Each cell displays a score from 0 to 100, color-coded from red (invisible) to green (excellent). This lets you instantly spot which topic × provider combinations need work.Click any cell to see the detailed score breakdown, top competitors, and cited sources.Navigate to Cockpit > GEO Matrix to access it.

​
Credits & Pricing

The formula is:
Core models cost 1 credit each: ChatGPT, Gemini, Perplexity, Google AI Overview, Google AI Mode, Microsoft Copilot, Grok.Premium models cost between 2 and 20 credits each:Example: 30 prompts with ChatGPT (1) + GPT-5 mini (2) + Perplexity (1) = 30 × 4 = 120 credits.The exact cost is displayed before you confirm any analysis run.
  1. Go to Team Management > Billing or visit: https://www.qwairy.co/dashboard/team/billing
  2. Click Upgrade Plan or Buy Credits
  3. Select your desired plan or credit package
  4. Complete the payment through Stripe
Credits are shared across all team members and all brands in your workspace.
A workspace is a monitored brand. All plans include unlimited team members. See the full comparison at qwairy.co/pricing.Your plan’s workspace count is a single shared quota for the whole organization. On Business and Enterprise plans, Virtual Teams lets you split that quota across sub-teams: each sub-team draws its workspaces and credits from the same organization pool rather than getting a separate allowance. Moving a workspace between your organization and a sub-team carries its reserved slot with it, so your total workspace allowance never changes.Two workspace types behave differently here. Pitch workspaces (Agency plans) are prospecting brands kept separate from production monitoring and do not count toward your brand limit. Sub-team workspaces (Virtual Teams) are regular production brands that live inside a sub-team and still count against your organization’s shared quota.

​
Monitoring & Data

Go to Workspace > Monitoring and set the schedule to None, Daily, Weekly, or Monthly. Higher frequency consumes more credits — Weekly is recommended for most brands. See Monitoring for the full setup, including per-prompt frequency and boost mode.
Yes. In Workspace > Monitoring, you can filter by:
  • Topic — only run prompts from a specific topic
  • Tag — only run prompts with a specific tag
  • Model — choose which AI models to include
The credit cost updates in real time as you adjust the filters.
Most results appear within a few minutes after launching an analysis. For large prompt sets (40+ prompts) or premium models, it may take up to 10–15 minutes.Look for the “Generating” indicator next to your brand name — it disappears once all responses are processed.
If your responses are stuck or not generating, check the following:
  • Insufficient credits — check your credit balance in Team Management > Billing
  • Generation in progress — look for the “Generating” indicator next to your brand
  • Provider issues — some AI providers may be temporarily unavailable
  • Rate limits — wait a few minutes if you’ve triggered many generations
If the issue persists, contact us via the chat on Qwairy.

​
Competitors

Competitors are automatically extracted from AI-generated responses. When an AI model mentions other brands alongside yours in a response, Qwairy identifies them and adds them to your competitor list.You don’t need to configure anything — Qwairy discovers competitors as it analyzes responses. New competitors can appear after each monitoring run.Manage your competitor list in Monitor > Competitor Mentions, where you can mark competitors as favorites, set their relationship (direct, indirect), or hide irrelevant ones.
Go to Cockpit > Compare and select up to 10 competitors from the dropdown. The tab shows:
  • Metrics Table — side-by-side comparison of 10 KPIs
  • Positioning Map — scatter plot on any 2 metrics
  • Overlap Matrix — heatmap of how often brands co-appear
  • Evolution Chart — trends over time per competitor
  • Breakdown — comparison by provider, topic, tag, or funnel stage
See the Compare documentation for details.

​
Workspace & Brand Management

  1. Click the brand switcher in the top navigation
  2. Select Add Brand
  3. Enter your website URL
  4. Follow the 5-step onboarding wizard:
    • Review auto-detected brand info
    • Review topics
    • Select prompts to monitor
    • Configure monitoring frequency and AI models
    • Launch your brand
The number of brands (workspaces) you can add depends on your plan (Starter: 1, Growth: 5, Business: 20, Enterprise: unlimited).
  1. Go to Workspace > Settings for the brand you want to archive
  2. Scroll to the Danger Zone section
  3. Click Archive Brand
  4. Type the brand name to confirm
Archiving is a reversible status change. The brand stops consuming credits and is hidden from the active brand list, but its prompts, responses, analytics, and settings are preserved. You can restore an archived brand at any time.
  1. Navigate to Workspace > Prompts
  2. Find the prompt you want to delete in the list
  3. Click the three-dot menu (…) next to the prompt Delete prompt menu
  4. Select “Delete Prompt” from the dropdown
  5. Confirm your action
You can also select multiple prompts using checkboxes and use Bulk Delete.
Deleting a prompt removes all associated responses and analytics. This action is permanent.
  1. Go to Workspace > Topics
  2. Find the topic you want to remove Topic list with delete option
  3. Click the trash bin icon in the Actions column
  4. Confirm the deletion
Deleting a topic removes it from all associated prompts and from GEO Matrix / Compare breakdowns. Prompts themselves are not deleted.

​
Exports & Integrations

You can export data in two ways:1. From Workspace > ExportsTrigger an export from the dashboard, then download it as CSV from the Exports page. Available export types include: responses, competitors, sources, prompts, sentiment, shopping, social, and more.2. Via Looker StudioConnect Qwairy to Google Looker Studio for automated, refreshable reports. See the Looker Studio documentation.3. Via the APIUse the REST API to pull data programmatically. See the API Reference.
  1. Go to Measure > Google Search Console
  2. Click Connect Google Search Console
  3. Sign in with your Google account
  4. Select the property you want to connect
  5. Grant Qwairy read-only access to your data
Once connected, Qwairy syncs your keyword data and cross-references it with AI visibility. You can see which queries rank on Google but are invisible in AI responses.
  1. Go to Team Management > API (“API Access”) at https://www.qwairy.co/dashboard/team/api
  2. Click Create API Key and give it a descriptive name
  3. Copy the key immediately (it’s shown only once)
  4. Use it in the Authorization header:
The REST API is available on Growth plans and above. See the API Reference for all available endpoints.
The Model Context Protocol (MCP) lets AI assistants like Claude access your Qwairy data in real time. You can ask questions like “How is my brand performing on Perplexity?” and get live answers from your monitoring data.See the MCP documentation to set it up.

​
Team & Billing

  1. Go to Team Management > Members or visit: https://www.qwairy.co/dashboard/team/members
  2. Click Invite Member
  3. Enter the email address and select a role
Access levels:
All invoices are available in Team Management > Billing or at: https://www.qwairy.co/dashboard/team/billingClick on any past invoice to download or view the PDF.

​
Troubleshooting

This can happen for several reasons:Empty performance dashboard1. Generation is still in progressAfter onboarding, Qwairy needs a few minutes to generate responses. Look for the “Generating” indicator next to your brand name.Generating indicator2. Topics don’t match your brandIf the auto-generated topics don’t align with your actual business, AI responses won’t mention your brand. Go to Workspace > Topics to review and adjust them.3. Your brand is genuinely absent from AI responsesThis is the most common case — AI models don’t mention your brand for the monitored prompts. This is actually the starting point for a GEO strategy: use Content Opportunities and Content Studio to create content that gets your brand into AI responses.If you believe there’s a bug, contact us via the chat on Qwairy.
A provider showing 0% visibility means that none of the AI responses from that provider mention your brand for your monitored prompts. Common reasons:
  • Provider relies on different sources — ChatGPT and Claude use training data, while Perplexity uses live web search. Your brand may be visible on one but not the other.
  • Topic mismatch — the provider may not cover your niche well.
  • Content gap — the sources the provider trusts don’t mention your brand.
Check the Cockpit > GEO Matrix to see which provider × topic combinations are 0, then use Monitor > Citation Sources to understand which sources the provider relies on.
No. Qwairy does not crawl or scrape your website. It analyzes what AI models (ChatGPT, Perplexity, Claude, Gemini, etc.) say about your brand by sending monitored prompts and analyzing the responses.The only connection to your site is through Google Search Console and Bing Webmaster Tools integrations — and these require your explicit authorization with read-only access.
By default, a workspace counts pages and citations across its whole registrable domain — so a workspace on a subdomain (e.g. blog.example.com) also surfaces pages from the parent domain (example.com) and sibling subdomains.To restrict it to the exact subdomain, enable Limit pages to this subdomain in Workspace > Settings > Configuration. See Configuration for details.