Get channel service URL

Prev Next

Available in Classic and VPC

Get the live playback URL and thumbnail URL for a VOD2LIVE channel. You can retrieve them only when the channel is in the RESERVED or PUBLISHING status.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET /api/v2/vod/channels/{channelId}/serviceUrls

Request headers

For information about the headers common to all Live Station APIs, see Live Station request headers.

Request path parameters

You can use the following path parameters with your request:

Field Type Required Description
channelId String Required Channel ID

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
serviceUrlType String Required Service URL type
  • GENERAL | THUMBNAIL
    • GENERAL: Live playback URL (HLS and MPEG-DASH)
    • THUMBNAIL: Thumbnail image URL

Request example

The request example is as follows:

curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/vod/channels/ls-20250818******-C6e7r/serviceUrls?serviceUrlType=THUMBNAIL' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json'

Response

This section describes the response format.

Response body

The response body includes the following data:

GENERAL

The following is the response body when requesting a live playback URL.

Field Type Required Description
content Array - Live playback URL information
content.name String - Image quality name
content.url String - Live playback URL
content.resolution String - Video resolution
content.videoBitrate String - Video stream's bitrate (bps)
content.audioBitrate String - Audio stream's bitrate (bps)

THUMBNAIL

The following is the response body when requesting a thumbnail image URL.

Field Type Required Description
content Array - Thumbnail image URL information
content.name String - Thumbnail name
content.url String - Thumbnail image URL
content.resizedUrl Array - Resized thumbnail image URL list
content.resizedUrl.type String - Thumbnail image size
content.resizedUrl.url String - Thumbnail image URL

Response status codes

For information about the HTTP status codes common to all Live Station APIs, see Live Station response status codes.

Response example

The response example is as follows:

When querying general URL

The following is a sample response when querying a live playback URL.

{
    "content": [
        {
            "name": "1080p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250818******-C6e7r/1080p-16-9/playlist.m3u8",
            "resolution": "1920x1080",
            "videoBitrate": "5000000",
            "audioBitrate": "192000"
        },
        {
            "name": "720p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250818******-C6e7r/720p-16-9/playlist.m3u8",
            "resolution": "1280x720",
            "videoBitrate": "2500000",
            "audioBitrate": "128000"
        },
        {
            "name": "480p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250818******-C6e7r/480p-16-9/playlist.m3u8",
            "resolution": "854x480",
            "videoBitrate": "1200000",
            "audioBitrate": "128000"
        },
        {
            "name": "360p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250818******-C6e7r/360p-16-9/playlist.m3u8",
            "resolution": "640x360",
            "videoBitrate": "800000",
            "audioBitrate": "96000"
        },
        {
            "name": "ABR",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250818******-C6e7r/playlist.m3u8"
        }
    ]
}

When querying thumbnail URL

The following is a sample response when querying a thumbnail URL.

{
  "content": [
    {
      "name": "thumbnail",
      "url": "https://test123.edge.naverncp.com/live/image/ls-20210625******-XeRA2/thumbnail.jpg",
      "resizedUrl": [
        {
          "type": "100px",
          "url": "https://test123.edge.naverncp.com/live/image/ls-20210625******-XeRA2/100px/thumbnail.jpg"
        },
        {
          "type": "360px",
          "url": "https://test123.edge.naverncp.com/live/image/ls-20210625******-XeRA2/360px/thumbnail.jpg"
        },
        {
          "type": "720px",
          "url": "https://test123.edge.naverncp.com/live/image/ls-20210625******-XeRA2/720px/thumbnail.jpg"
        }
      ]
    }
  ]
}