A YouTube analytics and research API that lets you search channels, find viral outliers, fetch video details, transcripts, comments, and run automated scans for niche research and competition analysis.

How do I authenticate?

Use an API key in the Authorization header: Authorization: Api-Key $TUBELAB_API_KEY. Get the key from https://tubelab.net/developers (active subscription required).

How do credits and rate limits work?

Requests are rate-limited to 10 per minute per API key. Most endpoints cost credits (e.g., 10–100 credits), while some like /channel/videos/{id}, /video/{id} are free. Scans cost 50 credits (Fast) or 100 credits (Standard) per run; exceeding limits may return 429 Too Many Requests.

YouTube Outliers & Niche Finder Data by TubeLab

Verified

@antoniojps

npx machina-cli add skill @antoniojps/tubelab-api --openclaw

Files (1)

SKILL.md

28.9 KB

TubeLab API

YouTube analytics and research API. Discover profitable niches, find viral outlier videos, analyze channels, get transcripts and comments, and run automated scans - all through REST endpoints returning JSON.

Base URL: https://public-api.tubelab.net/v1
Auth: API key in header
Rate limit: 10 requests/minute per API key
Format: JSON request/response
Docs: https://tubelab.net/docs/api/introduction

Authentication

Every request requires an Authorization header with your API key:

Authorization: Api-Key $TUBELAB_API_KEY

Get your API key at https://tubelab.net/developers - requires an active subscription.

Rate Limits & Credits

Rate limited to 10 requests per minute per API key. Exceeding this returns 429 Too Many Requests.

Most endpoints cost credits. Cached responses (same request within a short window) are free.

Endpoint	Cost
`GET /search/channels`	10 credits
`GET /search/channels/related`	10 credits
`GET /search/outliers`	5 credits
`GET /search/outliers/related`	5 credits
`GET /channel/videos/{id}`	free
`GET /channel/shorts/{id}`	free
`GET /video/{id}`	free
`GET /video/transcript/{id}`	free
`GET /video/comments/{id}`	free
`POST /scan`	50–100 credits
`GET /scan/{id}`	free

Scan cost depends on mode: Fast = 50 credits, Standard = 100 credits.

Search Endpoints

Search for YouTube channels and viral videos (outliers). All search endpoints support pagination, sorting, and 30+ filters.

GET /search/channels

Channels Search for channels directly from the YouTube Niche Finder with AI enhanced data and 30+ filters. Cost: 10 credits per request.

curl -s "https://public-api.tubelab.net/v1/search/channels?query=minecraft%20adventures" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Query parameters:

Name	Type	Required	Description
`query`	string[]	no	Search queries
`seed`	string \| number \| null	no	Randomize search results by passing a random seed
`filterBy`	"video" \| "short"	no	Filter by statistics of each content kind
`contentKind`	"video" \| "short" \| "long-form" \| "short-form"	no	Filter by type of content created by channel: - `video` - channel has videos; - `short` - channel has shorts; - `long-form` - channel has more...
`publishedAtFrom`	string	no	Filter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.
`publishedAtTo`	string	no
`averageViewsFrom`	integer	no
`averageViewsTo`	integer	no
`medianViewsFrom`	integer	no
`medianViewsTo`	integer	no
`language`	string[]	no	ISO 639-1 language codes
`avgViewsToSubscribersRatioFrom`	number	no	Filter by the outlier score of a channel
`avgViewsToSubscribersRatioTo`	number	no
`subscribersFrom`	integer	no
`subscribersTo`	integer	no
`videosCountFrom`	integer	no
`videosCountTo`	integer	no
`viewVariationCoefficientFrom`	number	no
`viewVariationCoefficientTo`	number	no
`revenueMonthlyEstimationFrom`	number	no
`revenueMonthlyEstimationTo`	number	no
`rpmEstimationFrom`	number	no
`rpmEstimationTo`	number	no
`avgDurationFrom`	integer	no	Average duration of videos in seconds
`avgDurationTo`	integer	no
`monetizationAdsense`	boolean	no	Filter by whether the channel has AdSense enabled or not
`excludeNiche`	string[]	no	Exclude niches from search results by keywords
`classificationQuality`	"negative" \| "neutral" \| "positive"	no	AI classification of a channel quality.
`classificationIsFaceless`	boolean	no	AI classification wether channel content has faceless potential or not
`from`	integer	no	Page to fetch
`size`	integer	no	Number of items per page
`sortBy`	"subscribers" \| "averageViews" \| "avgViewsToSubscribersRatio" \| "viewVariationCoefficient" \| "revenueMonthly" \| "rpm" \| "foundAt" \| "recency"	no	Sort results by a specific metric: Beaware when using semantic search (applying a query with the `by` parameter set to `semantic`) the sorting...
`sortOrder`	"asc" \| "desc"	no	Sorting order of results, where asc is ascending and desc is descending

Response shape (abbreviated):

{
  "pagination": { "total": 100, "from": 0, "size": 20 },
  "hits": [
    {
      "id": "UChn5jutPQB_bRjnG80pzl5w",
      "snippet": { "handle": "@tubelabhq", "title": "TubeLab", "contentKind": ["video","long-form"] },
      "statistics": { "subscribers": 15000, "averageViews": 5000, "avgViewsToSubscribersRatio": 0.33 },
      "language": { "code": "en" },
      "monetization": { "adsense": true },
      "classification": { "quality": "positive", "isFaceless": false }
    }
  ]
}

GET /search/channels/related

Similar Channels Search for YouTube channels with related content to another channel. Cost: 10 credits per request.

curl -s "https://public-api.tubelab.net/v1/search/channels/related?relatedChannelId=UChn5jutPQB_bRjnG80pzl5w" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Query parameters:

Name	Type	Required	Description
`relatedChannelId`	string[]	yes
`filterBy`	"video" \| "short"	no	Filter by statistics of each content kind
`contentKind`	"video" \| "short" \| "long-form" \| "short-form"	no	Filter by type of content created by channel: - `video` - channel has videos; - `short` - channel has shorts; - `long-form` - channel has more...
`publishedAtFrom`	string	no	Filter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.
`publishedAtTo`	string	no
`averageViewsFrom`	integer	no
`averageViewsTo`	integer	no
`medianViewsFrom`	integer	no
`medianViewsTo`	integer	no
`language`	string[]	no	ISO 639-1 language codes
`avgViewsToSubscribersRatioFrom`	number	no	Filter by the outlier score of a channel
`avgViewsToSubscribersRatioTo`	number	no
`subscribersFrom`	integer	no
`subscribersTo`	integer	no
`videosCountFrom`	integer	no
`videosCountTo`	integer	no
`viewVariationCoefficientFrom`	number	no
`viewVariationCoefficientTo`	number	no
`revenueMonthlyEstimationFrom`	number	no
`revenueMonthlyEstimationTo`	number	no
`rpmEstimationFrom`	number	no
`rpmEstimationTo`	number	no
`avgDurationFrom`	integer	no	Average duration of videos in seconds
`avgDurationTo`	integer	no
`monetizationAdsense`	boolean	no	Filter by whether the channel has AdSense enabled or not
`excludeNiche`	string[]	no	Exclude niches from search results by keywords
`classificationQuality`	"negative" \| "neutral" \| "positive"	no	AI classification of a channel quality.
`classificationIsFaceless`	boolean	no	AI classification wether channel content has faceless potential or not
`from`	integer	no	Page to fetch
`size`	integer	no	Number of items per page

Response shape (abbreviated):

{
  "pagination": { "total": 50, "from": 0, "size": 20 },
  "hits": [
    {
      "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "snippet": { "handle": "@example", "title": "Example Channel", "contentKind": ["video"] },
      "statistics": { "subscribers": 25000, "averageViews": 8000 },
      "language": { "code": "en" }
    }
  ]
}

GET /search/outliers

Outliers Search for videos directly from the YouTube Outliers Finder library with AI enhanced data and 30+ filters. Cost: 5 credits per request.

curl -s "https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Query parameters:

Name	Type	Required	Description
`query`	string[]	no	Search queries
`seed`	string \| number \| null	no	Randomize search results by passing a random seed
`sortBy`	"views" \| "zScore" \| "averageViewsRatio" \| "publishedAt" \| "revenue" \| "rpm"	no	Sort results by a specific metric: Beaware when using semantic search (applying a query with the `by` parameter set to `semantic`) the sorting...
`sortOrder`	"asc" \| "desc"	no	Sorting order of results, where asc is ascending and desc is descending
`type`	"video" \| "short"	no
`averageViewsRatioFrom`	number	no
`averageViewsRatioTo`	number	no
`zScoreFrom`	number	no
`zScoreTo`	number	no
`viewCountFrom`	integer	no
`viewCountTo`	integer	no
`language`	string[]	no	ISO 639-1 language codes
`durationFrom`	integer	no
`durationTo`	integer	no
`publishedAtFrom`	string \| string	no
`publishedAtTo`	string	no
`subscribersCountFrom`	integer	no
`subscribersCountTo`	integer	no
`channelAvgViewsFrom`	number	no
`channelAvgViewsTo`	number	no
`channelVideoCountFrom`	integer	no
`channelVideoCountTo`	integer	no
`channelId`	string	no
`channelAvgViewsToSubscribersRatioFrom`	number	no
`channelAvgViewsToSubscribersRatioTo`	number	no
`titlePattern`	string	no
`referenceId`	string	no
`rpmEstimationFrom`	number	no
`rpmEstimationTo`	number	no
`revenueEstimationFrom`	number	no
`revenueEstimationTo`	number	no
`channelMonetizationAdsense`	boolean	no
`classificationQuality`	"negative" \| "neutral" \| "positive"	no
`classificationIsFaceless`	boolean	no
`excludeKeyword`	string[]	no
`from`	integer	no	Page to fetch
`size`	integer	no	Number of items per page
`by`	"semantic" \| "lexical"	no	Search by semantics (meaning of words) or lexical (exact words)

Response shape (abbreviated):

{
  "pagination": { "total": 100, "from": 0, "size": 20 },
  "hits": [
    {
      "id": "SVeXR66hcIg",
      "kind": "video",
      "snippet": { "channelId": "UChn5jutPQB_bRjnG80pzl5w", "title": "Video Title", "channelTitle": "Channel Name", "publishedAt": "2025-01-15T00:00:00Z" },
      "statistics": { "viewCount": 500000, "zScore": 4.2, "averageViewsRatio": 10.5, "likeCount": 15000, "commentCount": 1200 },
      "classification": { "quality": "positive", "isFaceless": false }
    }
  ]
}

GET /search/outliers/related

Similar Outliers Search for YouTube outliers with related content to another outlier(s). Cost: 5 credits per request.

curl -s "https://public-api.tubelab.net/v1/search/outliers/related?title=minecraft%20survival%20tutorial&type=video&by=semantic" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Query parameters:

Name	Type	Required	Description
`title`	string[]	no
`videoId`	string[]	no
`thumbnailVideoId`	string	no	A unique YouTube video identifier
`relatedChannelId`	string[]	no
`type`	"video" \| "short"	no
`averageViewsRatioFrom`	number	no
`averageViewsRatioTo`	number	no
`zScoreFrom`	number	no
`zScoreTo`	number	no
`viewCountFrom`	integer	no
`viewCountTo`	integer	no
`language`	string[]	no	ISO 639-1 language codes
`durationFrom`	integer	no
`durationTo`	integer	no
`publishedAtFrom`	string \| string	no
`publishedAtTo`	string	no
`subscribersCountFrom`	integer	no
`subscribersCountTo`	integer	no
`channelAvgViewsFrom`	number	no
`channelAvgViewsTo`	number	no
`channelVideoCountFrom`	integer	no
`channelVideoCountTo`	integer	no
`channelId`	string	no
`channelAvgViewsToSubscribersRatioFrom`	number	no
`channelAvgViewsToSubscribersRatioTo`	number	no
`titlePattern`	string	no
`referenceId`	string	no
`rpmEstimationFrom`	number	no
`rpmEstimationTo`	number	no
`revenueEstimationFrom`	number	no
`revenueEstimationTo`	number	no
`channelMonetizationAdsense`	boolean	no
`classificationQuality`	"negative" \| "neutral" \| "positive"	no
`classificationIsFaceless`	boolean	no
`excludeKeyword`	string[]	no
`from`	integer	no	Page to fetch
`size`	integer	no	Number of items per page
`by`	"semantic" \| "lexical"	no	Search by semantics (meaning of words) or lexical (exact words)

Response shape (abbreviated):

{
  "pagination": { "total": 50, "from": 0, "size": 20 },
  "hits": [
    {
      "id": "dQw4w9WgXcQ",
      "kind": "video",
      "snippet": { "channelId": "UChn5jutPQB_bRjnG80pzl5w", "title": "Similar Video", "publishedAt": "2025-02-01T00:00:00Z" },
      "statistics": { "viewCount": 120000, "zScore": 3.1, "averageViewsRatio": 5.2 }
    }
  ]
}

Channel & Video Endpoints

Get detailed information about specific channels and videos.

GET /channel/videos/{id}

Channel Videos Get videos from a YouTube channel with sampled metrics. Cost: free per request.

curl -s "https://public-api.tubelab.net/v1/channel/videos/UChn5jutPQB_bRjnG80pzl5w" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Path parameters:

Name	Type	Description
`id`	string	A unique YouTube channel identifier

Response shape (abbreviated):

{
  "id": "UChn5jutPQB_bRjnG80pzl5w",
  "time": "2025-06-15T12:00:00Z",
  "item": {
    "id": "UChn5jutPQB_bRjnG80pzl5w",
    "kind": "channel",
    "snippet": { "title": "TubeLab", "handle": "@tubelabhq" },
    "videos": [{ "id": "SVeXR66hcIg", "title": "Video Title", "viewCount": 50000, "publishedAt": "2025-01-15T00:00:00Z" }],
    "statistics": { "subscribers": 15000, "totalViews": 500000, "videoCount": 120 }
  }
}

GET /channel/shorts/{id}

Channel Shorts Get shorts from a YouTube channel with sampled metrics. Cost: free per request.

curl -s "https://public-api.tubelab.net/v1/channel/shorts/UChn5jutPQB_bRjnG80pzl5w" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Path parameters:

Name	Type	Description
`id`	string	A unique YouTube channel identifier

Response shape (abbreviated):

{
  "id": "UChn5jutPQB_bRjnG80pzl5w",
  "time": "2025-06-15T12:00:00Z",
  "item": {
    "id": "UChn5jutPQB_bRjnG80pzl5w",
    "kind": "channel",
    "snippet": { "title": "TubeLab", "handle": "@tubelabhq" },
    "shorts": [{ "id": "abc123", "title": "Short Title", "viewCount": 100000, "publishedAt": "2025-03-01T00:00:00Z" }],
    "statistics": { "subscribers": 15000, "totalViews": 500000 }
  }
}

GET /video/{id}

Video Details Get details of a YouTube video. Cost: free per request.

curl -s "https://public-api.tubelab.net/v1/video/SVeXR66hcIg" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Path parameters:

Name	Type	Description
`id`	string	A unique YouTube video identifier

Response shape (abbreviated):

{
  "ids": ["SVeXR66hcIg"],
  "time": "2025-06-15T12:00:00Z",
  "items": [
    {
      "id": "SVeXR66hcIg",
      "kind": "video",
      "snippet": { "channelId": "UChn5jutPQB_bRjnG80pzl5w", "title": "Video Title", "publishedAt": "2025-01-15T00:00:00Z" },
      "statistics": { "viewCount": 50000, "likeCount": 2000, "commentCount": 300 }
    }
  ]
}

GET /video/transcript/{id}

Video Transcript Get the transcript of a YouTube video. Cost: free per request.

curl -s "https://public-api.tubelab.net/v1/video/transcript/SVeXR66hcIg" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Path parameters:

Name	Type	Description
`id`	string	A unique YouTube video identifier

Response shape (abbreviated):

{
  "ids": ["SVeXR66hcIg"],
  "items": [
    {
      "id": "SVeXR66hcIg",
      "events": [{ "startMs": 0, "durationMs": 5000, "endMs": 5000, "text": "Hello and welcome..." }],
      "transcript": "Hello and welcome to this video..."
    }
  ]
}

GET /video/comments/{id}

Video Comments Get the last 100 comments of a YouTube video. Cost: free per request.

curl -s "https://public-api.tubelab.net/v1/video/comments/SVeXR66hcIg" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Path parameters:

Name	Type	Description
`id`	string	A unique YouTube video identifier

Response shape (abbreviated):

{
  "ids": ["SVeXR66hcIg"],
  "time": "2025-06-15T12:00:00Z",
  "items": [
    {
      "id": "SVeXR66hcIg",
      "comments": [{ "authorText": "User", "text": "Great video!", "likesCount": 42, "replyCount": 3, "publishedAt": "2025-01-16T00:00:00Z" }],
      "statistics": { "count": 300 }
    }
  ]
}

Scanning Endpoints

Start YouTube scans to discover channels and outlier videos in any niche. Scans run asynchronously - start one, then poll for status.

POST /scan

Scan Start a YouTube scan to search for outliers and channels on any given topic. Cost: 50–100 credits per request.

curl -s -X POST "https://public-api.tubelab.net/v1/scan" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"findBy":"query","query":["UCUyeluBRhGPCW4rPe_UvBZQ","UCX6OQ3DkcsbYNE6H8uQQuVA"],"mode":"standard"}'

Body parameters:

Name	Type	Required	Default	Description
`findBy`	"channels" \| "query"	no	`query`	Start the scan from queries (search results) or channels
`query`	string[]	yes		Search queries or YouTube channel ids
`mode`	"fast" \| "standard"	no	`fast`	- Fast: 1000 outliers or 100 channels - Standard: 2500 outliers or 250 channels

Response shape (abbreviated):

{
  "id": "2a5e56f5-75f3-4f01-ac85-6e796f5cde87",
  "name": "minecraft, gaming",
  "status": "Queued",
  "input": { "query": ["minecraft", "gaming"], "threshold": 1000 },
  "endedAt": null,
  "createdAt": "2025-06-15T12:00:00Z",
  "updatedAt": "2025-06-15T12:00:00Z"
}

GET /scan/{id}

Scan Get a scan by id. Cost: free per request.

curl -s "https://public-api.tubelab.net/v1/scan/2a5e56f5-75f3-4f01-ac85-6e796f5cde87" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Path parameters:

Name	Type	Description
`id`	string	Scan id

Response shape (abbreviated):

{
  "id": "2a5e56f5-75f3-4f01-ac85-6e796f5cde87",
  "name": "minecraft, gaming",
  "status": "Completed",
  "input": { "query": ["minecraft", "gaming"], "threshold": 1000 },
  "endedAt": "2025-06-15T13:30:00Z",
  "createdAt": "2025-06-15T12:00:00Z",
  "updatedAt": "2025-06-15T13:30:00Z"
}

Scan Workflow

Scans run asynchronously. Here's the typical flow:

Start a scan with POST /scan - returns a scan ID and status Queued
Poll for status with GET /scan/{id} - status progresses: Queued → Running → Completed
Search results with GET /search/outliers?referenceId={scanId} - returns discovered outlier videos

# 1. Start scan
SCAN_ID=$(curl -s -X POST "https://public-api.tubelab.net/v1/scan" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":["minecraft","gaming"],"mode":"fast"}' | jq -r '.id')

# 2. Poll until complete
curl -s "https://public-api.tubelab.net/v1/scan/$SCAN_ID" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" | jq '.status'

# 3. Search results once completed
curl -s "https://public-api.tubelab.net/v1/search/outliers?referenceId=$SCAN_ID" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Mode	Outliers Limit	Channels Limit	Cost	Est. Time
Fast	1,000	100	50 credits	30 min – 2 hrs
Standard	2,500	250	100 credits	2 – 4 hrs

Common Patterns

Pagination

Search endpoints return pagination.total, pagination.from, and pagination.size. Use from and size query params to paginate:

# Page 1 (items 0-19)
curl -s "https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video&from=0&size=20" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

# Page 2 (items 20-39)
curl -s "https://public-api.tubelab.net/v1/search/outliers?query=minecraft%20adventures&type=video&from=20&size=20" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Range Filters

Many numeric fields support From/To suffixes for range filtering:

# Channels with 10k-100k subscribers and avg views > 5000
curl -s "https://public-api.tubelab.net/v1/search/channels?query=cooking%20healthy%20recipes&subscribersFrom=10000&subscribersTo=100000&averageViewsFrom=5000" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Sorting

Use sortBy and sortOrder params. Available sort fields vary by endpoint.

Important: When using query, omit sortBy to get the default relevance-based ranking. Adding a sort like sortBy=views overrides relevance and returns results ordered by that field, which usually produces worse matches. Only add sortBy when you don't use query (e.g. filter-only searches).

# Filter-only search (no query) — sorting makes sense here
curl -s "https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&sortBy=views&sortOrder=desc" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Array Parameters

Array params use repeated keys:

# Multiple search queries
curl -s "https://public-api.tubelab.net/v1/search/channels?query=minecraft%20adventures&query=gaming%20tutorials" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Search Recipes

Ready-to-use filter combinations for common research tasks. Date filters use ISO 8601 format - compute relative dates with date or substitute directly.

Tip - queries: Search is semantic — longer, descriptive queries return much better results than single keywords. Use query=minecraft adventures or query=cooking healthy recipes instead of just query=minecraft or query=cooking. Think 2-4 words that describe the niche.

Tip - sorting: When using query, do NOT add sortBy — the default sort is by relevance and gives the best matches. Only use sortBy for filter-only searches (no query), e.g. sorting by foundAt or views.

Tip - averageViewsRatio: When searching outliers, prefer averageViewsRatioFrom=1 to find videos that outperformed the channel's average. A ratio of 2 means the video got 2x the channel's usual views. Values above 5 are very rare and indicate extreme virality - only use higher thresholds when you want to narrow results significantly.

Tip - content type: When searching outliers, prefer type=video to focus on long-form videos. Shorts tend to have inflated view counts and skew results. Only use type=short when specifically researching short-form content.

Profitable channels (recently found)

Monetized channels found in the last year with estimated monthly revenue above $1,000 and at least 1,000 subscribers. Sorted by discovery date.

ONE_YEAR_AGO=$(date -u -d "1 year ago" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1y +%Y-%m-%dT00:00:00Z)
curl -s "https://public-api.tubelab.net/v1/search/channels?monetizationAdsense=true&revenueMonthlyEstimationFrom=1000&subscribersFrom=1000&publishedAtFrom=$ONE_YEAR_AGO&language=en&language=de&language=fr&excludeNiche=music&excludeNiche=song&excludeNiche=lofi&excludeNiche=movies&excludeNiche=kids&excludeNiche=news&excludeNiche=politic&sortBy=foundAt&size=20" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Trending channels

Channels with high engagement (avg views/subscribers ratio above 1) and at least 10,000 average views, found in the last 6 months. Good for spotting rising creators.

SIX_MONTHS_AGO=$(date -u -d "6 months ago" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-6m +%Y-%m-%dT00:00:00Z)
curl -s "https://public-api.tubelab.net/v1/search/channels?avgViewsToSubscribersRatioFrom=1&averageViewsFrom=10000&subscribersFrom=100&publishedAtFrom=$SIX_MONTHS_AGO&language=en&language=de&language=fr&excludeNiche=music&excludeNiche=song&excludeNiche=lofi&excludeNiche=movies&sortBy=foundAt&size=20" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Faceless viral videos

AI-classified faceless videos with positive quality published in the last month. Useful for finding faceless niche ideas.

ONE_MONTH_AGO=$(date -u -d "1 month ago" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1m +%Y-%m-%dT00:00:00Z)
curl -s "https://public-api.tubelab.net/v1/search/outliers?type=video&classificationIsFaceless=true&classificationQuality=positive&publishedAtFrom=$ONE_MONTH_AGO&size=20" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

High authenticity videos

Videos classified as positive quality by AI. Filters out low-effort and spammy content.

curl -s "https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&size=20" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Monetized channel videos

Outlier videos from channels with AdSense enabled. Useful for researching niches that generate ad revenue.

curl -s "https://public-api.tubelab.net/v1/search/outliers?type=video&channelMonetizationAdsense=true&size=20" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY"

Error Handling

All errors return JSON with an error object:

Status	Meaning	Response
400	Validation error	`{ "error": { "errors": [{ "code": "...", "message": "...", "path": ["param"] }] } }`
401	Invalid/missing API key	`{ "error": { "message": "Unauthorized" }, "status": "error" }`
402	Insufficient credits	`{ "error": { "message": "Insufficient credits" }, "status": "error" }`
429	Rate limited	`{ "error": { "message": "Rate limit exceeded", "rateLimit": { "limit": 10, "current": 11, "remaining": 0 } } }`

jq Recipes

# Profitable channels: extract name, subs, revenue, and views
ONE_YEAR_AGO=$(date -u -d "1 year ago" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1y +%Y-%m-%dT00:00:00Z)
curl -s "https://public-api.tubelab.net/v1/search/channels?monetizationAdsense=true&revenueMonthlyEstimationFrom=1000&subscribersFrom=1000&publishedAtFrom=$ONE_YEAR_AGO&sortBy=foundAt&size=10" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" | jq '[.hits[] | {title: .snippet.title, handle: .snippet.handle, subs: .statistics.subscribers, avgViews: .statistics.averageViews}]'

# Trending channels: list titles with engagement ratio
SIX_MONTHS_AGO=$(date -u -d "6 months ago" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-6m +%Y-%m-%dT00:00:00Z)
curl -s "https://public-api.tubelab.net/v1/search/channels?avgViewsToSubscribersRatioFrom=1&averageViewsFrom=10000&subscribersFrom=100&publishedAtFrom=$SIX_MONTHS_AGO&sortBy=foundAt&size=10" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" | jq '[.hits[] | {title: .snippet.title, subs: .statistics.subscribers, ratio: .statistics.avgViewsToSubscribersRatio}]'

# Faceless viral videos: extract title, views, and z-score
ONE_MONTH_AGO=$(date -u -d "1 month ago" +%Y-%m-%dT00:00:00Z 2>/dev/null || date -u -v-1m +%Y-%m-%dT00:00:00Z)
curl -s "https://public-api.tubelab.net/v1/search/outliers?type=video&classificationIsFaceless=true&classificationQuality=positive&publishedAtFrom=$ONE_MONTH_AGO&size=10" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" | jq '[.hits[] | {title: .snippet.title, views: .statistics.viewCount, zScore: .statistics.zScore, channel: .snippet.channelTitle}]'

# High-quality outliers: get top videos by views
curl -s "https://public-api.tubelab.net/v1/search/outliers?type=video&classificationQuality=positive&sortBy=views&sortOrder=desc&size=10" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" | jq '[.hits[] | {title: .snippet.title, views: .statistics.viewCount, channel: .snippet.channelTitle}]'

# Get full transcript as plain text
curl -s "https://public-api.tubelab.net/v1/video/transcript/SVeXR66hcIg" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" | jq -r '.items[0].transcript'

# Poll scan status until complete
curl -s "https://public-api.tubelab.net/v1/scan/2a5e56f5-75f3-4f01-ac85-6e796f5cde87" \
  -H "Authorization: Api-Key $TUBELAB_API_KEY" | jq '{status: .status, endedAt: .endedAt}'

Source

git clone https://clawhub.ai/antoniojps/tubelab-apiView on GitHub

Overview

TubeLab API provides REST endpoints to search YouTube channels, identify video outliers, fetch video details, transcripts, and comments, and run automated scans. It enables niche research, competitor analysis, and channel analytics by exposing data-driven insights with JSON responses. Access requires an API key and supports rate-limited requests with per-endpoint credit costs.

How This Skill Works

Authenticate with an API key in the Authorization header. Make requests to endpoints like /search/channels, /search/outliers, /channel/videos/{id}, /video/{id}, and /scan to collect data, then interpret JSON to build analytics dashboards. The service caps at 10 requests per minute per key and credits are consumed by most endpoints; scan mode (Fast or Standard) determines the credit cost (50–100 credits).

When to Use It

Identify profitable YouTube niches by surfacing outlier videos and high-potential channels.
Perform competitor analysis by comparing channel and video metrics against peers.
Build channel analytics dashboards from channel/videos data to monitor growth and engagement.
Extract transcripts and comments for content SEO, keyword research, and sentiment analysis.
Run automated scans to monitor niche trends and detect rising creators over time.

Quick Start

Step 1: Get your API key from Tubelab and set the Authorization header (Authorization: Api-Key $TUBELAB_API_KEY).
Step 2: Run a basic niche surface: GET https://public-api.tubelab.net/v1/search/outliers?query=fitness%20tips with your API key.
Step 3: Retrieve details or transcripts for top results, or start a scan (POST /scan) for deeper analysis.

Best Practices

Start with /search/channels to assemble a niche list using 30+ filters and then drill into /search/outliers for viral candidates.
Use related endpoints to expand insights and compare multiple channels or videos side-by-side.
Cache frequent responses (especially for popular queries) since some results are cached for free.
Leverage /video/transcript/{id} and /video/comments/{id} for SEO keyword extraction and sentiment insights.
Monitor credits carefully and choose scan mode (Fast 50 credits vs Standard 100 credits) to fit your research cadence.

Example Use Cases

Find fitness and wellness niches by pulling outlier videos, then pull transcripts to build a keyword-focused content plan.
Benchmark a competitor by aggregating channel and top video metrics to compare growth rates and audience engagement.
Extract transcripts from top-performing videos to cluster topics and identify content gaps for new videos.
Run a weekly scan on a niche to detect shifting trends and emerging creators before they saturate.
Collect video comments to perform sentiment analysis around a viral video and respond with targeted engagement strategies.

Frequently Asked Questions

Add this skill to your agents

YouTube Outliers & Niche Finder Data by TubeLab

TubeLab API

Authentication

Rate Limits & Credits

Search Endpoints

GET /search/channels

GET /search/channels/related

GET /search/outliers

GET /search/outliers/related

Channel & Video Endpoints

GET /channel/videos/{id}

GET /channel/shorts/{id}

GET /video/{id}

GET /video/transcript/{id}

GET /video/comments/{id}

Scanning Endpoints

POST /scan

GET /scan/{id}

Scan Workflow

Common Patterns

Pagination

Range Filters

Sorting

Array Parameters

Search Recipes

Profitable channels (recently found)

Trending channels

Faceless viral videos

High authenticity videos

Monetized channel videos

Error Handling

jq Recipes

Source

Overview

How This Skill Works

When to Use It

Quick Start

Best Practices

Example Use Cases

Frequently Asked Questions

What is TubeLab API?

How do I authenticate?

How do credits and rate limits work?