TubeAnalytics Documentation

TubeAnalytics is split across public marketing pages, the authenticated dashboard, and a machine-readable developer surface. This map shows where each part lives.

The fastest path to useful data is: create an account, connect a channel, let the initial sync complete, and then open the dashboard or developer surface that matches your use case.

1. Sign up at tubeanalytics.net.
2. Connect your YouTube channel with Google OAuth.
3. Grant the scopes required by the features you plan to use.
4. Wait for the first sync, then open the analytics or competitors dashboard.
5. If you are building software, review /developers and /openapi.json next.

1. Visit tubeanalytics.net
2. Click Get started
3. Sign in with Google
4. Approve the required permissions
5. Review the first sync on the dashboard
6. Open /developers if you need API keys or agent docs

TubeAnalytics uses Google OAuth 2.0 to connect a channel safely. The platform requests only the scopes it needs to read channel data, pull analytics, and power comments moderation when the feature is enabled.

The dashboard is organized around the questions creators ask first: how the channel is growing, which videos are winning, which competitors matter, and how revenue is changing. The implementation is split across route groups such as `/dashboard/analytics`, `/dashboard/competitors`, `/dashboard/thumbnails`, `/dashboard/reports`, and `/dashboard/settings`.

Competitor benchmarking is the flagship TubeAnalytics workflow. Add competitor channels by URL or search, then compare public metrics such as subscriber count, upload frequency, average views per video, and estimated RPM range. The public compare pages live under `/compare` and the in-app workflow lives under the competitor dashboard.

Charts help you compare growth and pacing, while export options make it easy to share a competitor summary with a teammate or client. The goal is not just to view numbers, but to answer what your next move should be. The public comparison pages are the human summary, while the dashboard and API hold the working data.

Revenue tracking unifies ad revenue and non-AdSense income into a single view. The dashboard routes under `/dashboard/billing` and `/dashboard/monetization/optimization` show revenue context, while the API surfaces the same concepts under `/api/v1/channels/:channelId/revenue` and `/api/v1/channels/:channelId/cpm-analysis`.

AI Content Insights generates title suggestions, thumbnail feedback, tag recommendations, and a performance prediction score. The connected experience spans the dashboard, `/api/v1/ai/generate-ideas`, the thumbnail tooling, and the machine-readable discovery files used by AI clients.

The output is designed to be actionable. A recommendation should point to a change you can make on the next upload, not just a generalized observation about the channel. Trend detection and competitor analysis feed the same decision layer.

The Viral Script Generator streams completions from the `gpt-4.1` model for creating long-form YouTube scripts. Users choose a topic, target audience, desired length, and a virality framework such as hook-story-offer, listicle, or challenge format.

{
  "topic": "How to benchmark competitors",
  "targetAudience": "YouTube creators",
  "videoLengthMinutes": 8,
  "framework": "listicle"
}

Comments Manager gives you one unified inbox for all videos. It uses the YouTube OAuth 2.0 permission set that includes `youtube.force-ssl`, so the platform can view, reply, approve, hold, delete, and flag comments for follow-up.

This section defines the core analytics concepts available across the dashboard and API. Each metric is documented with what it measures and what action it supports.

Channel Analytics

Video Performance

Video Performance is a sortable table of every video with the metrics most creators use to make decisions: views, watch time, CTR, average view duration, estimated revenue, and the AI performance score.

Audience Insights

Audience Insights breaks down age and gender, geography, device type, and traffic source. Charts include bar charts and geography views so you can tell not only who watches, but where and on what device they watch from.

Revenue Breakdown

Revenue Breakdown lets you inspect revenue by stream, by video, and by time period. Use it to compare RPM and CPM, spot top earning videos, and understand how much of your monthly income comes from each monetization source.

TubeAnalytics uses YouTube Data API v3 endpoints to power connected channel workflows. The app reads channel metadata, video lists, search results, comments, and analytics reports on behalf of the signed-in user.

Webhooks keep the account and billing state in sync. The current implementation uses a Clerk webhook for user lifecycle events and a Creem webhook for checkout and subscription events, with the database as the source of truth.

{
  "type": "user.created",
  "data": {
    "id": "user_123",
    "primary_email_address_id": "idn_456",
    "email_addresses": [{ "id": "idn_456", "email_address": "creator@example.com" }],
    "first_name": "Mia",
    "last_name": "Lopez"
  }
}

{
  "type": "checkout.completed",
  "customer": { "id": "cust_123" },
  "subscription": {
    "id": "sub_123",
    "current_period_start_date": "2026-05-25T00:00:00Z",
    "current_period_end_date": "2026-06-25T00:00:00Z"
  },
  "metadata": { "userId": "user_123" }
}

{
  "type": "subscription.paid",
  "id": "sub_123",
  "last_transaction": {
    "id": "txn_123",
    "amount": 4900,
    "currency": "USD"
  }
}

{
  "type": "subscription.canceled",
  "id": "sub_123",
  "metadata": { "userId": "user_123" }
}

These are the machine-readable files the codebase keeps current for agent tooling, documentation generators, and integration checks. If you are building with AI clients or verifying the product surface, start here.

TubeAnalytics offers three tiers with a 7-day free trial and plan limits backed by the product contract. See the pricing page for full details.

Billing is handled through Creem. From the billing area you can update payment details, view invoices, pause a subscription, or cancel it. Cancellation takes effect at the end of the current billing period.

API keys let users access TubeAnalytics programmatically. Create a key from the account settings page, choose a scope, and copy the token once. You can revoke keys at any time.

Authorization: Bearer <token>

Professional and Enterprise plans support team members. Invite someone by email, assign a role, and remove access when they no longer need it.

The external API is documented in full on the /developers page with authentication, error codes, rate limits, and curl examples.

Base URL: https://tubeanalytics.net/api/external/v1

Rate limits depend on plan tier. The signed-in API key path is available on Professional and Enterprise plans, while Starter users do not get external API access. The codebase enforces a sliding-window limit on key-auth requests, and the response headers include `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`.

A JavaScript / TypeScript SDK is planned, and a Python SDK is on the roadmap. Until the SDK ships, you can call the REST API directly from fetch or your preferred HTTP client.

const response = await fetch("https://tubeanalytics.net/api/external/v1/channels", {
  headers: {
    Authorization: "Bearer <token>",
  },
});

const data = await response.json();

See the full changelog for the complete release history. Recent releases:

Email support at support@tubeanalytics.net. Response time is within 24 hours on business days.

Join the TubeAnalytics Discord community to compare workflows, share feature requests, and ask other creators how they are using analytics, competitor benchmarking, and AI tools in practice.

discord.gg/tubeanalytics