Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Twitch action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Find Twitch channels by keyword, with follower count, Partner or Affiliate status, live state and last broadcast details. | $1.39 per 1,000 requests | Normal |
Profilesprofile | Pull a Twitch channel's profile, Partner or Affiliate status, live stream details and last broadcast, with recent videos and top clips by default. | $1.39 per 1,000 requests | Normal |
Clipsclips | Get the clips cut from a Twitch channel, with title, views, length, game and the viewer who clipped each one. | $1.39 per 1,000 requests | Normal |
Streamsstreams | List Twitch channels currently live in a category, with stream title, viewer count, follower count and start time. | $1.39 per 1,000 requests | Normal |
Top streamstop_streams | See the top live streams on Twitch with channel, title, game, viewer count and start time, no input required. | $1.39 per 1,000 requests | Normal |
Top gamestop_games | Track the top games on Twitch with viewer and broadcaster counts and box art, no input needed. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Twitch action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Find Twitch channels by keyword, with follower count, Partner or Affiliate status, live state and last broadcast details. It searches channels, not chat, and | keyword | — | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · platform |
profileProfiles Pull a Twitch channel's profile, Partner or Affiliate status, live stream details and last broadcast, with recent videos and top clips by default. Set | username | include_clips, include_videos | Sync delivery | — | $1.39 per 1,000 requests | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · recent_videos · top_clips · platform |
clipsClips Get the clips cut from a Twitch channel, with title, views, length, game and the viewer who clipped each one. | username | period | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · title · url · view_count · duration_seconds · duration_sec · game · channel_username · channel_name · curator_username · curator_name · thumbnail_url · created_at · platform |
streamsStreams List Twitch channels currently live in a category, with stream title, viewer count, follower count and start time. | game | — | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform |
top_streamsTop streams See the top live streams on Twitch with channel, title, game, viewer count and start time, no input required. The order is neither a lasting ranking nor a recommendation of our own. | — | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform | |
top_gamesTop games Track the top games on Twitch with viewer and broadcaster counts and box art, no input needed. The counts describe Twitch viewing only, not sales, total players or popularity elsewhere. | — | Sync delivery | Catalog values: defaultLimit=10, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · name · viewer_count · broadcaster_count · box_art_url · url · platform |
What do the Twitch search parameters mean?
Find Twitch channels by keyword, with follower count, Partner or Affiliate status, live state and last broadcast details. It searches channels, not chat, and is_live reflects the moment of the call rather than a guarantee.
keywordRequired- Channel keyword for search. The streams endpoint requires an exact game or category name via game, rather than arbitrary stream title keywords.
What do the Twitch profile parameters mean?
Pull a Twitch channel's profile, Partner or Affiliate status, live stream details and last broadcast, with recent videos and top clips by default. Set include_videos or include_clips to the boolean false to drop those sections; revenue, subscriber names and private analytics are not exposed.
usernameRequired- Twitch channel login short name for profile or clips, optionally prefixed with @, without parsing full twitch.tv URLs.Twitch: Login Names, Display Names, and Broadcaster Types — Official Twitch documentation separately defines login, display_name, and broadcaster_type. Here, username should use the channel short name and not treat the display name or Partner/Affiliate type as a login credential; other parameters supported by official user queries are not automatically added to this API. · Checked
include_clipsOptional- Boolean value defaulting to true indicating whether the profile response includes curated clip information. Its time window differs from the standalone clips endpoint.
include_videosOptional- Boolean value defaulting to true indicating whether the profile response includes recent video archive information. Set to false to omit this section; do not pass the string "false".
What do the Twitch clips parameters mean?
Get the clips cut from a Twitch channel, with title, views, length, game and the viewer who clipped each one. period picks the past day, week (the default), month or all time; the window may not hold every clip.
usernameRequired- Twitch channel login short name for profile or clips, optionally prefixed with @, without parsing full twitch.tv URLs.
periodOptional- Time window for clips: LAST_DAY for the past day, LAST_WEEK for the past week (default), LAST_MONTH for the past month, or ALL_TIME for unrestricted. Values are case-insensitive, and invalid values fall back to LAST_WEEK.Twitch: Clip Creators, Source Channels, and View Counts — Twitch's official documentation for clips separates broadcaster from creator, defines view_count as the clip view count, and defines duration in seconds. This section only verifies terminology and does not replicate official start/end dates, cursors, or clip creation parameters. · Checked
What do the Twitch streams parameters mean?
List Twitch channels currently live in a category, with stream title, viewer count, follower count and start time. game needs the exact category name, such as Just Chatting, and viewer counts are a snapshot.
gameRequired- Exact Twitch category name for streams, such as Just Chatting. Returns channels currently streaming in that category, not historical video archives of the game.Twitch: Live Stream Categories and Current Viewer Counts — Official live stream documentation distinguishes categories, channels, and current live streams, defining viewer_count as the number of users currently watching the stream. It is not a Clip view count, follower count, or historical total view count; the official game_id parameter does not replace the category name required by this page. · Checked
What do the Twitch top_streams parameters mean?
See the top live streams on Twitch with channel, title, game, viewer count and start time, no input required. The order is neither a lasting ranking nor a recommendation of our own.
Full API reference: parameters, code samples, response example and health →This action has no business parameters. Send only the platform and action identifiers.
What do the Twitch top_games parameters mean?
Track the top games on Twitch with viewer and broadcaster counts and box art, no input needed. The counts describe Twitch viewing only, not sales, total players or popularity elsewhere.
Full API reference: parameters, code samples, response example and health →This action has no business parameters. Send only the platform and action identifiers.
How to use the Twitch API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"twitch","action":"search","params":{"keyword":"<keyword>"}}'
Twitch API questions
What can I retrieve with the Twitch API?
Set platform to twitch. The current catalog lists search, profiles, clips, streams, top streams, and more. These action names identify different Twitch objects or views; they are not interchangeable search modes.
Which input starts a Twitch `search` request?
Channel keyword for search. The streams endpoint requires an exact game or category name via game, rather than arbitrary stream title keywords. Send it as keyword inside params.
Which fields can Twitch `search` return?
Its declared schema includes user_id, username, display_name, and bio. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Twitch action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.