Twitch Public Data API
Resolve a known public Twitch username into a normalized profile or collect its public video inventory for creator research, catalog enrichment, comparison, and snapshot monitoring.
Available Twitch APIs
Use Twitch Profile API for normalized account identity, or Twitch User Videos API for one public video page with supported type and order filters.
What Twitch data can you retrieve?
The Twitch catalog returns either one normalized public account record or one page of normalized public videos from a username, 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.
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.
| Capability | SocQ | Twitch API |
|---|---|---|
| Primary use | Resolve a public profile or collect one page of user videos | Build native Twitch integrations around Twitch resources |
| Authentication | SocQ API key | Twitch application and applicable user or app authorization |
| Starting input | One username | Native request parameters and Twitch resource identifiers |
| Channel management | Not supported | Use authorized Twitch APIs and required permissions |
| Response format | Normalized SocQ AccountItem or ReelVideoItem records | Native Twitch response objects |
How the Twitch API works
Both Twitch APIs use the shared SocQ asynchronous task and stored-result workflow.
1. Choose an endpoint
POST one valid public username to /v1/twitch/profile or /v1/twitch/user-videos and save task_id.
2. Track the task
Poll /v1/tasks/{task_id} until the task succeeds or fails.
3. Read stored records
Use data.results.items for the profile or video records and preserve collection-time context.
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.itemsCommon 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.
Limits and public-data policy
The Twitch endpoints are read-only public profile and user-video lookups. They do not provide authenticated channel actions or audience-member data.
- The request accepts one username only; it does not accept a channel URL, a username list, or results_limit.
- 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 or collect one page of its public videos.
Which Twitch APIs are currently available?
Twitch Profile API and Twitch User Videos API are currently available.
Can I submit a Twitch URL?
No. The current request contract requires username and rejects url, urls, and other undeclared fields.
Does this API manage a Twitch channel?
No. Both 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.
Combine data across platforms for more complete business insights
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.
Apple App Store API
Collect public Apple App Store app details, category rankings, and reviews from known store URLs as normalized app and review records.
SEO API
Query live Google organic results, compare keyword demand and ranking difficulty, expand seed terms, uncover the keywords and pages driving a site's search visibility, and classify search intent. Every endpoint uses the same SocQ API key, asynchronous task flow, and normalized result format.
Amazon API
Search public Amazon products and collect normalized product details, Best Sellers, reviews, and seller-profile records from supported marketplaces.
Douyin API
Retrieve public profiles and videos, search videos, collect one page of comments or creator videos, and inspect a known live room.
Instagram API
Look up or find public profiles and collect follower-list records, following relationships, authored posts, profile-tagged posts, hashtag results, Reels, transcripts, comments, account counts, engagement metrics and media metadata through one asynchronous workflow.
YouTube API
Collect supported public YouTube channel profiles, video details, channel videos, comments, Shorts, keyword and hashtag results, and available transcripts through one normalized asynchronous workflow.