twitcheasy-twitch-bottwitch-authtwitch-auth-tmitwitch-chat-clienttwitch-eventsubtwitch-pubsub-clienttwitch-webhooks
Welcome

HelixClipApi

The Helix API methods that deal with clips.

Overview

Can be accessed using client.helix.clips on an ApiClient instance.

Example

const api = new ApiClient(new StaticAuthProvider(clientId, accessToken));
const clipId = await api.helix.clips.createClip({ channelId: '125328655' });

Methods

createClip(params)

async

Creates a clip of a running stream.

Returns the ID of the clip.

ParameterTypeDescription
paramsHelixClipCreateParamssee below
params.channelIdstring

The ID of the broadcaster of which you want to create a clip.

params.createAfterDelayboolean

Add a delay before the clip creation that accounts for the usual delay in the viewing experience.

Return type: string

getClipById(id)

async

Retrieves the clip identified by the given ID.

ParameterTypeDescription
idstring

The clip ID.

Return type: HelixClip | null

getClipsByIds(ids)

async

Retrieves the clips identified by the given IDs.

ParameterTypeDescription
idsArray<string>

The clip IDs.

Return type: Array<HelixClip>

getClipsForBroadcaster(user, filter)

async

Retrieves the latest clips for the specified broadcaster.

ParameterTypeDescription
userUserIdResolvable

The broadcaster to fetch clips for.

filterHelixClipFilter
filter.endDatestring

The latest date to find clips for.

filter.limitnumber

The maximum number of results to retrieve. Defaults to 20.

filter.startDatestring

The earliest date to find clips for.

getClipsForBroadcasterPaginated(user, filter)

Creates a paginator for the latest clips for the specified broadcaster.

ParameterTypeDescription
userUserIdResolvable

The broadcaster to fetch clips for.

filterHelixClipFilter
filter.endDatestring

The latest date to find clips for.

filter.limitnumber

The maximum number of results to retrieve. Defaults to 20.

filter.startDatestring

The earliest date to find clips for.

getClipsForGame(gameId, filter)

async

Retrieves the latest clips for the specified game.

ParameterTypeDescription
gameIdstring

The game ID.

filterHelixClipFilter
filter.endDatestring

The latest date to find clips for.

filter.limitnumber

The maximum number of results to retrieve. Defaults to 20.

filter.startDatestring

The earliest date to find clips for.

getClipsForGamePaginated(gameId, filter)

Creates a paginator for the latest clips for the specified game.

ParameterTypeDescription
gameIdstring

The game ID.

filterHelixClipFilter
filter.endDatestring

The latest date to find clips for.

filter.limitnumber

The maximum number of results to retrieve. Defaults to 20.

filter.startDatestring

The earliest date to find clips for.