⚡ Quick Reference

Essential commands, endpoints, and code snippets for GenieOptimize

SDK Installation

Basic Setup

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

Placement

Verification

// Check browser console
console.log('[GenieOptimize] SDK loaded');

// Check dashboard
Dashboard → Optimizations → Look for green "Setup Complete"

API Endpoints

Method Endpoint Description
POST /api/analyze Analyze a page URL
GET /api/optimizations Get all optimizations
GET /api/stats Get analytics stats
POST /api/recommendations/:id/generate Generate recommendations
GET /v1/sdk/status/:projectId Check SDK installation
GET /api/llmstxt Download llms.txt file

Authentication

Authorization: Bearer YOUR_AUTH_TOKEN

Common Tasks

Analyze a Page

POST /api/analyze
{
  "url": "https://example.com",
  "projectId": "proj_123"
}

Get SDK Status

GET /v1/sdk/status/proj_123

Response:
{
  "installed": true,
  "lastSeen": "2026-01-24...",
  "beaconCount": 42
}

Download llms.txt

GET /api/llmstxt

Place at:
https://domain.com/llms.txt

Generate Recommendations

POST /api/recommendations/
     proj_123/generate

Status: 202 (Processing)
Check status in dashboard

Meta Tags Template

<!-- Basic -->
<meta name="description" content="Clear, concise description">

<!-- Open Graph -->
<meta property="og:title" content="Page Title">
<meta property="og:description" content="Description">
<meta property="og:image" content="https://example.com/image.jpg">
<meta property="og:url" content="https://example.com/page">

<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Page Title">
<meta name="twitter:description" content="Description">

JSON-LD Schemas

Organization

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Company Name",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png"
}
</script>

Product

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

FAQ

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Question here?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Direct answer here"
    }
  }]
}
</script>

llms.txt Format

# Company Name llms.txt

# Main Pages
https://example.com/ - Homepage
https://example.com/about - About us
https://example.com/product - Product information

# Documentation
https://example.com/docs - Documentation
https://example.com/guides - Guides and tutorials

# Recommendations
https://example.com/use-cases - Use cases
https://example.com/vs/competitor - Comparisons

Troubleshooting Commands

Check SDK Loading

// In browser console
console.log('[GenieOptimize]');

// Should see:
[GenieOptimize] SDK loaded
[GenieOptimize] Version: 1.0.0

Verify API Key

// Check format
ak_live_* - Production key
ak_test_* - Test key

// Length: Usually 32+ characters after prefix

Test llms.txt

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

# Should return 200 OK with content

Check Bot Crawling

# Check robots.txt allows AI bots
User-agent: GPTBot
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: PerplexityBot
Allow: /

Dashboard Shortcuts

Page What to Do
Optimizations Check SDK status, view generated content, download llms.txt
Analytics Track bot visits, see trending pages, monitor growth
Recommendations Generate AI-powered recommendations, view score, refine results
Projects Manage multiple websites, get API keys, create new projects

Key Concepts

Visibility Layer

Citations - Ensures AI can find and cite your content via meta tags, schemas, and llms.txt

Recommendation Layer

Recommendations - Teaches AI when to recommend your product via use cases and positioning

SDK Beacon

Heartbeat signal sent when SDK loads - tracks installation status (24hr window)

Recommendation Score

0-100 score measuring how recommendation-ready your product is for AI assistants

Plan Limits

Feature Free PRO PRO+
Projects 1 5 Unlimited
Page Analysis 5/month 100/month Unlimited
SDK
Analytics Basic Advanced Advanced
Recommendations

Need Help?

support@genieoptimize.com
Full Documentation