Four authenticated endpoints with full source records and bounded retrieval. Videos, schedules and clips passed live acceptance on the deployment host. Profile retrieval is currently challenged by Twitch on this host and returns an explicit failure.
Private · profile challenged
WHAT’S ON THE MAP
Retrieve profile identity, biography, social links, followers, partner status, current stream, videos, home-page video shelves and similar streamers. Social names become lowercase top-level keys. Deployment-host acceptance is currently blocked by an integrity challenge on social links. The worker returns HTTP 502 / upstream_challenged without a reduced profile.
Retrieve the first page of up to 100 videos, with optional type and sort filters. Source hasNextPage and cursor metadata are returned for compatibility; continuation requests are not supported because the logged-out source rejects them with an integrity challenge.
Retrieve the current calendar week, Monday 00:00 UTC through the next Monday. Includes schedule segments, cancellation metadata, interruption, next segment, current stream and this week’s recent broadcasts.
Retrieve the complete public clip and playback metadata. Numeric keys preserve the reference API’s GraphQL batch response: 0 is the clip, 1 related clips, and 2 logged-out viewer data.
YOUR FIRST REQUEST
Start with a local worker and a service key. The examples use the current Twitch contract.
/v1/twitch/profileRetrieve profile identity, biography, social links, followers, partner status, current stream, videos, home-page video shelves and similar streamers. Social names become lowercase top-level keys. Deployment-host acceptance is currently blocked by an integrity challenge on social links. The worker returns HTTP 502 / upstream_challenged without a reduced profile.
Request and response fields/v1/twitch/user/videosRetrieve the first page of up to 100 videos, with optional type and sort filters. Source hasNextPage and cursor metadata are returned for compatibility; continuation requests are not supported because the logged-out source rejects them with an integrity challenge.
Request and response fields/v1/twitch/user/scheduleRetrieve the current calendar week, Monday 00:00 UTC through the next Monday. Includes schedule segments, cancellation metadata, interruption, next segment, current stream and this week’s recent broadcasts.
Request and response fields/v1/twitch/clipRetrieve the complete public clip and playback metadata. Numeric keys preserve the reference API’s GraphQL batch response: 0 is the clip, 1 related clips, and 2 logged-out viewer data.
Request and response fields# Local worker · use your own service key
export BASE_URL="http://localhost:3012"
curl --get "$BASE_URL/v1/twitch/profile" \
-H "x-api-key: $TWITCH_API_KEY" \
--data-urlencode "handle=example"const baseUrl = "http://localhost:3012";
const url = new URL('/v1/twitch/profile', baseUrl);
url.searchParams.set("handle", "example");
const response = await fetch(url, {
method: 'GET',
headers: {
'x-api-key': process.env.TWITCH_API_KEY
}
});
const data = await response.json();
console.log(data);/v1/twitch/profileJSON responseExamples target local workers. Use the origin and credentials supplied for your service.
TAKE IT SOMEWHERE USEFUL
Retrieve Twitch profiles, video pages, weekly schedules and complete public clips.
Retrieve Twitch profiles, video pages, weekly schedules and complete public clips.
Private · profile challenged
No. ScrapeAtlas is independent and is not affiliated with Twitch. This endpoint retrieves supported publicly available data.