Interface VideosQuery

Hierarchy

Properties

channelId?: string

Examples: UCl_gCybOJRIgOXw6Qb4qJzQ Filter by video uploader channel id

from: Date

Date for minimum available_at. (available_at is the most accurate timestamp of when a video has gone live or became viewable - it is the first non-null value of the start_actual, start_scheduled or published_at fields)

id?: string

A single Youtube Video ID. If Specified, only this video can be returned (may be filtered out by other conditions though)

include?: ExtraVideoInfo[]

Comma-separated list of extra video info. Possible items: 'clips' 'refers' 'sources' 'simulcasts' 'mentions' 'description' 'live_info' 'channel_stats' 'songs'

lang?: string

Examples: en,ja Default: all A comma separated list of language codes to filter channels/clips, official streams do not follow this parameter

limit?: number

Default: 25 Results limit

maxUpcomingHours?: number

Examples: 24 Number of maximum hours upcoming to get upcoming videos by (for rejecting waiting rooms that are two years out)

mentionedChannelId?: string

Filter by mentioned channel id, excludes itself. Generally used to find collabs/clips that include the requested channel

offset?: number

Default: 0 Offset results

order?: "asc" | "desc"

Default: desc Order by ascending or descending

org?: string

Examples: Hololive Filter by clips that feature the org's talent or videos posted by the org's talent

paginated?: boolean

If paginated is set to true, return an object with total, otherwise returns an array. Default

sort?: string

Examples: start_scheduled Default: available_at Sort by any returned video field

status?: "new" | "upcoming" | "live" | "past" | "missing"

Examples: past Filter by video status

to: Date

Date String for maximum available_at

topic?: string

Examples: singing Filter by video topic id

type?: "stream" | "clip"

Filter by type of video

Generated using TypeDoc