Social Fetch
Twitch

Get Twitch profile schedule

Get the stream schedule for a Twitch channel by handle.

GET/v1/twitch/profiles/{handle}/schedule
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
handle*stringpath

Twitch handle to look up, with or without a leading @.

min 1 chars · max 64 chars

Response fields
16

Endpoint-specific response payload.

datalookupStatus
string

Whether the channel was found.

one of: found, not_found

Scheduled stream segments for the channel.

datasegments[]id
string

Schedule segment id.

min 1 chars

datasegments[]title
stringnullable

Segment title when available.

datasegments[]startAt
stringnullable

ISO-8601 start timestamp when available.

datasegments[]endAt
stringnullable

ISO-8601 end timestamp when available.

datasegments[]isCancelled
booleannullable

Whether the segment is cancelled when known.

Categories for the segment when available.

datasegments[]categories[]id
stringnullable

Category id when available.

datasegments[]categories[]slug
stringnullable

Category slug when available.

datasegments[]categories[]name
stringnullable

Category display name when available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/twitch/profiles/ishowspeed/schedule" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Schedule for the requested Twitch profile.