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.
User API
Access and manage your assets, analytics, and campaigns programmatically
- • Asset Management
- • Analytics Data Access
- • Campaign Control
AI Model API
Ethical access to training data with Model Context Protocol (MCP)
- • Content Request Marketplace
- • Asset Licensing
- • Usage Tracking
Content Requests
Request custom content from creators with demographic targeting
- • Create targeted requests
- • Review submissions
- • Automatic payment (80/20)
Asset Monetization
License datasets and content with flexible pricing models
- • Per-training pricing
- • Per-response pricing
- • One-time & subscriptions
Quick Start
Get started with Opttab's APIs in just a few minutes:
Sign Up
Create a free account at opttab.com/register
Generate API Key
Navigate to Dashboard → API Settings → Generate new API key
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"
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.