Triangle pointing up
Reference

Channels

Search for channels directly from the YouTube Niche Finder with AI enhanced data and 30+ filters. Updated in real-time, 24/7.

GET/search/channels

Authorization

Authorization<token>

Use the format: Api-Key <token> as the value.

In: header

Query Parameters

query?array<string>

Search queries

seed?string & number | null

Randomize search results by passing a random seed

filterBy?string

Filter by statistics of each content kind

Value in"video" | "short"
contentKind?string

Filter by type of content created by channel:

  • video - channel has videos;
  • short - channel has shorts;
  • long-form - channel has more long-form content;
  • short-form - channel has more short-form content
Value in"video" | "short" | "long-form" | "short-form"
publishedAtFrom?string

Filter by a channel's last parsed video upload date (from a sample of 100 videos) - Expects an ISO date time string.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Formatdate-time
publishedAtTo?string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Formatdate-time
averageViewsFrom?integer
Range0 <= value <= 9007199254740991
averageViewsTo?integer
Range0 < value <= 9007199254740991
medianViewsFrom?integer
Range0 <= value <= 9007199254740991
medianViewsTo?integer
Range0 < value <= 9007199254740991
language?string

ISO 639-1 language code

avgViewsToSubscribersRatioFrom?number

Filter by the outlier score of a channel

Range0 <= value
avgViewsToSubscribersRatioTo?number
Range0 < value
subscribersFrom?integer
Range0 <= value <= 9007199254740991
subscribersTo?integer
Range0 < value <= 9007199254740991
videosCountFrom?integer
Range0 <= value <= 9007199254740991
videosCountTo?integer
Range0 < value <= 9007199254740991
viewVariationCoefficientFrom?number
Range0 <= value
viewVariationCoefficientTo?number
Range0 < value
revenueMonthlyEstimationFrom?number
Range0 <= value
revenueMonthlyEstimationTo?number
Range0 < value
rpmEstimationFrom?number
Range0 <= value
rpmEstimationTo?number
Range0 < value
avgDurationFrom?integer

Average duration of videos in seconds

Range0 <= value <= 9007199254740991
avgDurationTo?integer
Range0 < value <= 9007199254740991
monetizationAdsense?boolean

Filter by whether the channel has AdSense enabled or not

excludeNiche?array<string>

Exclude niches from search results by keywords

classificationQuality?string

AI classification of a channel quality. This is an estimation where negative is slop, and positive high quality content

Value in"negative" | "neutral" | "positive"
classificationIsFaceless?boolean

AI classification wether channel content has faceless potential or not

from?integer

Page to fetch

Default0
Range0 <= value <= 9007199254740991
size?integer

Number of items per page

Default20
Range0 < value <= 40
sortBy?string

Sort results by a specific metric:

Beaware when using semantic search (applying a query with the by parameter set to semantic) the sorting option is only applied within the nearest videos found and not the entire dataset.

  • subscribers - sort by subscribers
  • averageViews - sort by average views
  • avgViewsToSubscribersRatio - sort by average views to subscribers ratio
  • viewVariationCoefficient - sort by view variation coefficient
  • revenueMonthly - sort by revenue monthly estimation
  • rpm - sort by RPM estimation
  • foundAt - sort by when the channel was found (for new results)
  • recency - sort by when the channel started uploading
Value in"subscribers" | "averageViews" | "avgViewsToSubscribersRatio" | "viewVariationCoefficient" | "revenueMonthly" | "rpm" | "foundAt" | "recency"
sortOrder?string

Sorting order of results, where asc is ascending and desc is descending

Response Body

{
  "pagination": {
    "total": 100,
    "from": 0,
    "size": 20
  },
  "hits": [
    {
      "id": "UChn5jutPQB_bRjnG80pzl5w",
      "snippet": {
        "handle": "@tubelabhq",
        "title": "TubeLab",
        "thumbnails": {
          "default": {
            "url": "string"
          },
          "medium": {
            "url": "string"
          },
          "high": {
            "url": "string"
          }
        },
        "contentKind": [
          "video",
          "short",
          "long-form"
        ]
      },
      "time": "2019-08-24T14:15:22Z",
      "semantic": {
        "niches": [
          "string"
        ],
        "description": "string"
      },
      "monetization": {
        "adsense": true,
        "revenueMonthlyEstimationFrom": 0,
        "rpmEstimationFrom": 0,
        "revenueMonthlyEstimationTo": 0,
        "rpmEstimationTo": 0
      },
      "language": "string",
      "classification": {
        "isFaceless": true,
        "quality": "positive"
      },
      "videos": [
        {
          "id": "SVeXR66hcIg",
          "title": "string",
          "thumbnails": {
            "default": {
              "url": "string",
              "width": 0,
              "height": 0
            },
            "medium": {
              "url": "string",
              "width": 0,
              "height": 0
            },
            "high": {
              "url": "string",
              "width": 0,
              "height": 0
            }
          },
          "publishedAtEstimate": "2019-08-24T14:15:22Z",
          "viewCount": 9007199254740991,
          "statistics": {
            "isPositiveOutlier": true
          }
        }
      ],
      "shorts": [
        {
          "id": "SVeXR66hcIg",
          "title": "string",
          "thumbnails": [
            {
              "url": "string",
              "width": 0,
              "height": 0
            }
          ],
          "viewCount": 9007199254740991
        }
      ],
      "statistics": {
        "subscriberCount": 9007199254740991,
        "subscriberCountRaw": "string",
        "viewCountEstimate": 0,
        "viewCountMonthlyEstimate": 0,
        "videosCount": 9007199254740991,
        "videosSampleCount": 9007199254740991,
        "videosCountRaw": "string",
        "averageViewsEstimate": 0,
        "medianViewsEstimate": 0,
        "averageVideoDurationEstimate": 0,
        "standardDeviationViewsEstimate": 0,
        "viewVariationCoefficient": 0,
        "avgViewsToSubscribersRatio": 0,
        "lastPublishedAtEstimate": "string",
        "oldestParsedPublishedAtEstimate": "string",
        "positiveOutliersCount": 9007199254740991,
        "negativeOutliersCount": 9007199254740991
      }
    }
  ]
}
{
  "error": {
    "errors": [
      {
        "code": "string",
        "validation": "string",
        "message": "string",
        "path": [
          "string"
        ]
      }
    ]
  },
  "status": "string"
}
{
  "error": {
    "message": "string"
  },
  "status": "string"
}
{
  "error": {
    "message": "string"
  },
  "status": "string"
}
{
  "error": {
    "message": "string",
    "rateLimit": {
      "limit": -9007199254740991,
      "current": -9007199254740991,
      "remaining": -9007199254740991,
      "resetTime": "2019-08-24T14:15:22Z"
    }
  },
  "status": "string"
}

Pricing

Learn about TubeLab's API pricing structure

Similar Channels GET

Next Page