Developer tutorial

How to scrape Twitch videos with Python (2026)

This tutorial shows how to scrape Twitch videos in Python using the SocialCrawl API. You get a channel's past broadcasts and highlights with title, view count, duration, and thumbnail from one GET request, with no Twitch developer account, proxies, or HTML parsing. The code below is runnable as-is, and the response underneath it is a real, unedited call.

Code tested July 2026

Get your free API key Read the API docs

How it works

1
Get a free API keyCreate a SocialCrawl account and copy your API key from the dashboard. Every new account starts with free credits.
2
Set up PythonInstall the requests library with `pip install requests`.
3
Call the Twitch User Videos endpointSend a GET request to /v1/twitch/user/videos with your API key in the x-api-key header and the `handle` parameter.
4
Read the responseParse the JSON. SocialCrawl returns a channel's past broadcasts and highlights with title, view count, duration, and thumbnail in one normalized schema, so you write no HTML parsing or proxy code.

The code

A real, unedited response from the request above.

import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/twitch/user/videos",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"handle": "ishowspeed"},
)
data = response.json()
print(data)

[ RESPONSE ]

{
  "success": true,
  "platform": "twitch",
  "endpoint": "/v1/twitch/user/videos",
  "data": {
    "items": [
      {
        "post": {
          "id": "2809007655",
          "url": "https://www.twitch.tv/videos/2809007655",
          "content": {
            "text": "irl stream Ivory Coast 🇨🇮 Vs Norway 🇳🇴! World Cup Full Match Live⚽️🌎!",
            "media_urls": "https://d2nvs31859zcd8.cloudfront.net/3491cf8b9e2be31e05e2_ishowspeed_318305489495_1782839652/storyboards/2809007655-strip-0.jpg",
            "thumbnail_url": "https://static-cdn.jtvnw.net/cf_vods/d2nvs31859zcd8/3491cf8b9e2be31e05e2_ishowspeed_318305489495_1782839652//thumb/thumb0-320x180.jpg",
            "duration_seconds": 103
          },
          "author": {
            "username": "ishowspeed",
            "display_name": "IShowSpeed",
            "avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/46a38d3a-a39c-4c43-ac12-c331b1c469c2-profile_image-50x50.png",
            "verified": null
          },
          "engagement": {
            "views": 566360,
            "likes": null,
            "comments": null,
            "shares": null,
            "saves": null
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": null,
            "deleted": false
          },
          "published_at": "2026-06-30T17:14:17Z"
        },
        "computed": {
          "engagement_rate": null,
          "language": "en",
          "content_category": "other",
          "estimated_reach": 679632
        }
      },
      {
        "post": {
          "id": "2808977718",
          "url": "https://www.twitch.tv/videos/2808977718",
          "content": {
            "text": "irl stream Ivory Coast 🇨🇮 Vs Norway 🇳🇴! World Cup Full Match Live⚽️🌎!",
            "media_urls": "https://d2nvs31859zcd8.cloudfront.net/f1c7df8555284d3b065b_ishowspeed_318305224151_1782836988/storyboards/2808977718-strip-0.jpg",
            "thumbnail_url": "https://static-cdn.jtvnw.net/cf_vods/d2nvs31859zcd8/f1c7df8555284d3b065b_ishowspeed_318305224151_1782836988//thumb/thumb0-320x180.jpg",
            "duration_seconds": 2052
          },
          "author": {
            "username": "ishowspeed",
            "display_name": "IShowSpeed",
            "avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/46a38d3a-a39c-4c43-ac12-c331b1c469c2-profile_image-50x50.png",
            "verified": null
          },
          "engagement": {
            "views": 186797,
            "likes": null,
            "comments": null,
            "shares": null,
            "saves": null
          },
          "flags": {
            "nsfw": null,
            "spoiler": null,
            "pinned": null,
            "deleted": false
          },
          "published_at": "2026-06-30T16:29:53Z"
        },
        "computed": {
          "engagement_rate": null,
          "language": "en",
          "content_category": "other",
          "estimated_reach": 224156
        }
      }
    ],
    "total": null,
    "dropped": 0
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_example000000",
  "cached": false,
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 44
  }
}

API reference for this endpoint

Prefer another language?

Python Node.js cURL

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Do I need a Twitch developer account to scrape Twitch videos?

No. SocialCrawl handles authentication and proxies upstream, so you never register a Twitch app, manage OAuth tokens, or run your own scrapers. One API key returns Twitch data directly.

What does the Twitch User Videos endpoint return?

It returns a channel's past broadcasts and highlights with title, view count, duration, and thumbnail. The response is normalized into SocialCrawl's unified schema, identical in shape across every platform.

How much does it cost to scrape Twitch videos?

Each call costs a small number of credits, and new accounts start with free credits. There are no monthly minimums, so you pay only for the calls you make.

Can I use this Python code in production?

Yes. The snippet on this page is the real request against the live API. For production, add error handling and follow the response cursor to paginate through large result sets.

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

Get your free API key