Datasets

Search the YouTube creators dataset

Searches public YouTube channel profiles stored in a search index — subscriber, video and view counts, region, bio and links, discovered via Common Crawl and Wikidata and hydrated from each channel's public About page. Sort enum: relevance, followers_desc, followers_asc, views_desc, videos_desc, hydrated_at_desc, hydrated_at_asc. Some channels hide their subscriber, video, or view count; the _available flags on each item distinguish a hidden count (stored as 0, *_available: false) from a genuine 0. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/youtube-creators/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/youtube-creators/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over channel_name and bio, max 256 characters

channel_idstring

Exact channel id filter (e.g. UCxxxxxxxxxxxxxxxxxxxxxxxx), max 128 characters

regionstring

Exact channel region/country filter (case-insensitive), max 128 characters

discovery_sourcestring

Exact filter for how the channel was discovered (e.g. commoncrawl, wikidata), max 128 characters

has_bioboolean

Filter by a non-empty About bio

has_linksboolean

Filter by at least one linked external URL

followers_count_availableboolean

Filter by whether the channel exposes a public subscriber count

videos_count_availableboolean

Filter by whether the channel has a known uploaded-video count

views_count_availableboolean

Filter by whether the channel has a known total view count

min_followersinteger

Minimum subscriber count

max_followersinteger

Maximum subscriber count

min_videosinteger

Minimum uploaded-video count

max_videosinteger

Maximum uploaded-video count

min_viewsinteger

Minimum total view count

max_viewsinteger

Maximum total view count

joined_afterstring

Channels created on or after this date (RFC3339 or YYYY-MM-DD)

joined_beforestring

Channels created on or before this date (RFC3339 or YYYY-MM-DD)

hydrated_afterstring

Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD)

hydrated_beforestring

Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD)

sort'relevance' | 'followers_desc' | 'followers_asc' | 'views_desc' | 'videos_desc' | 'hydrated_at_desc' | 'hydrated_at_asc'

Sort enum: relevance, followers_desc, followers_asc, views_desc, videos_desc, hydrated_at_desc, hydrated_at_asc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.