Back to APIs
Twitch public data

Twitch Public Data API

Resolve a known public Twitch username into a normalized profile, collect its public video inventory, or fetch a single clip with its downloadable video for creator research, catalog enrichment, comparison, and snapshot monitoring.

Available Twitch APIs

Use Twitch Profile API for normalized account identity, Twitch User Videos API for one public video page with supported type and order filters, or Twitch Clip Downloader API for one public clip from its clip URL.

What Twitch data can you retrieve?

The Twitch catalog returns one normalized public account record or one page of normalized public videos from a username, or one public clip from a clip URL, with nullable fields when the source does not expose a value.

Profile identity

Retrieve available account ID, public URL, username, display name, and biography.

Profile presentation

Retain available avatar, cover image, and associated website fields.

Account signals

Read nullable verified and private flags without inferring absent values.

Visible account counts

Keep available follower, following, and post counts beside collected_at for point-in-time comparisons.

Public user videos

Collect video identity, creator context, media, duration, publication time, and visible engagement from one source page.

Public clips

Fetch a clip's title, view count, length, creation time, broadcaster, and a downloadable MP4 link with its thumbnail.

SocQ vs Twitch API

SocQ provides public profile and user-video retrieval in normalized task workflows; Twitch's native APIs and authentication are appropriate for authorized application integrations and channel operations.

CapabilitySocQTwitch API
Primary useResolve a public profile, collect one page of user videos, or fetch one clipBuild native Twitch integrations around Twitch resources
AuthenticationSocQ API keyTwitch application and applicable user or app authorization
Starting inputOne username, or one clip URL for clipsNative request parameters and Twitch resource identifiers
Channel managementNot supportedUse authorized Twitch APIs and required permissions
Response formatNormalized SocQ AccountItem or ReelVideoItem recordsNative Twitch response objects

How the Twitch API works

All Twitch APIs use the shared SocQ asynchronous task and stored-result workflow.

  1. 1. Choose an endpoint

    POST one valid public username to /v1/twitch/profile or /v1/twitch/user-videos, or one clip URL to /v1/twitch/clip, and save task_id.

  2. 2. Track the task

    Poll /v1/tasks/{task_id} until the task succeeds or fails.

  3. 3. Read stored records

    Use data.results.items for the profile or video records and preserve collection-time context.

Resolve a public Twitch profile

Authenticate with a SocQ API key and submit exactly one supported username. The successful task has a fixed cost of 0.19 credits.

curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Common Twitch API use cases

Creator identity enrichment

Add available Twitch identity, biography, imagery, website, account flags, and public counts to known creator records.

Handle resolution

Resolve a submitted username before associating the public profile with an internal research entity.

Account comparison

Compare separately collected profiles through the same nullable identity and metric fields.

Snapshot monitoring

Retain collected_at with public profile values so later runs remain distinguishable snapshots.

Video inventory enrichment

Attach public video identity, media, creator context, duration, timestamps, and visible engagement to known channels.

Highlight archiving

Save a clip's MP4 with its title, broadcaster, and creation time to keep a searchable library of a channel's best moments.

Limits and public-data policy

The Twitch endpoints are read-only public profile, user-video, and clip lookups. They do not provide authenticated channel actions or audience-member data.

  • Profile and User Videos accept one username only; they do not accept a channel URL, a username list, or results_limit.
  • Twitch Clip Downloader accepts one clip URL in the form twitch.tv/<channel>/clip/<slug> or clips.twitch.tv/<slug>, and its MP4 link is signed and expires after about a day.
  • The username may begin with one @ and must otherwise contain 1 to 64 ASCII letters, numbers, dots, underscores, or hyphens.
  • Profile lookup returns at most one source profile object; User Videos collects one source page and does not accept caller-controlled cursor or results_limit.
  • Profile identity, images, website, flags, location, and individual metrics can be null when public source data is unavailable.
  • The endpoint does not log in, publish, moderate, manage a channel, retrieve private analytics, or perform OAuth-authorized account actions.

Twitch API frequently asked questions

What is the Twitch API?

Twitch APIs use asynchronous tasks to resolve one known public username into a normalized profile, collect one page of its public videos, or fetch one public clip from its URL.

Which Twitch APIs are currently available?

Twitch Profile API, Twitch User Videos API, and Twitch Clip Downloader API are currently available.

Can I submit a Twitch URL?

Twitch Clip Downloader API takes one clip URL in url. Twitch Profile and User Videos require username and reject url, urls, and other undeclared fields.

Does this API manage a Twitch channel?

No. All Twitch endpoints are read-only public lookups and do not authenticate a Twitch user, publish, moderate, manage channel settings, or retrieve private analytics.

Why can fields be null?

Normalized account and video records preserve optional public fields as null when the source or provider does not expose a value at collection time.

How are Twitch requests priced?

Each successful Twitch Profile or User Videos task costs a fixed 0.19 SocQ credits. Each Twitch Clip Downloader request costs 0.5 credits, and a clip that cannot be found is fully refunded.

Twitch API guides and comparisons

Compare data providers, weigh the alternatives, and follow step-by-step guides for collecting public Twitch data.

Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.