Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Video
    • Overview
    • Control
    • Troubleshooting
    • Browser autoplay policy
  • Access management
  • Pricing policy
    • API authentication
    • Getting started with the API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • BatchDelete
        • GetPlayerURL
  • Audit Trails events
  • Release notes

In this article:

  • HTTP request
  • Path parameters
  • Query parameters
  • PlaylistPlayerParams
  • Response
  1. API reference
  2. REST
  3. Playlist
  4. GetPlayerURL

Video API, REST: Playlist.GetPlayerURL

Written by
Yandex Cloud
Updated at November 25, 2025
  • HTTP request
  • Path parameters
  • Query parameters
  • PlaylistPlayerParams
  • Response

Generates a player URL for watching the playlist.
The URL can include player parameters such as autoplay, mute, and visibility of interface controls.

HTTP requestHTTP request

GET https://video.api.cloud.yandex.net/video/v1/playlists/{playlistId}:getPlayerURL

Path parametersPath parameters

Field

Description

playlistId

string

Required field. ID of the playlist for which to generate a player URL.

The maximum string length in characters is 50.

Query parametersQuery parameters

Field

Description

params

PlaylistPlayerParams

Optional player parameters to customize the playback experience.
These parameters control initial player state such as mute, autoplay, and visibility of interface controls.

PlaylistPlayerParamsPlaylistPlayerParams

Field

Description

mute

boolean

If true, the player will start with audio muted.
Users can unmute the audio manually after playback starts.

autoplay

boolean

If true, the playlist will start playing automatically when the player loads.
This may be subject to browser autoplay policies that restrict autoplay with sound.

hidden

boolean

If true, the player interface controls will be hidden initially.
Users can typically reveal the controls by moving the mouse over the player.

ResponseResponse

HTTP Code: 200 - OK

{
  "playerUrl": "string",
  "html": "string"
}

Field

Description

playerUrl

string

Direct URL to the playlist player.
This URL can be used to access the playlist in a web browser
or shared with users who have appropriate permissions.

html

string

HTML embed code in iframe format that can be inserted into web pages.
This code allows the playlist to be embedded directly in third-party websites.

Was the article helpful?

Previous
BatchDelete
Next
Overview
© 2025 Direct Cursus Technology L.L.C.