Introduction

Welcome to Opttab developer documentation

Opttab Agent Analytics & AI Marketplace

See how AI sees your website with enterprise-grade analytics. Opttab provides AI models with ethical access to training data while ensuring fair compensation for content creators. Our comprehensive API enables seamless integration for AI visibility tracking, content monetization, and campaign management.

What is Opttab?

Opttab is the world's first comprehensive platform for AI model visibility and ethical data acquisition. We help content creators, businesses, and AI models interact transparently through:

  • AI Visibility Analytics - Track how AI models perceive and cite your content
  • GEO Score Optimization - Optimize your content for AI training datasets
  • Content Monetization - Earn revenue from AI model usage
  • Ethical Data Marketplace - Connect AI models with quality training data
  • Campaign Management - Promote your assets in AI responses

Integration Guides

Opttab seamlessly integrates with any website or application, providing powerful analytics and monetization tools. Whether you're an AI model developer or a content creator, we have solutions for you.

Quick Start

Get started with Opttab's APIs in just a few minutes:

1

Sign Up

Create a free account at opttab.com/register

2

Generate API Key

Navigate to Dashboard → API Settings → Generate new API key

3

Make Your First Request

Test the API with a simple request to get your account information:

curl "https://opttab.com/api/v1/ai/budget-status" \
  -H "X-API-Key: your_api_key_here" \
  -H "X-API-Secret: your_secret_here"
4

Explore Documentation

Browse our comprehensive API documentation to learn about all available endpoints

Key Features

AI Visibility Analytics

Track how AI models like ChatGPT, Gemini, and Claude perceive and cite your content. Get real-time insights into your AI visibility score.

Content Monetization

Earn revenue from your content through our ethical AI marketplace. Set your own pricing and get paid automatically.

GEO Score Optimization

AI-powered recommendations to optimize your content for maximum visibility in AI training datasets and responses.

Campaign Management

Promote your assets directly in AI responses. Track impressions, clicks, and conversions across multiple AI models.

Base URLs

https://opttab.com/api/v1/user
https://opttab.com/api/v1/ai

AI Crawl Analytics Integration

Monitor how AI bots like GPTBot, ClaudeBot, and PerplexityBot crawl your website. Track crawl frequency, patterns, and verify opt-out compliance.

Server-Side Integration

Send HTTP request logs from your server to track AI crawler activity:

1. Get Your API Key

Navigate to Analytics → AI Crawl Analytics in your dashboard to find your unique API key.

2. Send Crawler Data

POST https://opttab.com/api/v1/ai-analytics/ingest
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "logs": [{
    "user_agent": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; GPTBot/1.0)",
    "request_path": "/blog/post-slug",
    "status_code": 200,
    "client_ip": "192.168.1.1",
    "timestamp": "2025-10-29T12:00:00Z",
    "referrer": "https://google.com",
    "crawl_depth": 2,
    "content_length": 45678
  }]
}

3. Platform-Specific Examples

Nginx (Log Forwarding)

log_format ai_tracking '$remote_addr - [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent"';

access_log /var/log/nginx/ai-crawl.log ai_tracking;

Cloudflare Workers

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const userAgent = request.headers.get('user-agent')
  
  // Detect AI bots
  if (isAIBot(userAgent)) {
    await logToOpttab({
      user_agent: userAgent,
      request_path: new URL(request.url).pathname,
      timestamp: new Date().toISOString()
    })
  }
  
  return fetch(request)
}

Supported AI Bots

Opttab automatically detects and classifies these AI bot crawlers:

  • GPTBot - OpenAI's web crawler for training GPT models
  • ClaudeBot - Anthropic's AI training data collector
  • PerplexityBot - Perplexity AI's search indexing bot
  • Google-Extended - Google's Gemini training crawler
  • Bingbot - Microsoft's Copilot data acquisition
  • MetaBot - Meta's AI training crawler
  • And 15+ more AI model crawlers

AI Website Analytics Integration

Track visitors coming from AI platforms like ChatGPT, Perplexity, Claude, and understand how AI-driven discovery impacts your traffic.

Client-Side Integration

Add a simple JavaScript snippet to your website to start tracking AI platform traffic:

1. Get Your Tracking Token

Navigate to Analytics → AI Website Analytics in your dashboard to get your tracking token.

2. Add Tracking Code

Paste this code in your website's <head> section:

<script>
  window.opttabConfig = {
    token: 'YOUR_TRACKING_TOKEN',
    apiUrl: 'https://opttab.com/api/v1/ai-analytics/track'
  };
</script>
<script src="/js/opttab-analytics.js"></script>

3. Verify Installation

After installation, click "I've Implemented This" in your dashboard to verify the integration. Data will appear within 24 hours.

Detected AI Platforms

Opttab automatically identifies traffic from these AI platforms:

  • ChatGPT (chat.openai.com) - OpenAI's conversational AI
  • Perplexity AI (perplexity.ai) - AI-powered answer engine
  • Claude (claude.ai) - Anthropic's AI assistant
  • Google Gemini (gemini.google.com) - Google's multimodal AI
  • Microsoft Copilot (copilot.microsoft.com) - Microsoft's AI assistant
  • You.com - AI-powered search engine
  • Phind - Developer-focused AI search
  • Kagi - Privacy-focused AI search

Analytics & Insights

Both AI Crawl and Website Analytics provide comprehensive insights:

  • Traffic Volume - Real-time bot/visitor counts from AI sources
  • Top Pages - Most accessed content by AI crawlers or referred visitors
  • Activity Timeline - Visualize crawl patterns and traffic trends
  • Bot Breakdown - Detailed metrics per AI model/platform
  • Engagement Metrics - Time on site, bounce rate, conversion tracking
  • Intent Analysis - Understand what users are looking for from AI platforms

Need Help?

Our team is here to support you every step of the way. For personalized assistance with your integration:

Ready to get started?

Choose your integration path and dive into our comprehensive API documentation.