Get channel service URL

Prev Next

Available in Classic and VPC

Get the live playback URL, time machine URL, and thumbnail URL for a live channel.

Request

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

Method URI
GET /api/v2/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 | TIMEMACHINE | THUMBNAIL
    • GENERAL: Live playback URL (HLS and MPEG-DASH)
    • TIMEMACHINE: Time machine URL. Can only be retrieved when the channel you set the time machine (DVR) for is streaming.
    • THUMBNAIL: Thumbnail image URL

Request example

The request example is as follows:

curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/serviceUrls?serviceUrlType=GENERAL' \
--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)

TIMEMACHINE

The following is the response body when requesting a time machine URL.

Field Type Required Description
content Array - Time machine URL information
content.name String - Image quality name
content.url String - Time machine 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": "480p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/480p-16-9/playlist.m3u8",
            "resolution": "854x480",
            "videoBitrate": "1200000",
            "audioBitrate": "128000"
        },
        {
            "name": "360p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/360p-16-9/playlist.m3u8",
            "resolution": "640x360",
            "videoBitrate": "800000",
            "audioBitrate": "96000"
        },
        {
            "name": "audio-192k",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/audio-192k/playlist.m3u8",
            "audioBitrate": "192000"
        },
        {
            "name": "ABR",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/playlist.m3u8"
        }
    ]
}

When querying time machine URL

The following is a sample response when querying a time machine URL.

{
    "content": [
        {
            "name": "480p-16-9",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/480p-16-9/playlist.m3u8",
            "resolution": "854x480",
            "videoBitrate": "1200000",
            "audioBitrate": "128000"
        },
        {
            "name": "360p-16-9",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/360p-16-9/playlist.m3u8",
            "resolution": "640x360",
            "videoBitrate": "800000",
            "audioBitrate": "96000"
        },
        {
            "name": "audio-192k",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/audio-192k/playlist.m3u8",
            "audioBitrate": "192000"
        },
        {
            "name": "ABR",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/playlist.m3u8"
        }
    ]
}

When querying thumbnail URL

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

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