Hitorino Videos API — List and Retrieve On-Demand Videos

The Videos API gives you access to Hitorino’s library of on-demand content — recordings of past streams, uploaded videos, and highlight clips published by creators. You can use these endpoints to build video galleries, embed content in external sites, or sync Hitorino video metadata into your own database. All responses follow the standard Hitorino JSON format described in the API Overview.

Returns a paginated list of publicly available on-demand videos. Videos are returned in reverse-chronological order (newest first) by default.

GET /videos

Query Parameters

string

Return only videos published by the creator with this user ID. Useful for building a creator-specific video gallery.

string

Filter videos by category slug (e.g., gaming, music, coding). Must match a valid Hitorino category.

integer

Maximum number of videos to return per page. Defaults to 20. Maximum is 100.

string

Pagination cursor from the previous response’s pagination.next_cursor. Omit to fetch the first page.

Request Examples

curl "https://api.hitorino.tv/v1/videos?category=coding&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

const params = new URLSearchParams({ category: 'coding', limit: '5' });

const response = await fetch(`https://api.hitorino.tv/v1/videos?${params}`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});

const { data, pagination } = await response.json();
console.log(data);        // array of video objects
console.log(pagination);  // { next_cursor, has_more }

import requests

params = {'category': 'coding', 'limit': 5}
headers = {'Authorization': 'Bearer YOUR_API_KEY'}

response = requests.get(
    'https://api.hitorino.tv/v1/videos',
    params=params,
    headers=headers,
)
result = response.json()
print(result['data'])
print(result['pagination'])

Response

{
  "data": [
    {
      "id": "vid_01HVID1234",
      "title": "Building a REST API in Go — Full Session",
      "description": "Three-hour deep dive into building a production-ready REST API using Go and PostgreSQL.",
      "category": "coding",
      "creator_id": "usr_01HABC5678",
      "duration_seconds": 10842,
      "view_count": 3820,
      "privacy": "public",
      "thumbnail_url": "https://cdn.hitorino.tv/thumbnails/vid_01HVID1234.jpg",
      "video_url": "https://watch.hitorino.tv/videos/vid_01HVID1234",
      "source_stream_id": "str_01HXYZ1234",
      "published_at": "2024-06-11T08:00:00Z",
      "created_at": "2024-06-10T23:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "cur_01HVID9999",
    "has_more": true
  }
}

array

Array of video objects matching the query.

Show video object fields

string

Unique identifier for the video, prefixed with vid_.

string

Display title of the video.

string

Description provided by the creator. May be null if no description was set.

string

Category slug assigned to the video.

string

ID of the creator who published the video.

integer

Total duration of the video in seconds.

integer

Total number of views the video has received since publication.

string

Visibility setting: public or private.

string

URL of the video thumbnail image.

string

Public watch page URL for the video.

string

ID of the live stream this video was recorded from, if applicable. null for directly uploaded videos.

string

ISO 8601 timestamp of when the video was made publicly available.

string

ISO 8601 timestamp of when the video resource was created (e.g., when processing completed).

object

Cursor-based pagination metadata.

Show pagination fields

string

Pass this value as the cursor query parameter in your next request to retrieve the following page. null when has_more is false.

boolean

true if more results are available beyond the current page.

Get Video

Retrieves a single on-demand video by its unique ID, returning all metadata fields plus extended playback information.

GET /videos/{id}

Path Parameters

string

required

The unique video ID (e.g., vid_01HVID1234).

Request Examples

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

const videoId = 'vid_01HVID1234';

const response = await fetch(`https://api.hitorino.tv/v1/videos/${videoId}`, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});

const video = await response.json();
console.log(video.title);          // "Building a REST API in Go — Full Session"
console.log(video.duration_seconds); // 10842

import requests

video_id = 'vid_01HVID1234'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}

response = requests.get(
    f'https://api.hitorino.tv/v1/videos/{video_id}',
    headers=headers,
)
video = response.json()
print(video['title'])
print(video['duration_seconds'])

Response

{
  "id": "vid_01HVID1234",
  "title": "Building a REST API in Go — Full Session",
  "description": "Three-hour deep dive into building a production-ready REST API using Go and PostgreSQL.",
  "category": "coding",
  "creator_id": "usr_01HABC5678",
  "duration_seconds": 10842,
  "view_count": 3820,
  "privacy": "public",
  "thumbnail_url": "https://cdn.hitorino.tv/thumbnails/vid_01HVID1234.jpg",
  "video_url": "https://watch.hitorino.tv/videos/vid_01HVID1234",
  "playback_url": "https://cdn.hitorino.tv/hls/vid_01HVID1234/index.m3u8",
  "source_stream_id": "str_01HXYZ1234",
  "chapters": [
    {
      "title": "Introduction",
      "start_seconds": 0
    },
    {
      "title": "Project setup & dependencies",
      "start_seconds": 420
    },
    {
      "title": "Routing with chi",
      "start_seconds": 1800
    }
  ],
  "tags": ["go", "api", "postgresql", "backend"],
  "published_at": "2024-06-11T08:00:00Z",
  "created_at": "2024-06-10T23:00:00Z",
  "updated_at": "2024-06-11T08:00:00Z"
}

string

HLS manifest URL for direct video playback. You can pass this to a compatible player (e.g., HLS.js, Video.js) to embed the video in your own application.

array

Creator-defined chapters for the video. Each chapter has a title (string) and start_seconds (integer) indicating where it begins.

array

Array of string tags associated with the video for search and discovery.

string

ISO 8601 timestamp of the most recent metadata update to this video.

Use the playback_url (HLS format) with an open-source player like HLS.js to embed Hitorino videos directly in your web app without iframes.

The playback_url field is only returned on GET /videos/{id} — it is intentionally omitted from list responses to keep payloads compact.

​List Videos

​Query Parameters

​Request Examples

​Response

​Get Video

​Path Parameters

​Request Examples

​Response

List Videos

Query Parameters

Request Examples

Response

Get Video

Path Parameters

Request Examples

Response