{
  "version": "1.0",
  "name": "TubeAnalytics",
  "description": "YouTube analytics platform for content creators - track video performance, analyze competitors, discover trends, and grow your channel",
  "website": "https://www.tubeanalytics.net",
  "api": {
    "baseUrl": "https://api.tubeanalytics.net/v1",
    "auth": {
      "type": "API Key",
      "header": "x-api-key",
      "plans": ["professional", "enterprise"]
    },
    "rateLimit": "1000 requests/day"
  },
  "endpoints": {
    "channels": {
      "list": {
        "method": "GET",
        "path": "/channels",
        "description": "List all connected YouTube channels"
      },
      "get": {
        "method": "GET",
        "path": "/channels/{channelId}",
        "description": "Get channel details and stats"
      },
      "connect": {
        "method": "POST",
        "path": "/channels/connect",
        "description": "Connect a new YouTube channel via OAuth"
      },
      "sync": {
        "method": "POST",
        "path": "/channels/{channelId}/sync",
        "description": "Force sync channel data from YouTube API"
      },
      "overview": {
        "method": "GET",
        "path": "/channels/{channelId}/overview",
        "description": "Get channel overview with key metrics"
      },
      "timeline": {
        "method": "GET",
        "path": "/channels/{channelId}/timeline",
        "description": "Get channel metrics over time"
      },
      "videos": {
        "method": "GET",
        "path": "/channels/{channelId}/videos",
        "description": "List all videos for a channel"
      },
      "revenue": {
        "method": "GET",
        "path": "/channels/{channelId}/revenue",
        "description": "Get revenue analytics (CPM/RPM)"
      },
      "growth": {
        "method": "GET",
        "path": "/channels/{channelId}/growth",
        "description": "Get subscriber and view growth metrics"
      },
      "audience": {
        "method": "GET",
        "path": "/channels/{channelId}/audience",
        "description": "Get audience demographics and geography"
      },
      "traffic-sources": {
        "method": "GET",
        "path": "/channels/{channelId}/traffic-sources",
        "description": "Get traffic source breakdown"
      },
      "engagement": {
        "method": "GET",
        "path": "/channels/{channelId}/engagement",
        "description": "Get engagement metrics (likes, comments, shares)"
      },
      "comments": {
        "method": "GET",
        "path": "/channels/{channelId}/comments",
        "description": "Get video comments with filters"
      },
      "cpm-analysis": {
        "method": "GET",
        "path": "/channels/{channelId}/cpm-analysis",
        "description": "Get CPM analysis by geography and ad type"
      },
      "video-scores": {
        "method": "GET",
        "path": "/channels/{channelId}/video-scores",
        "description": "Get performance scores for all videos"
      },
      "thumbnail-history": {
        "method": "GET",
        "path": "/channels/{channelId}/thumbnail-history",
        "description": "Get thumbnail change history"
      },
      "recommendations": {
        "method": "GET",
        "path": "/channels/{channelId}/recommendations",
        "description": "Get AI-powered content recommendations"
      }
    },
    "videos": {
      "analytics": {
        "method": "GET",
        "path": "/videos/{videoId}/analytics",
        "description": "Get detailed video analytics"
      }
    },
    "competitors": {
      "list": {
        "method": "GET",
        "path": "/competitors",
        "description": "List all tracked competitor channels"
      },
      "search": {
        "method": "GET",
        "path": "/competitors/search",
        "description": "Search for competitor channels"
      },
      "get": {
        "method": "GET",
        "path": "/competitors/{competitorId}",
        "description": "Get competitor details"
      },
      "analytics": {
        "method": "GET",
        "path": "/competitors/analytics",
        "description": "Get analytics for all competitors"
      },
      "comparison-charts": {
        "method": "GET",
        "path": "/competitors/comparison-charts",
        "description": "Get comparison charts data"
      },
      "gap-analysis": {
        "method": "GET",
        "path": "/competitors/gap-analysis",
        "description": "Analyze content gaps vs competitors"
      },
      "videos": {
        "method": "GET",
        "path": "/competitors/{competitorId}/videos",
        "description": "List competitor videos"
      },
      "sync-all": {
        "method": "POST",
        "path": "/competitors/sync-all",
        "description": "Sync all competitor data"
      }
    },
    "trends": {
      "topics": {
        "method": "GET",
        "path": "/trends/topics",
        "description": "Get trending topics in your niche"
      },
      "topic-detail": {
        "method": "GET",
        "path": "/trends/topics/{topicId}",
        "description": "Get detailed info for a specific topic"
      }
    },
    "thumbnailTests": {
      "list": {
        "method": "GET",
        "path": "/thumbnail-tests",
        "description": "List all thumbnail A/B tests"
      },
      "create": {
        "method": "POST",
        "path": "/thumbnail-tests",
        "description": "Create a new thumbnail test"
      },
      "get": {
        "method": "GET",
        "path": "/thumbnail-tests/{testId}",
        "description": "Get test details and results"
      },
      "analyze": {
        "method": "POST",
        "path": "/thumbnail-tests/{testId}/analyze",
        "description": "Analyze thumbnail variants with AI"
      },
      "historical": {
        "method": "GET",
        "path": "/thumbnail-tests/historical",
        "description": "Get historical thumbnail scores"
      }
    },
    "contentIdeas": {
      "list": {
        "method": "GET",
        "path": "/content-ideas",
        "description": "List AI-generated content ideas"
      },
      "generate": {
        "method": "POST",
        "path": "/content-ideas",
        "description": "Generate new content ideas with AI"
      },
      "get": {
        "method": "GET",
        "path": "/content-ideas/{ideaId}",
        "description": "Get specific content idea details"
      }
    },
    "experiments": {
      "topics": {
        "method": "GET",
        "path": "/experiments/topics",
        "description": "Get topic experiment results"
      },
      "config": {
        "method": "GET",
        "path": "/experiments/config",
        "description": "Get experiment configuration"
      }
    },
    "reports": {
      "list": {
        "method": "GET",
        "path": "/reports",
        "description": "List all reports"
      },
      "get": {
        "method": "GET",
        "path": "/reports/{reportId}",
        "description": "Get specific report"
      },
      "schedule": {
        "method": "GET",
        "path": "/reports/schedule",
        "description": "List scheduled reports"
      },
      "create-schedule": {
        "method": "POST",
        "path": "/reports/schedule",
        "description": "Create scheduled report"
      }
    },
    "contentCalendar": {
      "methods": {
        "GET": "List scheduled content",
        "POST": "Schedule new content",
        "PUT": "Update scheduled content",
        "DELETE": "Remove scheduled content"
      },
      "path": "/content-calendar",
      "description": "Manage content calendar and scheduling"
    },
    "transcripts": {
      "methods": {
        "GET": "Get video transcripts"
      },
      "path": "/transcripts",
      "description": "Get and download video transcripts"
    },
    "billing": {
      "subscription": {
        "method": "GET",
        "path": "/billing/subscription",
        "description": "Get current subscription details"
      },
      "invoices": {
        "method": "GET",
        "path": "/billing/invoices",
        "description": "List all invoices"
      },
      "create-checkout": {
        "method": "POST",
        "path": "/billing/create-checkout",
        "description": "Create checkout session"
      },
      "create-portal": {
        "method": "POST",
        "path": "/billing/create-portal",
        "description": "Create customer portal session"
      },
      "cancel": {
        "method": "POST",
        "path": "/billing/cancel",
        "description": "Cancel subscription"
      },
      "upgrade": {
        "method": "POST",
        "path": "/billing/upgrade",
        "description": "Upgrade subscription plan"
      }
    },
    "users": {
      "profile": {
        "method": "GET/PUT",
        "path": "/users/profile",
        "description": "Get or update user profile"
      },
      "preferences": {
        "method": "GET/PUT",
        "path": "/users/preferences",
        "description": "Get or update user preferences"
      },
      "export-data": {
        "method": "POST",
        "path": "/users/export-data",
        "description": "Export user data"
      },
      "change-password": {
        "method": "POST",
        "path": "/users/change-password",
        "description": "Change user password"
      },
      "2fa": {
        "method": "GET/POST",
        "path": "/users/2fa",
        "description": "Manage two-factor authentication"
      }
    },
    "keys": {
      "list": {
        "method": "GET",
        "path": "/keys",
        "description": "List API keys"
      },
      "create": {
        "method": "POST",
        "path": "/keys",
        "description": "Create new API key"
      },
      "delete": {
        "method": "DELETE",
        "path": "/keys/{keyId}",
        "description": "Delete API key"
      }
    },
    "affiliates": {
      "methods": {
        "GET": "Get affiliate info and stats"
      },
      "path": "/affiliates",
      "description": "Affiliate program management"
    },
    "contact": {
      "method": "POST",
      "path": "/contact",
      "description": "Submit contact form"
    },
    "support": {
      "chat": {
        "method": "POST",
        "path": "/support/chat",
        "description": "Get AI support assistant response"
      }
    }
  },
  "dataSchemas": {
    "channel": {
      "id": "string",
      "youtubeId": "string",
      "title": "string",
      "description": "string",
      "thumbnailUrl": "string",
      "subscriberCount": "number",
      "videoCount": "number",
      "viewCount": "number",
      "customUrl": "string",
      "country": "string",
      "joinedDate": "date"
    },
    "video": {
      "id": "string",
      "youtubeId": "string",
      "channelId": "string",
      "title": "string",
      "description": "string",
      "thumbnailUrl": "string",
      "publishedAt": "date",
      "duration": "string",
      "viewCount": "number",
      "likeCount": "number",
      "commentCount": "number",
      "performanceTier": "top | average | low"
    },
    "competitor": {
      "id": "string",
      "youtubeId": "string",
      "title": "string",
      "thumbnailUrl": "string",
      "subscriberCount": "number",
      "videoCount": "number",
      "viewCount": "number",
      "lastSynced": "date"
    },
    "audience": {
      "ageGroups": {
        "type": "object",
        "description": "Viewership by age: 13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65+"
      },
      "gender": {
        "type": "object",
        "description": "Gender breakdown: male, female, other"
      },
      "geography": {
        "type": "array",
        "description": "Top countries and cities by viewership"
      },
      "devices": {
        "type": "object",
        "description": "Device breakdown: mobile, desktop, tablet, TV"
      },
      "trafficSources": {
        "type": "array",
        "description": "Traffic sources: YouTube search, suggested, external, etc."
      }
    },
    "revenue": {
      "estimatedRevenue": "number",
      "cpm": "number",
      "rpm": "number",
      "adImpressions": "number",
      "clickThroughRate": "number",
      "geography": "array"
    },
    "thumbnailTest": {
      "id": "string",
      "videoId": "string",
      "status": "pending | processing | completed | failed",
      "variants": "array",
      "winner": "object | null",
      "scoreDifference": "number",
      "createdAt": "date"
    },
    "videoScore": {
      "videoId": "string",
      "overallScore": "number (0-100)",
      "ctr": "number",
      "retention": "number",
      "engagement": "number",
      "conversion": "number"
    },
    "trendTopic": {
      "id": "string",
      "topic": "string",
      "category": "string",
      "searchVolume": "number",
      "growthRate": "number",
      "competition": "low | medium | high"
    }
  },
  "tools": {
    "videoAnalytics": {
      "name": "Video Analytics",
      "description": "Track video performance metrics including view velocity, engagement heatmaps, and performance forecasting",
      "metrics": ["views", "watch time", "CTR", "retention", "likes", "comments", "shares"]
    },
    "audienceIntelligence": {
      "name": "Audience Intelligence",
      "description": "Understand your audience through demographics, retention curves, and geographic breakdown",
      "data": ["age groups", "gender", "location (country/city)", "device usage", "traffic sources"]
    },
    "competitorTracking": {
      "name": "Competitor Tracking",
      "description": "Monitor up to 20 competitor channels with benchmarking and gap analysis",
      "features": [
        "side-by-side comparison",
        "content gap detection",
        "benchmark alerts",
        "performance tracking"
      ]
    },
    "trendDiscovery": {
      "name": "Trend Discovery",
      "description": "Identify emerging topics before they peak across all regions",
      "data": ["trending topics", "search volume", "growth rate", "competition level"]
    },
    "aiThumbnailTesting": {
      "name": "AI Thumbnail Testing",
      "description": "CTR scoring via face detection, text clarity, and color analysis with A/B testing",
      "metrics": ["face score", "text score", "color score", "composition score", "overall score"]
    },
    "revenueOptimization": {
      "name": "Revenue Optimization",
      "description": "CPM analysis by geography, ad type performance, and sponsorship tracking",
      "data": ["CPM", "RPM", "estimated revenue", "geographic breakdown", "ad type performance"]
    },
    "seoTools": {
      "name": "SEO Tools",
      "description": "Video optimization suggestions for YouTube search",
      "features": [
        "keyword suggestions",
        "title optimization",
        "description optimization",
        "tag recommendations"
      ]
    },
    "videoTranscripts": {
      "name": "Video Transcripts",
      "description": "Download transcripts for content repurposing",
      "formats": ["text", "SRT", "VTT"]
    },
    "contentCalendar": {
      "name": "Content Calendar",
      "description": "Plan and schedule content with timezone support",
      "features": ["scheduling", "timezone optimization", "content planning", "publish reminders"]
    },
    "aiContentIdeas": {
      "name": "AI Content Ideas",
      "description": "AI-powered recommendations tailored to your channel",
      "features": [
        "topic suggestions",
        "title ideas",
        "trend-based recommendations",
        "competitor analysis"
      ]
    },
    "commentManager": {
      "name": "Comment Manager",
      "description": "Browse, filter, and reply to YouTube comments from dashboard",
      "features": [
        "multi-video inbox",
        "sentiment filtering",
        "priority ranking",
        "superfan identification"
      ]
    },
    "videoPerformanceScores": {
      "name": "Video Performance Scores",
      "description": "Composite performance grading (A-F) based on CTR, retention, subscriber conversion",
      "metrics": ["overall score", "CTR grade", "retention grade", "engagement grade"]
    },
    "topicExperiments": {
      "name": "Topic Experiments",
      "description": "Test new content directions and track performance against channel baseline",
      "features": ["experiment tagging", "baseline comparison", "result tracking"]
    },
    "externalApi": {
      "name": "REST API",
      "description": "Programmatic access to all YouTube analytics data",
      "access": "Professional and Enterprise plans",
      "endpoints": ["channels", "videos", "audience", "competitors", "analytics"]
    }
  },
  "pricing": {
    "starter": {
      "price": "$19/month",
      "channels": 1,
      "competitors": 5,
      "dataHistory": "90 days",
      "features": ["Basic analytics", "Email support"]
    },
    "professional": {
      "price": "$49/month",
      "channels": 3,
      "competitors": 10,
      "dataHistory": "1 year",
      "features": [
        "Advanced analytics",
        "AI insights",
        "Thumbnail testing",
        "Priority support",
        "API access"
      ]
    },
    "enterprise": {
      "price": "$149/month",
      "channels": 5,
      "competitors": 20,
      "dataHistory": "5 years",
      "features": [
        "White-label reports",
        "API access",
        "Dedicated account manager",
        "Phone support"
      ]
    },
    "annualDiscount": "20% off"
  },
  "integrations": {
    "youtube": {
      "name": "YouTube Data API v3",
      "description": "Official YouTube channel data and analytics",
      "auth": "OAuth 2.0"
    },
    "clerk": {
      "name": "Clerk",
      "description": "Authentication and user management"
    },
    "creem": {
      "name": "Creem",
      "description": "Payment processing and subscriptions"
    }
  },
  "metadata": {
    "founded": "2024",
    "founder": "Mike Holp",
    "certifications": ["SOC 2 Type II"],
    "users": "10,000+ creators",
    "videosAnalyzed": "10M+",
    "moneyBackGuarantee": "14 days"
  }
}