API Docs / Overview

Overview

The Tuberalytics API provides programmatic access to YouTube niche research, channel analytics, and Skool revenue intelligence. Build integrations, automate workflows, and power dashboards with real-time data.

Base URL

All API requests use the following base URL:

https://tuberalytics.com/api/v1

Versioning

The API is versioned via the URL path (/api/v1). We will introduce new versions for breaking changes and maintain previous versions for a reasonable deprecation period.

Content Type

All requests and responses use JSON. Set the following header on requests with a body:

Content-Type: application/json

Authentication

Every request requires a Bearer token in the Authorization header. See Authentication for details.

Authorization: Bearer sk_live_your_api_key

Response Format

All successful responses wrap data in a data key:

{
  "data": {
    "id": 42,
    "title": "Example Channel"
  }
}

Paginated responses include a meta object:

{
  "data": [ ... ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total_pages": 10,
    "total_count": 250
  }
}

Error Format

Error responses include an error key with a human-readable message:

{
  "error": "Not found: Channel"
}

Some errors include additional context. See Errors for the full list.

Pagination

Paginated endpoints accept page and per_page query parameters:

Parameter Type Default Description
page integer 1 Page number
per_page integer 25 Results per page (max: 100)

Quick Start

  1. Create an API key from your API Keys page
  2. Make your first request — search for channels in a niche:
curl -X GET "https://tuberalytics.com/api/v1/channels/search?q=ai+automation" \
  -H "Authorization: Bearer sk_live_your_api_key"
  1. Explore the data — get channel details, videos, competitors, and more

Endpoints Summary

Section Endpoints Description
Channels 7 Search, show, profile, videos, competitors, keywords, Skool
Videos 4 Search, show, transcript, comments
Niches 5 Search, show, channels, keywords, videos
Leaderboards 3 Top channels, videos, niches
Account 3 Profile, tracked channels, usage
Actions 5 Analyze, discover, generate, create
Webhooks 4 CRUD for webhook endpoints

Total: 31 endpoints

LLM-Friendly Documentation

If you're building AI agents or LLM-powered integrations, machine-readable versions of this documentation are available:

URL Description
/llms.txt Short summary with endpoint listing
/llms-full.txt Complete API reference in plain text

These follow the llms.txt standard and are designed to be fed directly into LLM context windows.