Identity
Query the current user, channels, and followed channels. Channel and list fields use Relay connections for pagination.
Check your subscription, see your content, and manage your channel. These queries give you everything about the current user and any channel on the platform. For channels and nested catalog fields on channel, use Pagination (Relay connections).
me
Returns your profile, channel, subscription status, credits, and connected services — everything you need to build a personalized dashboard.
{
me {
id
username
email
channel {
id
metadata { name summary }
}
subscription {
plan { name price interval }
state
}
youtube { connected channelTitle hasUploadScope }
credits { generation { balance spent } }
wallet { address verified balance }
followedChannels { id metadata { name } }
}
}Key Fields on Me
| Field | Type | Description |
|---|---|---|
id | DID! | User's decentralized identifier |
username | String! | Unique username |
email | String! | Account email |
channel | Channel | User's creator channel (API key auth) |
subscription | Subscription | Active plan and billing state |
youtube | YouTubeConnection | YouTube OAuth connection status |
credits | Credits | AI generation and storage balances |
followedChannels | [Channel]! | Channels this user follows |
ingestions | [IngestionSession] | Active upload sessions |
profile | UserProfile | Name, bio, avatar |
settings | UserSettings | Notification preferences |
channel
Query a single channel by DID. Returns null if not found.
curl -X POST https://api.rad.live/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"query": "{ channel(id: \"did:rad.live:channel/abc123\") { id metadata { name summary } followersCount isFollowed features(first: 10) { edges { node { id metadata { title } } } } } }"
}'const response = await fetch('https://api.rad.live/graphql', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY',
},
body: JSON.stringify({
query: `{
channel(id: "did:rad.live:channel/abc123") {
id
metadata { name summary }
followersCount
isFollowed
features(first: 10) {
edges {
node {
id
metadata { title }
}
}
}
}
}`,
}),
});response = requests.post(
"https://api.rad.live/graphql",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY",
},
json={
"query": """
{
channel(id: "did:rad.live:channel/abc123") {
id
metadata { name summary }
followersCount
isFollowed
features(first: 10) {
edges {
node {
id
metadata { title }
}
}
}
}
}
"""
},
)Key Fields on Channel
| Field | Type | Description |
|---|---|---|
id | DID! | Channel's DID |
metadata | ChannelMetadata! | Name, summary, keywords, categories |
followersCount | Int! | Number of followers |
isFollowed | Boolean! | Whether the current user follows this channel |
features(first, after, last, before) | FeatureConnection! | Feature-length content |
series, miniseries, seasons, episodes, streams | *Connection! | Catalog lists (same pagination args) |
playlists(first, after, last, before) | PlaylistConnection! | Channel playlists |
assets | ChannelAssets! | Channel images (avatar, banner) |
channels
Paginated list of all channels:
{
channels(first: 20) {
totalCount
edges {
node {
id
metadata { name }
followersCount
}
}
pageInfo {
hasNextPage
endCursor
}
}
}| Argument | Type | Description |
|---|---|---|
first / last | Int | Page size forward or backward |
after / before | String | Cursors from pageInfo |
Channel Dashboard
Need a complete creator overview in one call? The channelDashboard query returns your channel info, recent content with transcoding status, and playlists — perfect for building a creator dashboard.
{
channelDashboard {
channel { id metadata { name } followersCount }
recentContent { id metadata { title } transcodeStatus }
playlists { id metadata { title } }
}
}Also available as the channel_dashboard MCP tool.
Pagination
How list fields work in the Rad TV GraphQL API — Connection types, edges, nodes, pageInfo, and cursors. Read this before querying channels, catalog, or comments.
Catalog
Query features, series, episodes, seasons, streams, and miniseries from the Rad TV GraphQL catalog using Relay connections.