UnifAPI Docs

List videos from a Twitch channel

Returns videos (past broadcasts, highlights, uploads) from a Twitch channel with titles, durations and view counts. Filter by type and sort by time or views.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/twitch/channels/{username}/videos

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

username*string

Twitch channel login, as in twitch.tv/{username}.

Length1 <= length <= 500

Query Parameters

filter_by?string

Optional filter for the type of Twitch videos to return. archive: full unedited past broadcasts (VODs). highlight: shorter clips curated/edited by the streamer from past broadcasts. upload: videos uploaded directly, not recorded from a live stream.

Value in

  • "highlight"
  • "archive"
  • "upload"
sort_by?string

Optional sort order.

Value in

  • "time"
  • "views"

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/twitch/channels/string/videos"
{  "request_id": "string",  "data": [    {      "id": "string",      "title": "string",      "url": "string",      "thumbnail_url": "string",      "animated_preview_url": "string",      "published_at": 0,      "view_count": 0,      "duration": 0,      "game": {        "id": "string",        "slug": "string",        "name": "string",        "box_art_url": "string"      }    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}