Skip to main content
The Users API lets you retrieve the public profile of any creator on Hitorino. You can use this endpoint to display creator information alongside their streams or videos in your integration — showing an avatar, bio, and follower count without redirecting users to Hitorino’s website. This endpoint returns only publicly available information; private account details such as email addresses or billing information are never exposed.

​
Get User

Returns the public profile of the creator with the specified user ID. 
GET /users/{id}

​
Path Parameters

​
id
string
required
The unique user ID of the creator (e.g., usr_01HABC5678). You can obtain a creator’s id from the creator_id field on any stream or video object.

​
Request Examples

curl https://api.hitorino.tv/v1/users/usr_01HABC5678 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": "usr_01HABC5678",
  "username": "solostudio",
  "display_name": "Solo Studio",
  "bio": "Solo developer building in public. TypeScript, Go, and the occasional art stream.",
  "avatar_url": "https://cdn.hitorino.tv/avatars/usr_01HABC5678.jpg",
  "banner_url": "https://cdn.hitorino.tv/banners/usr_01HABC5678.jpg",
  "profile_url": "https://hitorino.tv/solostudio",
  "follower_count": 12480,
  "is_verified": true,
  "categories": ["coding", "art"],
  "social_links": {
    "twitter": "https://twitter.com/solostudio",
    "github": "https://github.com/solostudio",
    "website": "https://solostudio.dev"
  },
  "stream_count": 87,
  "video_count": 63,
  "created_at": "2023-01-14T10:22:00Z"
}

​
Response Fields

​
id
string
Unique identifier for the user, prefixed with usr_.
​
username
string
The creator’s unique lowercase username on Hitorino. Used in the profile URL.
​
display_name
string
The creator’s public-facing display name. May differ from username and can contain mixed case and spaces.
​
bio
string
Short biography written by the creator. May be null if the creator has not set a bio.
​
avatar_url
string
URL of the creator’s profile picture. Served from Hitorino’s CDN. Always present; falls back to a default avatar if the creator has not uploaded one.
​
banner_url
string
URL of the creator’s profile banner image. null if no banner has been set.
​
profile_url
string
Full URL to the creator’s public profile page on Hitorino.
​
follower_count
integer
Total number of Hitorino users following this creator.
​
is_verified
boolean
true if Hitorino has granted this creator a verified badge, indicating authenticity of a notable individual or brand.
​
categories
array
Array of category slugs representing the content types this creator most frequently streams. May be empty.
​
social_links
object
Map of social platform names to their URLs, as configured by the creator. Possible keys include twitter, github, instagram, youtube, and website. Only keys the creator has filled in are present — absent platforms are not included in the object.
​
stream_count
integer
Total number of streams the creator has ever started on Hitorino, including ended streams.
​
video_count
integer
Total number of on-demand videos published by the creator.
​
created_at
string
ISO 8601 timestamp of when the creator’s Hitorino account was created.

​
Usage Pattern: Enriching Stream Data

A common integration pattern is to fetch stream data and then enrich it with creator profile information. The creator_id on every stream and video object maps directly to the id parameter for this endpoint. 
// Fetch a live stream, then display the creator's profile alongside it
async function getStreamWithCreator(streamId) {
  const baseUrl = 'https://api.hitorino.tv/v1';
  const headers = { 'Authorization': 'Bearer YOUR_API_KEY' };

  // Fetch the stream first, then use its creator_id to fetch the creator profile
  const streamRes = await fetch(`${baseUrl}/streams/${streamId}`, { headers });
  const stream = await streamRes.json();

  const creatorRes = await fetch(`${baseUrl}/users/${stream.creator_id}`, { headers });
  const creator = await creatorRes.json();

  return { stream, creator };
}

const { stream, creator } = await getStreamWithCreator('str_01HXYZ1234');
console.log(`${creator.display_name} is streaming: ${stream.title}`);
// "Solo Studio is streaming: Late Night Lo-Fi Coding"
This endpoint returns public profile data only. You cannot update user profiles, retrieve email addresses, or access any private account information via the API.