Datasets

Facet the YouTube creators dataset

Returns value counts for the YouTube creators dataset by the required facet: region or discovery_source. The counts honour the search filters, such as subscriber, video and view ranges and join or refresh dates, and cover the top 50 values.

get/datasets/youtube-creators/facets

Request

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

Query parameters

facet'region' | 'discovery_source' required

Facet enum: region, discovery_source

qstring

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

channel_idstring

Exact channel id filter, max 128 characters

regionstring

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

discovery_sourcestring

Exact filter for how the channel was discovered, 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

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.