Kullanıcı Yayın Takvimi

GET/v1/twitch/user/schedule1 kredi

Bir kanalın yayın takvimini döndürür: başlık, başlangıç ve bitiş zamanları, kategoriler ve iptal durumuyla planlanan yayınlar; ayrıca kanalın son yayını, yayın başlığı ve güncel yayını.

01Sorgu parametreleri

Ad	Tür	Açıklama
handlezorunlu	string	Twitch kullanıcı adı, `@login` ya da kanal URL'si, örneğin `shroud`.

02İstek

curl "https://api.scrapesocial.ai/v1/twitch/user/schedule?handle=emongg" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/twitch/user/schedule?handle=emongg

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "23220337",
  "primaryColorHex": null,
  "lastBroadcast": {
    "id": "320911183708",
    "startedAt": "2026-10-25T16:41:49.759518Z",
    "__typename": "Broadcast"
  },
  "broadcastSettings": {
    "id": "23220337",
    "title": "[OWCS !DROPS ENABLED] watching some owcs and gaming",
    "__typename": "BroadcastSettings"
  },
  "stream": {
    "id": "320911183708",
    "createdAt": "2026-10-25T16:41:43Z",
    "viewersCount": 1248,
    "previewImageURL": "https://static-cdn.jtvnw.net/previews-ttv/live_user_emongg-320x180.jpg",
    "verticalPreviewImageURL": "https://static-cdn.jtvnw.net/previews-ttv/live_user_emongg-180x320.jpg",
    "height": 1440,
    "width": 2560,
    "isDualFormat": false,
    "game": {
      "id": "515025",
      "slug": "overwatch-2",
      "name": "Overwatch",
      "__typename": "Game"
    },
    "__typename": "Stream"
  },
  "videos": {
    "edges": [
      {
        "node": {
          "id": "2910561307",
          "title": "[OWCS !DROPS ENABLED] watching some owcs and gaming",
          "createdAt": "2026-10-25T16:41:48Z",
          "lengthSeconds": 1588,
          "viewCount": 0,
          "previewThumbnailURL": "https://vod-secure.twitch.tv/_404/404_processing_320x180.png",
          "game": {
            "id": "515025",
            "slug": "overwatch-2",
            "name": "Overwatch",
            "__typename": "Game"
          },
          "__typename": "Video"
        },
        "__typename": "VideoEdge"
      },
      {
        "node": {
          "id": "2909390350",
          "title": "[OWCS !DROPS ENABLED] watching some owcs and gaming",
          "createdAt": "2026-10-24T11:56:56Z",
          "lengthSeconds": 42953,
          "viewCount": 82908,
          "previewThumbnailURL": "https://static-cdn.jtvnw.net/cf_vods/d2vi6trrdongqn/3756fd9fc0e9e26aaec0_emongg_320798703070_1792843011//thumb/thumb0-320x180.jpg",
          "game": {
            "id": "515025",
            "slug": "overwatch-2",
            "name": "Overwatch",
            "__typename": "Game"
          },
          "__typename": "Video"
        },
        "__typename": "VideoEdge"
      }
    ],
    "__typename": "VideoConnection"
  },
  "channel": {
    "id": "23220337",
    "schedule": {
      "id": "schedule-23220337",
      "nextSegment": {
        "id": "eyJzZWdtZW50SUQiOiI5NjU1NWMwMC03OGZkLTQ4NTQtYTIyZS1kYWNjOGU3ZWZlYzkiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0NH0=",
        "startAt": "2026-10-26T11:00:00Z",
        "__typename": "ScheduleSegment"
      },
      "interruption": null,
      "segments": [
        {
          "id": "eyJzZWdtZW50SUQiOiI5NjU1NWMwMC03OGZkLTQ4NTQtYTIyZS1kYWNjOGU3ZWZlYzkiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0M30=",
          "baseSegmentID": "96555c00-78fd-4854-a22e-dacc8e7efec9",
          "title": "",
          "startAt": "2026-10-19T11:00:00Z",
          "endAt": "2026-10-19T21:00:00Z",
          "isCancelled": false,
          "cancelledUntil": null,
          "hasReminder": false,
          "repeatEndsAfterCount": null,
          "categories": [],
          "__typename": "ScheduleSegment"
        },
        {
          "id": "eyJzZWdtZW50SUQiOiJiYmE3Nzk1Yi1jZWQzLTQyYzQtODNkMC02NDEyNmNjYzk5NzciLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0M30=",
          "baseSegmentID": "bba7795b-ced3-42c4-83d0-64126ccc9977",
          "title": "",
          "startAt": "2026-10-20T11:00:00Z",
          "endAt": "2026-10-20T21:00:00Z",
          "isCancelled": false,
          "cancelledUntil": null,
          "hasReminder": false,
          "repeatEndsAfterCount": null,
          "categories": [],
          "__typename": "ScheduleSegment"
        }
      ],
      "__typename": "Schedule"
    },
    "__typename": "Channel"
  },
  "__typename": "User"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Kanal alanları yanıtın en üst düzeyindedir; planlanan yayınlar `channel.schedule.segments` altındadır. Bulunamayan bir kanal ücretsiz bir 404 döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.