get

suspend fun get(broadcasterId: String? = null, gameId: String? = null, ids: List<String> = emptyList(), startedAt: Instant? = null, endedAt: Instant? = null, isFeatured: Boolean? = null, cursor: String? = null, pageSize: Int? = null): Page<Clip>

Twitch API: Get Clips

Gets a single page of clips matching the filter criteria.

Return

a Page of Clip objects.

Parameters

broadcasterId

an ID that identifies the broadcaster whose video clips you want to get.

gameId

an ID that identifies the game whose clips you want to get.

ids

clip IDs to get (max 100).

startedAt

the start date used to filter clips.

endedAt

the end date used to filter clips.

isFeatured

if true, returns only featured clips. If false, only non-featured. If null, all clips.

cursor

the cursor used to get the next page of results.

pageSize

the maximum number of clips to return per page (1-100, default 20). Null uses the API default.