# Twitch Details API (twitch.profile)

- Canonical page: [https://everyinfra.com/en/twitch-api/profile](https://everyinfra.com/en/twitch-api/profile?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "twitch", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Twitch Details reads one channel by `username` and returns its profile (display name, bio, avatar, banner, followers, creation date), whether it is a Partner or Affiliate, whether it is live with the current title, game, viewer count and start time, and the title, game and time of its last broadcast. By default it also adds recent videos and top clips. Sponsors, agencies and esports teams use it to vet streamers, check that a channel is still active, and compare channels before a deal.

Live fields describe the moment of the call; `last_broadcast_at` is the field that tells an active streamer from one who has stopped. Set `include_videos` or `include_clips` to the boolean false to leave those parts out, never the string 'false'. The clips added here cover a different time window from the Twitch Clips capability, which lets you choose the period.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=twitch&action=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | Twitch channel login short name for profile or clips, optionally prefixed with @, without parsing full twitch.tv URLs. |
| include_clips | not declared | no | not declared | Boolean value defaulting to true indicating whether the profile response includes curated clip information. Its time window differs from the standalone clips endpoint. |
| include_videos | not declared | no | not declared | 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". |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| user_id | User's unique ID on the platform. |
| username | Username (@handle). |
| display_name | Display name; can differ from username. |
| bio | Profile bio written by the account; may contain line breaks and emoji. |
| url | Link to the record on the platform. |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| banner_url | platform-native meaning |
| follower_count | Followers. null means not disclosed, not 0. |
| is_partner | platform-native meaning |
| is_affiliate | platform-native meaning |
| is_live | platform-native meaning |
| current_viewers | platform-native meaning |
| stream_title | platform-native meaning |
| current_game | platform-native meaning |
| stream_started_at | platform-native meaning |
| last_broadcast_title | platform-native meaning |
| last_broadcast_game | platform-native meaning |
| last_broadcast_at | platform-native meaning |
| created_at | Creation time, same format as posted_at. |
| recent_videos | Recently published videos, each with its title, link, view count, duration and so on; absent when there are none. |
| top_clips | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "twitch",
  "action": "profile",
  "params": {
    "username": "shroud"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "twitch",
        "action": "profile",
        "params": {
            "username": "shroud",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "twitch",
  "action": "profile",
  "results": {
    "user_id": "•••",
    "username": "shroud",
    "display_name": "shroud",
    "bio": "I'm back baby",
    "url": "https://www.twitch.tv/shroud",
    "avatar_url": "https://static-cdn.jtvnw.net/•••",
    "banner_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/dbee25e8-55b7-4565-87f0-e9d4661dcc66-profile_banner-480.jpeg",
    "follower_count": 11293129,
    "is_partner": true,
    "is_affiliate": false,
    "is_live": false,
    "last_broadcast_title": "we are SAVED!",
    "last_broadcast_game": "WARDOGS",
    "last_broadcast_at": "2026-09-26T04:34:47.953850+00:00",
    "created_at": "2012-11-03T15:50:32.878470+00:00",
    "recent_videos": [
      {
        "id": "•••",
        "title": "we are SAVED!",
        "url": "https://www.twitch.tv/videos/2883804788",
        "view_count": 2687,
        "duration_seconds": 35971,
        "game": "WARDOGS",
        "created_at": "2026-09-25T18:35:12+00:00"
      },
      {
        "id": "•••",
        "title": "surely were saved..?",
        "url": "https://www.twitch.tv/videos/2882888067",
        "view_count": 252586,
        "duration_seconds": 28465,
        "game": "WARDOGS",
        "created_at": "2026-09-24T17:23:48+00:00"
      },
      {
        "id": "•••",
        "title": "playing till we get ddosed",
        "url": "https://www.twitch.tv/videos/2882056326",
        "view_count": 194144,
        "duration_seconds": 21413,
        "game": "WARDOGS",
        "created_at": "2026-09-23T17:50:24+00:00"
      }
    ],
    "top_clips": [
      {
        "id": "•••",
        "title": "wtf !!",
        "url": "https://www.twitch.tv/shroud/clip/SeductiveFurryPotCmonBruh--v2IUlxXQxpw8YUZ",
        "view_count": 2230,
        "duration_seconds": 39,
        "game": "Active Matter",
        "curator_username": "•••",
        "curator_name": "Taisseeer",
        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/f4e752a4-c4c1-42b9-a4a1-a7a28106a717/landscape/thumb/thumb-0000000000-1920x1080.jpg",
        "created_at": "2026-09-19T22:08:27+00:00"
      },
      {
        "id": "•••",
        "title": "Pilot Kill",
        "url": "https://www.twitch.tv/shroud/clip/BreakableAssiduousBulgogiUnSane-oAR-wxU-JuRMLxdl",
        "view_count": 1042,
        "duration_seconds": 21,
        "game": "WARDOGS",
        "curator_username": "•••",
        "curator_name": "primo11119",
        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/f45445b1-9e8c-4cfd-88b0-d6cbe5d00b61/landscape/thumb/thumb-0000000000-1920x1080.jpg",
        "created_at": "2026-09-21T18:00:52+00:00"
      },
      {
        "id": "•••",
        "title": "next level bush camper",
        "url": "https://www.twitch.tv/shroud/clip/VainCloudyHawkRiPepperonis-imxaRCvFhJlfVtvo",
        "view_count": 784,
        "duration_seconds": 60,
        "game": "WARDOGS",
        "curator_username": "•••",
        "curator_name": "Plot_C4",
        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/84be87c7-bea1-4ed5-b709-8fdcc5482baa/landscape/thumb/thumb-0000000000-1920x1080.jpg",
        "created_at": "2026-09-20T17:44:19+00:00"
      }
    ],
    "platform": "twitch"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What do I pass as `username`?

The channel's login name, as in twitch.tv/shroud, with or without a leading @. Full twitch.tv links are not parsed, so pass only the name. The name shown on the channel can differ from the login: `username` holds the login and `display_name` the shown name.

### What is the difference between Partner and Affiliate?

Both are Twitch monetization tiers. `is_affiliate` marks the entry tier, and `is_partner` marks Twitch Partner, the highest tier, one step above Affiliate. The tier is a quick signal of how established a channel is before you discuss a sponsorship.

### How do I tell whether a streamer is still active?

Read `last_broadcast_at`, when the most recent stream started, together with `last_broadcast_title` and `last_broadcast_game`. `is_live`, `current_viewers` and `stream_title` only describe the moment of the call, so a channel that is offline now may still stream regularly.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=twitch
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
