Documentation

Learn how to use Linksii

Everything you need to track and improve your brand's visibility across AI platforms.

Getting Started

Get up and running with Linksii in just a few minutes. Follow these steps to start tracking your brand across AI platforms.

1

Create your account

Sign up at linksii.com/signup with your email or Google account. All new accounts start with a free 7-day trial — no credit card required.

2

Set up your workspace

A workspace is your team's home in Linksii. After signing in, you will be guided through a short onboarding wizard to create a workspace. Give it your brand or client name — each workspace keeps its own prompts, competitors, and report history.

  • Each workspace has its own prompts, competitors, and reports
  • Switch between workspaces from the top of the sidebar
  • You can create multiple workspaces if you track several brands
3

Add your brand information

Enter your brand details so Linksii knows what to track:

  • Brand name — the primary name AI platforms might reference
  • Website URL — used to match citations and source links
  • Industry / category — helps generate relevant tracking prompts
  • Target countries — which markets you want to monitor
4

Add prompts and run your first scan

Navigate to Prompts and add at least three questions a potential customer might ask an AI assistant about your category. Then go to the Tracking page and click Run Scan. Within a few minutes your first results will appear on the dashboard.

Expected outcome: you will see mention counts, sentiment scores, and a list of sources cited — your baseline for everything that follows.

5

Read your dashboard

The Dashboard summarizes your brand's AI visibility at a glance. Look for your Visibility % (how often you appear), Sentiment Score (how positively you are described), and Mention Rate (share of voice). These numbers will improve as you add more targeted prompts and run regular scans.

Tip: Start with 5–10 high-quality prompts rather than dozens of vague ones. A focused prompt set gives more actionable data and keeps your credit usage efficient.

Frequently asked questions

Prompts

Prompts are the questions Linksii sends to AI platforms to measure your brand's visibility. They simulate the real queries your potential customers type into ChatGPT, Claude, Gemini, and Perplexity every day. The right prompts give you the clearest picture of how AI talks about your brand.

Creating prompts

Navigate to Prompts in your workspace and click Add Prompt. Enter a natural-language question that a potential customer might ask an AI assistant. For example:

"What is the best CRM for small businesses?"
"Which project management tools do remote teams use?"
"Compare Linksii vs competitors for AI brand tracking"

AI-suggested prompts

Not sure what to track? Linksii can generate prompt suggestions based on your brand, industry, and competitors. Click Suggest Prompts to get AI-powered recommendations tailored to your market. Review the suggestions and add the ones that match how your customers actually search.

Prompt categories

Organize your prompts into funnel stages to understand where your brand shows up in the buyer journey:

  • Awareness — broad category questions (e.g., "What tools exist for X?"). Measures top-of-funnel discoverability.
  • Consideration — comparison and evaluation queries (e.g., "Compare A vs B for teams of 10"). Measures whether you are in the shortlist.
  • Decision — purchase-intent questions (e.g., "Which is the best X for Y budget?"). Measures whether AI recommends you when someone is ready to buy.

Best practices

  • Write prompts the way a real person would ask them — conversational, not keyword-stuffed
  • Include competitor names in some prompts to get comparison data (e.g., "Linksii vs BrandMentions")
  • Add geographic specificity when relevant (e.g., "best CRM for UK startups") to surface regional variation
  • Aim for a mix of all three categories — at least 3 prompts per stage
  • Avoid overly broad one-word prompts — AI responses to "CRM" are too generic to be actionable

Tip: Aim for a mix of all three categories to get a complete view of your visibility across the buying funnel. A good starting set is 4–5 awareness, 3–4 consideration, and 2–3 decision prompts.

Frequently asked questions

Tracking

Linksii automatically sends your prompts to AI platforms on a daily schedule and records every response in detail. Here is how the tracking pipeline works and what data is collected.

Supported platforms

ChatGPT

OpenAI GPT-4o with web search via Serper.dev. Widely used by mainstream consumers.

Claude

Anthropic's assistant with web search via Serper.dev. Popular with technical users.

Gemini

Google's AI with Search grounding enabled. Strong for local/regional queries.

Perplexity

AI-native search engine. Searches the live web and cites sources by default.

How automated tracking works

  1. Each day, the scheduled cron job sends every active prompt to all four AI platforms simultaneously
  2. Responses are analyzed for brand mentions, sentiment, position in ranked lists, and any URLs cited as sources
  3. Results are stored and compared against previous runs to calculate trends and detect changes
  4. If you have configured multiple countries, each prompt runs in every selected locale — AI responses can vary significantly by region
  5. After the scan completes, new insights are generated automatically based on changes detected

Scan frequency

Automated daily scans run once per day. The exact run time depends on your plan and server load — typically early morning UTC. You can also trigger a manual scan at any time from the Tracking page by clicking Run Scan. Manual scans count towards your monthly scan allowance.

Source classification

When AI platforms cite URLs in their responses, Linksii classifies each source into one of five types:

  • UGC — User-generated content: Reddit, Quora, Stack Overflow, social media, GitHub, Product Hunt
  • Editorial — Journalism and professional media: TechCrunch, Forbes, BBC, Reuters, industry publications
  • Corporate — Company websites and official brand content (identified by domain match or corporate TLDs)
  • Reference — Encyclopedic knowledge bases: Wikipedia, Crunchbase, G2, Capterra
  • Institutional — Government (.gov), academic (.edu), and non-profit (.org) sources

Each source also receives a credibility score (0–100) based on domain reputation, source type, and TLD. Use this to prioritise which publications and platforms to target in your content and PR strategy.

Tip: Multi-country tracking is powerful for global brands — an AI might recommend you confidently in the US but not at all in the UK. Enable the countries where your customers are to spot these gaps.

Frequently asked questions

Competitors

Understand how your brand stacks up against competitors in AI responses. When you add competitors, Linksii tracks them alongside your brand in every scan — so you can see who AI platforms recommend, how often, and with what sentiment. Competitor analysis is available on Pro and Enterprise plans.

Adding competitors

  1. Go to Competitors in your workspace sidebar
  2. Click Add Competitor and enter the brand name and website URL
  3. Linksii automatically fetches their logo from their website so you can quickly identify them in charts and tables
  4. On the next scheduled scan (or manual scan), competitor detection runs automatically alongside your brand

What competitor tracking shows

  • Mention comparison — how often each competitor is mentioned vs. your brand across all prompts
  • Sentiment comparison — positive, neutral, and negative framing side by side
  • Position tracking — where your brand appears in ranked lists relative to competitors
  • Co-mention rate — how often your brand and a competitor appear in the same response (indicates direct comparison)

Gap analysis

Gap analysis identifies prompts where competitors are mentioned but your brand is not. These are the most actionable insights in Linksii — they tell you exactly which topics your competitors "own" in AI responses that you do not. Use these insights to:

  • Discover content and SEO opportunities you are missing
  • Understand which use cases or personas competitors rank for
  • Prioritize PR efforts to earn citations from the sources AI platforms trust

Tip: Add 3–5 direct competitors for the most useful comparisons. Tracking too many dilutes the analysis; too few misses important context.

Frequently asked questions

Dashboard

The dashboard gives you an at-a-glance view of your brand's AI visibility. It combines your latest scan results with trend lines so you can see whether your brand presence is growing, shrinking, or holding steady.

Key metrics explained

Visibility %

The percentage of tracked prompts where your brand is mentioned in at least one AI response. A score of 60% means 6 out of 10 prompts generated a mention. This is your primary measure of AI presence.

Sentiment Score

An aggregate measure of how positively or negatively AI platforms talk about your brand. Each mention is scored as positive, neutral, or negative. The overall score is a weighted average. Higher is better; watch for sudden drops after product launches or press events.

Mention Rate

How frequently your brand is mentioned compared to total responses tracked — your share of voice in AI-generated content. A brand with 3 mentions across 10 responses has a 30% mention rate.

Citation Rate

The percentage of mentions that include a direct URL citation to your domain. A high citation rate means AI platforms are not just mentioning your brand — they are linking to your content as a source, which is a strong signal of AI authority.

Avg. Position

When your brand appears in a ranked list in an AI response (e.g. 'top 5 CRMs'), this is your average ranking position across all such lists. Position 1 is best. Track this alongside Visibility % to understand quality of mentions.

How the brand score is calculated

The overall brand score (shown as a ring on the dashboard) is a weighted composite of three components:

Mention Rate40%

How often your brand appears in AI responses

Sentiment30%

Tone of mentions

Source Coverage30%

Breadth of sources citing your brand

Each component is normalized to a 0–100 scale before weighting. The resulting score reflects both how often you appear and the quality of those appearances.

Reading the charts

  • Trend lines show how metrics change over time — look for upward trends after content updates or PR coverage
  • Platform breakdown shows visibility per AI engine so you can spot platform-specific gaps
  • Category view breaks down metrics by prompt category (awareness / consideration / decision)
  • Last scan indicator shows when data was last refreshed so you know how current your numbers are

Tip: Check your dashboard weekly to spot trends. AI platform responses change frequently as models are updated — sudden visibility drops often coincide with a model update, not a change in your brand's actual reputation.

Frequently asked questions

Insights

The Insights page surfaces automatically-detected signals from your tracking data — things worth your attention without you having to go looking for them. After each scan, Linksii analyses changes in your data and generates specific, actionable insights.

How insights are generated

After every tracking scan, the system compares the latest results against your historical baseline and current competitor data. Significant changes — a visibility spike, a sentiment shift, a new competitor gaining ground — are surfaced as individual insight cards. Each insight includes the specific prompt, platform, or metric that triggered it.

Insight types

Strength

Areas where your brand is performing well — high visibility, positive sentiment, or strong citation rate. Use these to understand what is working and double down.

Opportunity

Gaps or trends where you could improve — prompts where competitors appear but you don't, or categories where your visibility is below your overall average.

Warning

Negative changes requiring attention — a sudden drop in visibility, a shift toward negative sentiment, or a competitor significantly gaining ground on you.

Categories of insights

  • Visibility changes — sudden increases or drops in how often your brand is mentioned across platforms
  • Competitor activity — when a competitor gains ground in prompts where you previously had coverage
  • Sentiment shifts — changes in positive or negative framing of your brand in AI responses
  • Coverage gaps — prompts where competitors are mentioned but your brand is absent
  • Source changes — new or changed URLs being cited when your brand is discussed

How to act on insights

  • Opportunity (coverage gap): Create content targeting the topic in the prompt. Earn links from the sources AI platforms cite for your competitors.
  • Warning (sentiment drop): Investigate what changed — check for recent news, reviews, or product issues. Look at which sources AI is citing in the affected responses.
  • Strength (high visibility): Identify which content types and sources drove the result and replicate them across other prompts.

Tip: Insights are generated automatically after each tracking run. Check this page after your daily scan completes. New insights are highlighted so you can quickly see what changed since your last visit.

Frequently asked questions

Mentions

The Mentions feed shows every individual AI response where your brand was referenced — the raw data behind your aggregate metrics. Use it to read the actual AI responses, understand context, and investigate specific incidents.

Mention types

Brand mention

Your brand name appears in the AI response text. The AI is aware of your brand and has referenced it in its answer — but may or may not be recommending it.

Citation

The AI has included a URL to your domain as a source in its response. This is a stronger signal than a plain mention — it means AI platforms are using your content as a reference. Track citation rate to measure content authority.

What each mention shows

  • Platform — which AI (ChatGPT, Claude, Gemini, or Perplexity) generated the response
  • Prompt — the question that triggered the mention
  • Sentiment — positive, neutral, or negative framing in that specific response
  • Position — where your brand appeared (first mention, ranked list position, etc.)
  • Sources cited — the URLs the AI referenced, with source type and credibility score
  • Country — which regional version of the prompt produced this mention
  • Response excerpt — the relevant portion of the AI response so you can read context without leaving the page

Filtering mentions

Use the filter bar at the top of the Mentions page to narrow down by:

  • Platform (ChatGPT, Claude, Gemini, Perplexity)
  • Sentiment (positive / neutral / negative)
  • Date range
  • Prompt category (awareness / consideration / decision)
  • Country / region

Tip: Filter by a single platform when investigating a platform-specific drop in your dashboard metrics. Reading the raw responses often reveals exactly why your brand is being described a certain way.

Frequently asked questions

Reports & Export

Generate reports and export your data for presentations, client reporting, or further analysis. Linksii supports CSV data exports and branded PDF reports.

What's available now

Summary reports

Navigate to Reports in your workspace to view and generate summary reports. Reports include key metrics, trends, top-performing prompts, and competitor comparisons for a selected date range. These are viewable in the app and shareable via link.

CSV export

Export raw tracking data as CSV files for use in spreadsheets, BI tools, or custom analysis. Available exports include:

  • Prompt results — all mentions with sentiment, position, platform, and country data
  • Competitor comparison — side-by-side mention and sentiment data for your brand and competitors
  • Source data — all cited URLs with credibility scores and source type classification
  • Historical trends — daily metric snapshots over your selected date range

PDF reports

Linksii generates branded PDF reports via the /api/v1/analyze/report endpoint. The benchmark report is also downloadable as a PDF directly from the Reports page. Use PDF reports for client presentations, stakeholder updates, and offline sharing.

Tip: For agency and client reporting, export a CSV and pair it with your in-app report link. The shareable link lets clients view their data without needing a Linksii account.

Frequently asked questions

Billing

Linksii offers three plans to match your needs. All plans include a 7-day free trial — no credit card required to start. Billing is handled securely through Stripe.

Plan comparison

FeatureStarterProEnterprise
Price$89/mo$199/mo$499/mo
Tracked prompts25100Unlimited
Countries3510+
AI platformsAll 4All 4All 4
Competitor benchmarkingYes (5)Yes (10)Yes (unlimited)
API accessYes
Team seats1 (owner)Up to 5Unlimited
Report sharingYesYesYes

Managing your subscription

  • Go to Settings → Billing in your workspace to view your current plan, update your payment method, or download invoices
  • You can upgrade or downgrade at any time. Upgrades take effect immediately; downgrades take effect at the end of your billing period
  • Changes are prorated automatically by Stripe
  • Cancel anytime from your account settings. You keep access until the end of your current billing period

Trial and free tier

All new accounts start with a 7-day free trial on the Pro plan — no credit card required. At the end of the trial you will be asked to choose a paid plan to continue. Your data and prompts are retained regardless of which plan you choose.

Tip: Need a custom plan or more than 300 prompts? Contact our sales team to discuss Enterprise options.

Frequently asked questions

API

The Linksii REST API gives you programmatic access to your brand tracking data. Build integrations, automate reporting, pull data into your own dashboards, and trigger scans from external workflows. API access is available on Enterprise plans.

Quick overview

The API uses standard REST conventions with JSON request and response bodies. Authentication is via API key passed in the X-API-Key header. API keys are managed in Settings → API Keys.

Available endpoints

GET/api/v1/workspaces

List and manage workspaces

GET/api/v1/tracking

Fetch tracking results

GET/POST/api/v1/prompts

List and create prompts

GET/POST/api/v1/competitors

List and add competitors

POST/api/v1/analyze

Trigger an on-demand analysis

GET/api/v1/keys

Manage API keys

Getting started with the API

  1. Go to Settings → API Keys and generate a new key
  2. Store the key securely — it is only shown once at creation
  3. Pass the key in the X-API-Key header on every request
  4. See the full API reference and code examples for curl, JavaScript, and Python in the links below

Tip: Need help integrating? Contact our team for guidance on custom integrations and white-label reporting.

Frequently asked questions