Documentation

Sign up at Oblysk, add your first brand by entering your website URL, and run your first scan. Within 60 seconds you'll see your AI Visibility Report showing how ChatGPT, Claude, Perplexity, and Gemini talk about your brand. Your report includes a Health Score (overall AI presence), Visibility Score (mention frequency), Accuracy Score (correctness of AI claims), and Sentiment Score (positive/negative tone)..

Health Score (0-100): Your overall AI visibility health. Combines visibility (35%), accuracy (40%), and sentiment (25%). Accuracy is weighted highest because inaccurate visibility is worse than no visibility.

Green (75+) = excellent, Amber (50-74) = needs work, Red (<50) = critical. Visibility Score: How often AI mentions you when people ask relevant questions. Accuracy Score: Whether AI gets your pricing, features, and description right.

Sentiment Score: Whether AI speaks positively, neutrally, or negatively about you..

AI visibility is how often and how accurately your brand appears in AI-generated answers. Over 60% of Google searches now show AI-generated overviews. Millions ask ChatGPT, Claude, and Perplexity for product recommendations daily.

If AI doesn't mention your brand — or worse, gets your information wrong — you're losing customers you never knew existed. Unlike traditional SEO, AI visibility depends on training data, structured content, and whether AI crawlers can access your site..

AI hallucinations are false or inaccurate claims AI makes about your brand. Common examples: wrong pricing ('Pro plan is $79' when it's actually $49), fabricated features ('offers AI-powered scheduling' when you don't), outdated information ('founded in 2015' when it was 2020). Oblysk detects hallucinations by scraping your actual website for ground truth, then comparing every AI claim against reality.

Each claim gets a severity rating: Critical (wrong pricing, fabricated products), High (wrong features), Medium (minor inaccuracies), Low (unverifiable claims)..

The GEO Audit checks 25+ factors that determine whether AI platforms can discover and cite your content. Categories: Crawler Access (30%) — checks if GPTBot, ClaudeBot, PerplexityBot are allowed in your robots.txt. Structured Data (25%) — validates JSON-LD schema markup for Organization, Product, FAQ, Article types.

Content Quality (25%) — heading structure, meta tags, content depth, FAQ sections. Technical (20%) — page speed, SSL, mobile-friendliness. Each finding includes a specific fix recommendation, often with copy-paste code snippets..

Install the Oblysk tracking snippet to see which AI crawlers visit your site. Add this before </body>: <script src='https://api.[domain]/api/v1/bots/snippet.js?brand_id=YOUR_ID' async></script>. For WordPress: use Insert Headers and Footers plugin.

For Shopify: edit theme.liquid. For Next.js: use the Script component. The snippet only detects AI bot visits — it does NOT track human visitors.

Note: most AI crawlers don't execute JavaScript, so this catches rendering bots (ChatGPT-User, Perplexity-User) but may miss pure crawlers..

Pro plan includes API access. Generate a key in Dashboard > Settings > API Keys. Authenticate with: X-API-Key: oblysk_pk_...

or Authorization: Bearer oblysk_pk_... Rate limit: 120 requests/minute. Endpoints: GET /api/v1/brands (list brands), POST /api/v1/brands (create brand), GET /api/v1/brands/:id/sov (Share of Voice), GET /api/v1/brands/:id/citations (citation analytics).

Full Swagger documentation at /api/docs..

Oblysk analyzes what content competitors have that you don't, then generates ready-to-use content briefs. Each brief includes: target prompt (the AI query to optimize for), suggested title, heading outline, key points to cover, recommended schema markup type, and word count target. Briefs are based on what's actually working for competitors who appear in AI responses.

Quick Fixes provide copy-paste code snippets for hallucination corrections — like adding Product schema markup with correct pricing..

Upgrade: visit the Pricing page or click any upgrade prompt. Downgrade: click Manage Billing in Settings to open the Stripe Customer Portal. Cancel: in the Portal, click Cancel.

Your access continues until the current period ends. Your data is preserved — upgrade anytime to restore access. Refund policy: monthly plans refundable within 7 days of charge.

Annual plans: prorated refund for unused months. Contact support@[domain]..

Share of Voice (SoV) measures what percentage of AI recommendations include your brand vs competitors. If AI mentions 5 brands when someone asks 'best project management tools' and you're one of them, your SoV for that query is 20%. Oblysk aggregates SoV across all queries and providers to give you a comprehensive view.

Track SoV over time to see if your AI mindshare is growing or shrinking relative to competitors..

Free: 1 scan per month, 1 AI platform, 10 queries. Starter ($19/mo): weekly full scans + weekly delta scans across 4 platforms with 25 queries. Pro ($49/mo): weekly full scans + daily delta scans across 7 platforms with 75 queries.

Delta scans check 5 key queries quickly — if scores change significantly, a full scan triggers automatically. Scheduled scans run automatically; you can also trigger manual scans anytime..

CSV Export (Starter+): downloads scan data with columns for prompt, provider, mention status, position, sentiment, accuracy issues. Includes SoV summary. PDF Report (Starter+): professional branded report with scores, findings, recommendations.

Pro users can white-label (remove Oblysk branding). JSON Export (Pro only): complete raw data for API integration or custom analysis..

Scan failed: usually caused by the target website being unreachable or blocking automated access. Try again, or contact support if persistent. Score seems wrong: scores reflect what AI platforms say at scan time.

AI responses change — run another scan to get current data. Not seeing mentions: your brand may be too new or niche for AI training data. Run a GEO Audit to check if AI crawlers can access your site.

Follow the optimization recommendations. Badge not showing: ensure the embed code is correctly placed and your site allows loading external images..