GenieOptimize Documentation

Complete guide to optimizing your website for AI assistants like ChatGPT, Claude, and Perplexity. Get cited AND recommended by LLMs.

What is GenieOptimize?

GenieOptimize is a comprehensive platform that helps businesses optimize their websites for AI assistants and large language models (LLMs). Unlike traditional SEO that focuses on search engines, GenieOptimize ensures your product gets cited, mentioned, and recommended when users ask AI assistants for help.

Quick Start

<script src="https://cdn.genieoptimize.com/snippet.min.js"
        data-key="YOUR_API_KEY"></script>

How It Works

GenieOptimize uses a dual-layer approach to ensure your website performs well with AI assistants:

Layer 1: Visibility Layer (Citations)

Ensures AI assistants can find and cite your content through:

• llms.txt file - Tells LLMs what content to prioritize
• Optimized meta tags - Clear, descriptive information
• JSON-LD schemas - Structured data AI assistants understand
• FAQ content - Direct answers to common questions

Layer 2: Recommendation Layer

Teaches AI assistants when to recommend your product through:

• Ideal customer profiles - Who your product is perfect for
• Use case documentation - Specific problems you solve
• Competitive positioning - When to choose you vs alternatives
• Recommendation triggers - Queries that should lead to your product

JavaScript SDK

The GenieOptimize SDK is a lightweight JavaScript library that automatically optimizes your website for AI assistants. It works entirely in the background and requires zero maintenance.

Features

• Automatic coverage - Works on all pages, even ones you forget
• Remote updates - Adapts to changing AI requirements without code changes
• Real-time analytics - Tracks AI assistant traffic
• Zero maintenance - Set it and forget it
• Lightweight - Less than 10KB gzipped

Installation

<!-- Add before closing </body> tag -->
<script src="https://cdn.genieoptimize.com/snippet.min.js"
        data-key="ak_live_YOUR_API_KEY"></script>

What the SDK Does

• Injects optimized meta tags on each page
• Adds JSON-LD structured data
• Tracks AI assistant visits (ChatGPT, Claude, Perplexity bots)
• Reports installation status to your dashboard
• Applies page-specific optimizations based on your analysis

llms.txt Generation

The llms.txt file is like a robots.txt for AI assistants. It tells LLMs which pages to prioritize, what content is most important, and how to understand your website structure.

What's in llms.txt?

# GenieOptimize llms.txt

# About Our Product
https://example.com/about - Main company information
https://example.com/product - Product features and pricing
https://example.com/use-cases - Common use cases

# Documentation
https://example.com/docs - Getting started guide
https://example.com/api - API documentation

# Recommendations
https://example.com/vs/competitor - Competitive comparisons
https://example.com/for/developers - For developer teams

Automatic Generation

GenieOptimize automatically generates your llms.txt file based on your website analysis. Simply download it from your dashboard and place it in your website root:

https://your-domain.com/llms.txt

Recommendation Intelligence

Our most powerful feature uses Claude Sonnet 4.5 to analyze your product and generate recommendation-optimized content that teaches AI assistants when to recommend your product.

What You Get

• Recommendation Score - 0-100 score showing how recommendation-ready you are
• Ideal Customer Profiles - Descriptions of who benefits most from your product
• Use Case Documentation - Specific scenarios where you're the best solution
• Competitive Positioning - When to choose you vs major competitors
• Recommendation Triggers - Queries that should lead to your product
• Implementation Content - Ready-to-use schemas and page content

How to Use It

1. Go to the Recommendations tab in your project
2. Click "Generate Recommendations" (takes 2-3 minutes)
3. Review your recommendation score and insights
4. Implement the suggested content on your website
5. Use "Refine Recommendations" to improve over time

Custom Prompt Tracking

Custom Prompt Tracking lets you define specific natural-language questions and monitor how AI engines respond to them. Track whether your brand gets mentioned, measure win rates over time, and identify which engines recommend you most.

How It Works

1. Navigate to AI Visibility → Custom Prompts in your project
2. Click "Add Custom Prompt" and enter a question (e.g., "What are the best tools for AI visibility tracking?")
3. Select which AI engines to check (ChatGPT, Gemini, Perplexity, Grok)
4. Choose a check frequency (Monthly, Weekly, or Daily depending on your plan)
5. Click "Start Tracking" and results will appear after the first scheduled check

Key Features

Plan Limits

• Starter — 10 custom prompts, monthly + weekly frequency, 2 engines (ChatGPT, Gemini)
• Growth — 50 custom prompts, weekly + daily frequency, 3 engines (+Perplexity)
• Scale — 150 custom prompts, full daily frequency, all 4 engines (+Grok)

Tips for Effective Prompts

• Use full questions — "What are the best AI SEO tools for SaaS?" works better than "AI SEO tools"
• Be specific — Long-tail conversational queries (5+ words) yield more meaningful tracking
• Mirror real user queries — Think about what your target customers actually ask AI assistants
• Check content relevance — Low relevance scores mean your site lacks content that matches the prompt topic

AI Visibility Hub

The AI Visibility Hub is your unified command center for understanding how your brand appears across AI platforms. It combines three powerful features into a single tabbed interface.

Four Tabs, One View

• Brand Tracking — Automated monitoring of how often AI engines mention your brand across a standard set of queries. See mention rates, sentiment, and trends over time.
• Custom Prompts — Your user-defined questions tracked across AI engines. Define exactly which queries matter most to your business and monitor win rates.
• Competitive — Head-to-head comparison with your competitors. See who AI recommends for different query categories, identify positioning gaps, and track competitive advantage.
• Truth Guard Beta — Detect hallucinations, refusals, and shadow bans across AI engines. Define your product’s ground truth and get correction snippets for llms.txt.

Navigating the Hub

Access the AI Visibility Hub from the sidebar under your project. You can deep-link to specific tabs using URL parameters: /app/visibility?tab=tracking, /app/visibility?tab=custom, /app/visibility?tab=competitive, or /app/visibility?tab=truth-guard.

Viral Social Cards

Available on All Plans — Generate shareable branded images of your success metrics to post on social media. Turn your wins into marketing content that attracts new users.

What It Does

When you hit milestones—a high AI Readiness Score, strong win rates, or good mention rates—Viral Social Cards lets you instantly create beautiful, shareable images to post on Twitter/X and LinkedIn.

Where to Share From

Share buttons appear automatically when you achieve notable metrics:

• AI Readiness Score — When your score is 70+ (B grade or higher), a "Share" button appears on the score widget
• Competitive Win Rate — When you have 50%+ win rate in head-to-head tracking, share from the Competitive Overview
• Mention Rate — When you reach 30%+ mention rate across AI platforms, share from the metrics dashboard

What Gets Generated

Each social card includes:

• Branded Design — Beautiful gradient background matching GenieOptimize brand
• Large Metric Display — Your achievement front and center (e.g., "92/100" or "68%")
• Context Label — Clear label like "AI Readiness Score" or "Win Rate"
• Subtitle — Additional context (e.g., "A Grade - Ready for AI Era")
• Watermark — "Verified by @GenieOptimize" footer for brand attribution
• Emoji — Relevant emoji based on metric type (🚀 for readiness, 🎯 for win rate, 📈 for mentions)

How to Use

1. Achieve a notable metric (70+ readiness score, 50%+ win rate, or 30%+ mentions)
2. Click the "Share" button that appears next to the metric
3. Preview your branded social card in the modal
4. Choose your sharing method:
   • Download PNG — Save 1200x675px image for manual posting
   • Share on 𝕏 — Opens Twitter/X with pre-filled text + downloads image
   • Share on LinkedIn — Downloads image and opens LinkedIn

Why Use It

• Social Proof — Show your audience you're ahead of the curve on AI optimization
• Attract Customers — Demonstrate expertise in AI search optimization
• Community Building — Join the conversation among AI-forward companies
• Free Marketing — Every share includes @GenieOptimize attribution
• FOMO Creation — Make others curious about their own AI readiness

Technical Details

Social cards are generated client-side using HTML5 Canvas. The 1200x675px aspect ratio (16:9) is optimized for social media previews on both Twitter/X and LinkedIn. Images are generated at 2x resolution for crisp display on retina screens.

Citation Influence Map

Available in Competitive Intelligence (Growth & Scale Plans) — Understand which authority sources AI assistants cite when recommending your competitors. This "Source Detective" feature extracts and analyzes URLs that LLMs reference in competitive responses.

What It Does

When AI assistants recommend competitors, they often cite specific URLs as evidence. The Citation Influence Map automatically extracts these citations and shows you:

• Top Authority Sources — Domains and URLs that AI engines cite when recommending each competitor
• Citation Frequency — How many times each source has been cited across all tracked queries
• AI Source Breakdown — Which AI engines (ChatGPT, Claude, Gemini, Perplexity) cite each source
• Example Queries — Real queries where the source was cited to support a competitor
• Citation Context — The surrounding text showing how the source was used in recommendations

Where to Find It

Citation data appears in three locations within the Competitive Intelligence tab:

1. Overview Tab — Summary table showing top 5 authority sources per competitor with total citation counts
2. Competitors Tab — Inline display of top 3 sources for each competitor in the management table
3. Expanded Detail View — Click "View All (20)" on any competitor to see their complete authority source list with full details

Why It Matters

Understanding which sources AI engines trust gives you actionable competitive intelligence:

• Identify Authority Gaps — See which reputable sites mention competitors but not you
• Content Strategy — Discover which types of content (reviews, comparisons, case studies) drive citations
• Outreach Opportunities — Find publications and platforms where you should establish presence
• Citation Patterns — Learn which sources AI engines consistently trust for your industry

Technical Details

Citation extraction works automatically across all competitive tracking queries. When AI engines include citation markers like [1], [2] in responses, GenieOptimize:

1. Parses citation markers from the response text
2. Maps structured citation URLs from the API response to each marker
3. Associates citations with the competitors mentioned in context
4. Aggregates data across all queries to identify top authority sources
5. Tracks citation frequency, timing, and AI source attribution

Truth Guard Beta

Available on All Plans — Detect when AI models hallucinate facts about your product, refuse to recommend you, or shadow-ban your brand entirely. Truth Guard probes ChatGPT, Gemini, Grok, and Perplexity with safety and fact-checking questions, then compares responses against your defined ground truth.

What It Does

AI models sometimes spread wrong information about products — incorrect pricing, made-up features, or worse, calling your product a scam. Truth Guard gives you a proactive, automated way to catch these issues before your customers do.

• Hallucination Detection — Catches when AI states wrong pricing, features, or claims about your product
• Refusal Monitoring — Detects when AI refuses to answer questions about your product or gives evasive responses
• Shadow Ban Detection — Identifies when AI completely omits your product from relevant conversations
• Correction Snippets — Generates ready-to-use text for your llms.txt to correct misinformation

How It Works

1. Define Ground Truth — Create a fact sheet with your product’s key details (pricing, features, free tier, compliance, etc.)
2. Run Checks — Truth Guard sends safety probes (“Is [brand] a scam?”) and fact probes (“How much does [brand] cost?”) to all AI engines
3. Automated Verification — Responses are analyzed against your ground truth to detect inaccuracies
4. Dashboard & Alerts — View hallucination rates, refusal rates, and shadow ban rates with severity-coded issue timelines

Ground Truth Fact Sheet

The fact sheet is where you define the authoritative data about your product. Each fact has a field name (e.g., “Pricing”), value (e.g., “$29/mo”), and type (text, number, or yes/no). Quick-add buttons help you populate common fields like pricing, free trial, GDPR compliance, and integrations.

Dashboard Metrics

• Hallucination Rate — Percentage of checks where AI stated incorrect facts
• Refusal Rate — Percentage of checks where AI refused to discuss your product
• Shadow Ban Rate — Percentage of checks where AI completely omitted your product
• Issue Timeline — Recent issues sorted by severity with engine and probe details

Analytics Dashboard

Track how AI assistants interact with your website in real-time. See which bots visit, what pages they access, and how often you're being cited.

Tracked Metrics

• Bot Visits - When ChatGPT, Claude, or Perplexity crawlers visit
• Page Views - Which pages are most accessed by AI bots
• SDK Status - Installation and activity status
• Optimization Coverage - Which pages have been optimized
• Trends Over Time - Historical data and growth patterns

Weekly Performance Reports

Available on Growth & Scale Plans — Receive a detailed weekly email summarizing how each of your projects performs across AI engines. Reports are generated every Sunday and cover the previous Mon–Sun period.

What's Included

Each project report contains:

• Brand Visibility — Mention rate across ChatGPT, Claude, Gemini, Grok, and Perplexity with week-over-week trends
• Citations — Total citations detected, breakdown by AI source, top queries, and average position
• Competitive Positioning — Your mention rate vs competitors, head-to-head wins, and missed opportunities
• Citation Influence — Top authority sources cited for competitors, revealing which URLs drive AI recommendations
• AI Traffic — Verified visits from AI platforms with source breakdown and top landing pages
• Recommendation Score — Overall score (0–100) with component breakdowns
• Action Items — Top recommendations sorted by severity to improve your AI presence
• Content Health — Pages analyzed, changes detected, and SDK installation status

Managing Your Preferences

Weekly reports are enabled by default. You can toggle them on or off from Settings in your dashboard (click the gear icon in the top-right corner).

AI ROAST

Premium Feature (Growth & Scale Plans) - Get brutally honest feedback from multiple AI models about why your platform is not being promoted more in AI responses.

What is AI ROAST?

AI ROAST analyzes your platform across multiple AI models (ChatGPT, Gemini, Grok, and Perplexity) to provide comprehensive, honest feedback about weaknesses and improvement opportunities. Each AI model provides its own perspective, giving you a well-rounded view of what's holding you back.

Key Features

• Multi-LLM Analysis - Get feedback from ChatGPT, Gemini, Grok, and Perplexity
• Brutally Honest Feedback - No sugar-coating, just actionable insights
• Weakness Identification - Clear list of key weaknesses to address
• Promotion Reasons - Detailed explanations of why you're not being promoted more
• Weekly Limit - One roast per project per week ensures quality insights

How to Use

1. Navigate to AI ROAST from the main menu
2. Ensure you have a project selected
3. Click "Start AI ROAST" button
4. Wait for the asynchronous job to complete (typically 2-5 minutes)
5. Review the results from all AI models

Understanding Your Results

Each roast includes:

• Summary - High-level overview of findings
• Roast Text - The main feedback in a "roast" style format
• Key Weaknesses - List of identified weaknesses as actionable items
• Reasons - Detailed explanations of why you're not being promoted more

Best Practices

• Review feedback from all AI models - each provides unique insights
• Prioritize weaknesses that appear across multiple models
• Use the feedback to create an action plan for improvements
• Schedule weekly roasts to track improvement over time
• Compare results as you implement optimizations

Weekly AI Optimization Inbox Beta

A weekly digest of AI-discovered optimization opportunities delivered every Monday. Get prioritized issues with one-click AI-generated fix patches so you can improve your AI visibility without manual research.

Key Features

• Automated Weekly Scans — Every Monday, your monitored pages are scanned for optimization gaps
• AI-Generated Fix Patches — Each issue comes with a ready-to-apply content patch in HTML, Markdown, or JSON-LD
• Priority Scoring — Issues are ranked by effort (quick-win, moderate, deep) and impact
• Preview & Code View — See rendered previews of patches before applying, plus raw code for copy-paste
• Format-Specific Instructions — Step-by-step apply guides tailored to HTML, Markdown, or JSON-LD

How to Use

1. Navigate to AI Inbox from the sidebar
2. Review the latest weekly digest with prioritized issues
3. Click any issue to see details, the AI-generated patch, and apply instructions
4. Use the Preview tab to see how the fix looks, or the Code tab to copy the raw patch
5. Follow the step-by-step instructions to apply the fix to your site

Gap-to-Content Auto Suggestion Engine Beta

Automatically detects gaps in your AI visibility and generates content patches to fix them. The engine bridges the gap between monitoring and action by providing ready-to-use content fixes.

Key Features

• AI-Powered Gap Detection — Analyzes visibility data to find where your content falls short
• Auto-Generated Patches — Creates content patches using Nova LLM tailored to each issue type
• Multi-Format Support — Generates patches in HTML, Markdown, and JSON-LD formats
• Visual Preview — Preview rendered patches before applying them to your site
• Step-by-Step Guide — Format-specific instructions for applying each patch

How It Works

1. The engine scans your visibility data for content gaps and missing optimizations
2. For each gap, it generates a content patch using Amazon Nova LLM
3. Patches appear in your AI Inbox with preview and code views
4. Review the patch, copy the code, and apply it following the provided instructions

AI Health Score & Weekly Report Beta

A comprehensive health score that measures your AI optimization posture across multiple dimensions. Track your progress over time and receive a free weekly email report with key insights and recommendations.

Key Features

• Multi-Dimensional Scoring — 0–100 score based on schema quality, content optimization, visibility metrics, and more
• Trend Tracking — Week-over-week comparisons show whether your score is improving
• Free Weekly Email Report — Automated email every Monday with your score, trends, and top recommendations
• Actionable Recommendations — Prioritized suggestions ranked by potential impact on your score

How to Use

1. Your AI Health Score is displayed at the top of the AI Inbox page
2. Click the score widget to see the full breakdown by dimension
3. Weekly email reports are sent automatically — no setup required
4. Use the recommendations to prioritize your optimization efforts each week

AI Intent Gap Analyzer Beta

Discover which user intents AI engines associate with your competitors but not with you. The analyzer clusters intent gaps and helps you generate targeted content to close them.

Key Features

• AI-Powered Intent Clustering — Nova LLM groups related queries into strategic intent clusters
• Competitor Gap Detection — See which intents competitors own that you’re missing
• Content Outline Generation — Get AI-generated outlines for each intent cluster
• Smart Suggestions — AI-powered suggestions based on your product analysis, competitors, and visibility data
• Asset Type Recommendations — Suggested content types: vs-pages, use-case pages, FAQ boosters, schema, blog posts

How to Use

1. Navigate to Strategy from the sidebar
2. Browse AI-suggested intent clusters or create your own
3. Click a suggestion card to pre-fill a new intent cluster
4. Add queries to the cluster and select the target asset type
5. Generate content outlines for each cluster to guide your content creation

AI-Optimized Page Generator Beta

Generate full AI-optimized pages from scratch. Choose from comparison pages, use-case pages, FAQ boosters, and more — all powered by Nova AI with smart suggestions based on your product analysis.

Key Features

• 5 Page Types — VS comparison pages, use-case pages, FAQ boosters, schema pages, and blog posts
• AI-Powered Content — Full page content generated by Amazon Nova LLM
• Live Preview — See rendered HTML preview alongside raw code
• Smart Suggestions — AI recommends pages based on your product analysis, competitors, and visibility gaps
• Export Ready — Copy generated HTML or Markdown to publish directly on your site

How to Use

1. Navigate to Pages from the sidebar
2. Click “Generate New Page” or pick from AI suggestions
3. Select the page type and provide a title (or use a suggested one)
4. Review the generated page in the Preview tab
5. Copy the code from the Code tab and publish it on your site

Detailed Installation Guide

1. Create Project

After signing up, create a project for your website. Each project gets a unique API key.

2. Add SDK Snippet

Copy your SDK snippet from the dashboard and add it to your website's HTML:

<!DOCTYPE html>
<html>
<head>
    <title>Your Website</title>
</head>
<body>
    <!-- Your content here -->

    <!-- GenieOptimize SDK - Add before closing body tag -->
    <script src="https://cdn.genieoptimize.com/snippet.min.js"
            data-key="ak_live_YOUR_API_KEY"></script>
</body>
</html>

3. Verify Installation

Check your dashboard's Optimizations page. You should see a green "Setup Complete" status within a few minutes of deployment.

4. Analyze Pages

Use the "Analyze Page" feature to get AI-powered recommendations for specific URLs on your website.

5. Download llms.txt

Download your generated llms.txt file and upload it to your website root directory.

Meta Tags Optimization

GenieOptimize analyzes your pages and generates optimized meta tags that AI assistants can easily understand.

Example Meta Tags

<!-- Generated by GenieOptimize -->
<meta name="description" content="Clear, concise description of your product">
<meta name="keywords" content="relevant, searchable, keywords">

<!-- Open Graph -->
<meta property="og:title" content="Your Product Name">
<meta property="og:description" content="What your product does">
<meta property="og:type" content="website">
<meta property="og:image" content="https://example.com/image.jpg">

<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Your Product Name">
<meta name="twitter:description" content="What your product does">

JSON-LD Schemas

Structured data helps AI assistants understand your content context. GenieOptimize generates schemas optimized for LLM comprehension.

Organization Schema

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Your Company",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png",
  "description": "What your company does",
  "sameAs": [
    "https://twitter.com/yourcompany",
    "https://linkedin.com/company/yourcompany"
  ]
}
</script>

Product Schema

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Your Product",
  "applicationCategory": "BusinessApplication",
  "offers": {
    "@type": "Offer",
    "price": "29",
    "priceCurrency": "USD"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "127"
  }
}
</script>

FAQ Schema

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "What does your product do?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Clear, direct answer that AI can quote"
    }
  }]
}
</script>

Content Optimization

Beyond technical implementation, the content itself matters. AI assistants look for clear, authoritative, and helpful information.

Best Practices for AI-Friendly Content

• Be Direct - Answer questions clearly in the first paragraph
• Use Headers - Break content into scannable sections (H2, H3)
• Add FAQs - Include common questions with direct answers
• Cite Sources - Link to authoritative external resources
• Update Regularly - Keep information current and accurate
• Be Specific - Use concrete examples over vague statements

Content Types AI Assistants Love

• Step-by-step tutorials and how-to guides
• Comparison pages (vs competitors)
• Use case documentation
• FAQ sections
• Product specifications and features
• Pricing and plan details

API Reference

GenieOptimize provides a REST API for programmatic access to all features.

Authentication

All API requests require authentication via Bearer token:

Authorization: Bearer YOUR_AUTH_TOKEN

Key Endpoints

POST /api/analyze

Analyze a page and get optimization recommendations

{
  "url": "https://example.com/page",
  "projectId": "proj_123"
}

GET /api/optimizations

Get all optimizations for a project

GET /api/stats

Get analytics and crawler visit stats

POST /api/recommendations/:projectId/generate

Generate recommendation intelligence (PRO+ only)

Best Practices

Do's ✓

• Install SDK on all pages for complete coverage
• Keep your llms.txt file updated as you add new pages
• Regularly analyze new pages and content
• Implement recommendation intelligence suggestions
• Monitor your analytics dashboard weekly
• Update content to stay current and accurate

Don'ts ✗

• Don't keyword stuff or use manipulative tactics
• Don't make false claims or exaggerate capabilities
• Don't ignore your recommendation score
• Don't forget to test SDK installation
• Don't use multiple API keys on the same domain

Troubleshooting

SDK Not Showing as Installed

Problem: Dashboard shows "SDK Not Detected"

Solution:

• Verify the script tag is before </body>
• Check that your API key is correct (starts with ak_live_ or ak_test_)
• Ensure the page has been loaded at least once
• Check browser console for errors
• Wait 5-10 minutes for beacon to register

No Optimizations Generated

Problem: Page analysis returns no recommendations

Solution:

• Ensure the URL is publicly accessible (not behind auth)
• Check that the page has sufficient content
• Verify the page returns 200 status code
• Make sure robots.txt allows crawling

Low Recommendation Score

Problem: Recommendation score is below 50

Solution:

• Review and implement suggested content improvements
• Add use case documentation to your website
• Create comparison pages vs competitors
• Define your ideal customer profile clearly
• Use "Refine Recommendations" to improve

Bot Visits Not Being Tracked

Problem: No crawler visits showing in analytics

Solution:

• Confirm SDK is properly installed
• Check that llms.txt is publicly accessible
• Verify robots.txt allows LLM crawlers
• Be patient - bot visits may take days or weeks initially

Next Steps

Now that you understand how GenieOptimize works, here's what to do next:

1. Install the SDK on your website if you haven't already
2. Analyze your key pages using the dashboard
3. Implement recommendations starting with high-priority items
4. Generate recommendation intelligence (if on PRO+ plan)
5. Monitor your analytics and track improvement over time