# LINE TV API reference
# LINE TV API
# Spotlight curation module types
Gets a spotlight data unit list such as represent_clip, editor_pick_clip, and theme_playlist.
Spotlight is the home of LINE TV, which has channels, playlists, clips, and more.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/curation/list?lineChannelId={lineChannelId}&country=th
# Request headers
Content-Type
application/json
Authorization
Bearer {Channel Access Token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Names of the curation DataModule
Example response
# Spotlight curation module
Gets spotlight data.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/curation?lineChannelId={lineChannelId}&country=th&module={moduleName}
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
Channel ID. Found on the LINE Developers Console.
country
th
module
One of:
represent_clip: Clip that appears at the top of the main pageeditor_pick_clip: Clips based on editor's selectionhot_clip: Popular clipstheme_clip: Clips of a themetheme_playlist: Playlists of a themehot_channel: Popular channelsspecial_clip: Clip chosen by the editor that appears in the special area.
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Values for the module query parameters
# Category list
Gets a category list such as drama, music, etc.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/category/list?lineChannelId={lineChannelId}&country=th
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
Channel ID. Found on the LINE Developers Console.
country
th
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Category list locations
# Category
Gets category home data.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/category?lineChannelId={lineChannelId}&country=th&categoryCode={categoryCode}&page=1&countPerPage=10
# Request headers
Content-Type
application/json
Authorization
Bearer {Channel Access Token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
categoryCode
String
Drama, entertainment, artist, etc. See Category list for complete details.
page
Integer
Default: 1
countPerPage
Integer
Default: 10
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Ranking
Gets clip ranking data.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/ranking/clip?lineChannelId={lineChannelId}&country=th&page=1&countPerPage=10
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
page
Integer
Default: 1
countPerPage
Integer
Default: 10
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Search
Gets a clip search result.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/search/clip?lineChannelId={lineChannelId}&country=th&query={query}
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
query
String
Search query
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Search ranking
Gets a list of search rankings from the last hour.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/search/ranking?lineChannelId={lineChannelId}&country=th
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Station home list
Gets the station home (TV station) list.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/station/list?lineChannelId={lineChannelId}&country=th
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Station home
Gets the Station Home (TV Station) data.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/station?lineChannelId={lineChannelId}&country=th&stationId={stationId}
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
stationId
String
warnermusicthailand, gmmtv, gdh, etc. See Station Home List for complete details.
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Live schedule
Gets live schedule information.
Example request
# HTTP request
GET https://api.line.me/line-tv/v1/live/schedule?lineChannelId={lineChannelId}&country=th
# Request headers
Content-Type
application/json
Authorization
Bearer {channel access token}
# Query parameters
lineChannelId
String
Channel ID. Found on the LINE Developers Console.
country
String
th
# Response
Returns a 200 HTTP status code and a JSON object with the following information.
header
Object
body
Object
Example response
# Object definitions
# Clip object
The clip is the video content, whereas the clip object is the video information.
clipNo
Long
Clip unique ID
clipTitle
String
Clip title
likeitPoint
Long
Likeit count
playCount
Long
Play count
displayPlayTime
String
Playtime of clip
thumbnailUrl
String
Thumbnail URL
serviceUrl
String
URL of LINE TV service
Clip object example
# Channel object
The channel is the parent model of the video and playlist. The channel object contains the channel.
channelId
String
Channel ID
channelName
String
Channel name
thumbnailUrl
String
thumbnail Url
serviceUrl
String
Url of LINE TV service
badgeType
String
NEW, UPDATE
channelEmblem
String
Round type thumbnail Url
Channel object example
# Playlist object
Playlist object example
# Detail playlist object
Playlist object
clipCount
Integer
Count of clips
playlistNo
Integer
Playlist unique ID
thumbnailUrl
String
Playlist thumbnail URL
playlistTitle
String
Playlist title
serviceUrl
String
URL of LINE TV service
Detail playlist object example
# Station object
The station is the parent model of the channel. The station object contains the (TV Station) data.
stationId
String
Station unique ID
stationName
String
Station name
stationDesc
String
Station description
stationLogo
String
Logo thumbnail URL
stationBigBanner
String
Big banner thumbnail URL
playCount
Long
Play count
likeitCount
Long
Likeit count
fanCount
Long
Fan count
clipCount
Long
Count of clips
channelCount
Long
Count of channels
popularClip
Array of Clip objects
List of clips in order of popularity
popularChannel
Array of Channel objects
List of channels in order of popularity
stationBanner
Object
Banner thumbnail URL and link
Station object example
# Live object
Live video is real-time content streaming.
serviceUrl
String
URL of LINETV service
channelName
String
Name of the channel that has live
playCount
String
Play count
liveTitle
String
Live title
thumbnailUrl
String
Live thumbnail URL
liveNo
String
Live unique no
liveStatus
String
NOT_AVAILABLE_LIVE(Deleted or not exposure), UPCOMING(Before live), LIVE(Live), PREPARE_CLIP(Live end), LIVE_END(Live end), MOVE_TO_CLIP(Live end), BLOCK(Block by administrator)
liveStartDate
String
Start date
liveEndDate
String
End date
likeitPoint
String
Likeit count
Live object example