Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Video
    • Overview
    • Control
    • Troubleshooting
  • Access management
  • Pricing policy
    • Authentication with the API
    • Getting started with the API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • GenerateUploadURL
        • Delete
  • Audit Trails events
  • Release notes

In this article:

  • gRPC request
  • ListSubtitlesRequest
  • ListSubtitlesResponse
  • Subtitle
  1. API reference
  2. gRPC
  3. Subtitle
  4. List

Video API, gRPC: SubtitleService.List

Written by
Yandex Cloud
Updated at April 24, 2025
  • gRPC request
  • ListSubtitlesRequest
  • ListSubtitlesResponse
  • Subtitle

List subtitles.

gRPC request

rpc List (ListSubtitlesRequest) returns (ListSubtitlesResponse)

ListSubtitlesRequest

{
  "page_size": "int64",
  "page_token": "string",
  // Includes only one of the fields `video_id`
  "video_id": "string"
  // end of the list of possible fields
}

Field

Description

page_size

int64

The maximum number of the results per page to return.
Default value: 100.

page_token

string

Page token for getting the next page of the result.

video_id

string

ID of the video.

Includes only one of the fields video_id.

ListSubtitlesResponse

{
  "subtitles": [
    {
      "id": "string",
      "language": "string",
      "label": "string",
      "status": "SubtitleStatus",
      "source_type": "SubtitleSourceType",
      "filename": "string",
      "created_at": "google.protobuf.Timestamp",
      "updated_at": "google.protobuf.Timestamp",
      // Includes only one of the fields `video_id`
      "video_id": "string"
      // end of the list of possible fields
    }
  ],
  "next_page_token": "string"
}

Field

Description

subtitles[]

Subtitle

next_page_token

string

Token for getting the next page.

Subtitle

Field

Description

id

string

ID of the subtitle.

language

string

Subtitle language in any of the following formats:

  • three-letter code according to ISO 639-2/T, ISO 639-2/B, or ISO 639-3
  • two-letter code according to ISO 639-1

label

string

Subtitle caption to be displayed on screen during video playback.

status

enum SubtitleStatus

Subtitle status.

  • SUBTITLE_STATUS_UNSPECIFIED: Subtitle status unspecified.
  • WAIT_UPLOADING: Waiting for all the bytes to be loaded.
  • UPLOADED: Uploading is complete.

source_type

enum SubtitleSourceType

Source type.

  • SUBTITLE_SOURCE_TYPE_UNSPECIFIED: Subtitle source type unspecified.
  • MANUAL: Manually uploaded subtitle.
  • GENERATED: Automatically generated subtitle.

filename

string

Subtitle filename.

created_at

google.protobuf.Timestamp

Time when subtitle was created.

updated_at

google.protobuf.Timestamp

Time of last subtitle update.

video_id

string

ID of the video.

Includes only one of the fields video_id.

Was the article helpful?

Previous
Get
Next
Create
© 2025 Direct Cursus Technology L.L.C.