[yt-dlp.git] / youtube_dl / extractor / qqmusic.py

# coding: utf-8
from __future__ import unicode_literals

import random
import time
import re

from .common import InfoExtractor
from ..utils import (
    strip_jsonp,
    unescapeHTML,
    clean_html,
)
from ..compat import compat_urllib_request


class QQMusicIE(InfoExtractor):
    IE_NAME = 'qqmusic'
    _VALID_URL = r'http://y.qq.com/#type=song&mid=(?P<id>[0-9A-Za-z]+)'
    _TESTS = [{
        'url': 'http://y.qq.com/#type=song&mid=004295Et37taLD',
        'md5': '9ce1c1c8445f561506d2e3cfb0255705',
        'info_dict': {
            'id': '004295Et37taLD',
            'ext': 'mp3',
            'title': '可惜没如果',
            'upload_date': '20141227',
            'creator': '林俊杰',
            'description': 'md5:d327722d0361576fde558f1ac68a7065',
        }
    }]

    _FORMATS = {
        'mp3-320': {'prefix': 'M800', 'ext': 'mp3', 'preference': 40, 'abr': 320},
        'mp3-128': {'prefix': 'M500', 'ext': 'mp3', 'preference': 30, 'abr': 128},
        'm4a': {'prefix': 'C200', 'ext': 'm4a', 'preference': 10}
    }

    # Reference: m_r_GetRUin() in top_player.js
    # http://imgcache.gtimg.cn/music/portal_v3/y/top_player.js
    @staticmethod
    def m_r_get_ruin():
        curMs = int(time.time() * 1000) % 1000
        return int(round(random.random() * 2147483647) * curMs % 1E10)

    def _real_extract(self, url):
        mid = self._match_id(url)

        detail_info_page = self._download_webpage(
            'http://s.plcloud.music.qq.com/fcgi-bin/fcg_yqq_song_detail_info.fcg?songmid=%s&play=0' % mid,
            mid, note='Download song detail info',
            errnote='Unable to get song detail info', encoding='gbk')

        song_name = self._html_search_regex(
            r"songname:\s*'([^']+)'", detail_info_page, 'song name')

        publish_time = self._html_search_regex(
            r'发行时间：(\d{4}-\d{2}-\d{2})', detail_info_page,
            'publish time', default=None)
        if publish_time:
            publish_time = publish_time.replace('-', '')

        singer = self._html_search_regex(
            r"singer:\s*'([^']+)", detail_info_page, 'singer', default=None)

        lrc_content = self._html_search_regex(
            r'<div class="content" id="lrc_content"[^<>]*>([^<>]+)</div>',
            detail_info_page, 'LRC lyrics', default=None)
        if lrc_content:
            lrc_content = lrc_content.replace('\\n', '\n')

        guid = self.m_r_get_ruin()

        vkey = self._download_json(
            'http://base.music.qq.com/fcgi-bin/fcg_musicexpress.fcg?json=3&guid=%s' % guid,
            mid, note='Retrieve vkey', errnote='Unable to get vkey',
            transform_source=strip_jsonp)['key']

        formats = []
        for format_id, details in self._FORMATS.items():
            formats.append({
                'url': 'http://cc.stream.qqmusic.qq.com/%s%s.%s?vkey=%s&guid=%s&fromtag=0'
                       % (details['prefix'], mid, details['ext'], vkey, guid),
                'format': format_id,
                'format_id': format_id,
                'preference': details['preference'],
                'abr': details.get('abr'),
            })
        self._sort_formats(formats)

        return {
            'id': mid,
            'formats': formats,
            'title': song_name,
            'upload_date': publish_time,
            'creator': singer,
            'description': lrc_content,
        }


class QQPlaylistBaseIE(InfoExtractor):
    @staticmethod
    def qq_static_url(category, mid):
        return 'http://y.qq.com/y/static/%s/%s/%s/%s.html' % (category, mid[-2], mid[-1], mid)

    @classmethod
    def get_entries_from_page(cls, page):
        entries = []

        for item in re.findall(r'class="data"[^<>]*>([^<>]+)</', page):
            song_mid = unescapeHTML(item).split('|')[-5]
            entries.append(cls.url_result(
                'http://y.qq.com/#type=song&mid=' + song_mid, 'QQMusic',
                song_mid))

        return entries


class QQMusicSingerIE(QQPlaylistBaseIE):
    IE_NAME = 'qqmusic:singer'
    _VALID_URL = r'http://y.qq.com/#type=singer&mid=(?P<id>[0-9A-Za-z]+)'
    _TEST = {
        'url': 'http://y.qq.com/#type=singer&mid=001BLpXF2DyJe2',
        'info_dict': {
            'id': '001BLpXF2DyJe2',
            'title': '林俊杰',
            'description': 'md5:2a222d89ba4455a3af19940c0481bb78',
        },
        'playlist_count': 12,
    }

    def _real_extract(self, url):
        mid = self._match_id(url)

        singer_page = self._download_webpage(
            self.qq_static_url('singer', mid), mid, 'Download singer page')

        entries = self.get_entries_from_page(singer_page)

        singer_name = self._html_search_regex(
            r"singername\s*:\s*'([^']+)'", singer_page, 'singer name',
            default=None)

        singer_id = self._html_search_regex(
            r"singerid\s*:\s*'([0-9]+)'", singer_page, 'singer id',
            default=None)

        singer_desc = None

        if singer_id:
            req = compat_urllib_request.Request(
                'http://s.plcloud.music.qq.com/fcgi-bin/fcg_get_singer_desc.fcg?utf8=1&outCharset=utf-8&format=xml&singerid=%s' % singer_id)
            req.add_header(
                'Referer', 'http://s.plcloud.music.qq.com/xhr_proxy_utf8.html')
            singer_desc_page = self._download_xml(
                req, mid, 'Donwload singer description XML')

            singer_desc = singer_desc_page.find('./data/info/desc').text

        return self.playlist_result(entries, mid, singer_name, singer_desc)


class QQMusicAlbumIE(QQPlaylistBaseIE):
    IE_NAME = 'qqmusic:album'
    _VALID_URL = r'http://y.qq.com/#type=album&mid=(?P<id>[0-9A-Za-z]+)'

    _TESTS = [{
        'url': 'http://y.qq.com/#type=album&mid=000gXCTb2AhRR1',
        'info_dict': {
            'id': '000gXCTb2AhRR1',
            'title': '我们都是这样长大的',
            'description': 'md5:712f0cdbfc7e776820d08150e6df593d',
        },
        'playlist_count': 4,
    }, {
        'url': 'http://y.qq.com/#type=album&mid=002Y5a3b3AlCu3',
        'info_dict': {
            'id': '002Y5a3b3AlCu3',
            'title': '그리고...',
            'description': 'md5:b1d133b8c9bac8fed4e1a97df759f4cf',
        },
        'playlist_count': 8,
    }]

    def _real_extract(self, url):
        mid = self._match_id(url)

        album = self._download_json(
            'http://i.y.qq.com/v8/fcg-bin/fcg_v8_album_info_cp.fcg?albummid=%s&format=json' % mid,
            mid, 'Download album page')['data']

        entries = [
            self.url_result(
                'http://y.qq.com/#type=song&mid=' + song['songmid'], 'QQMusic', song['songmid']
            ) for song in album['list']
        ]
        album_name = album['name']
        album_detail = album.get('desc')

        return self.playlist_result(entries, mid, album_name, album_detail)


class QQMusicToplistIE(QQPlaylistBaseIE):
    IE_NAME = 'qqmusic:toplist'
    _VALID_URL = r'http://y\.qq\.com/#type=toplist&p=(?P<id>(top|global)_[0-9]+)'

    _TESTS = [{
        'url': 'http://y.qq.com/#type=toplist&p=global_123',
        'info_dict': {
            'id': 'global_123',
            'title': '美国iTunes榜',
        },
        'playlist_count': 10,
    }, {
        'url': 'http://y.qq.com/#type=toplist&p=top_3',
        'info_dict': {
            'id': 'top_3',
            'title': 'QQ音乐巅峰榜·欧美',
            'description': 'QQ音乐巅峰榜·欧美根据用户收听行为自动生成，集结当下最流行的欧美新歌！:更新时间：每周四22点|统'
                           '计周期：一周（上周四至本周三）|统计对象：三个月内发行的欧美歌曲|统计数量：100首|统计算法：根据'
                           '歌曲在一周内的有效播放次数，由高到低取前100名（同一歌手最多允许5首歌曲同时上榜）|有效播放次数：'
                           '登录用户完整播放一首歌曲，记为一次有效播放；同一用户收听同一首歌曲，每天记录为1次有效播放'
        },
        'playlist_count': 100,
    }, {
        'url': 'http://y.qq.com/#type=toplist&p=global_106',
        'info_dict': {
            'id': 'global_106',
            'title': '韩国Mnet榜',
        },
        'playlist_count': 50,
    }]

    def _real_extract(self, url):
        list_id = self._match_id(url)

        list_type, num_id = list_id.split("_")

        toplist_json = self._download_json(
            'http://i.y.qq.com/v8/fcg-bin/fcg_v8_toplist_cp.fcg?type=%s&topid=%s&format=json'
            % (list_type, num_id),
            list_id, 'Download toplist page')

        entries = [
            self.url_result(
                'http://y.qq.com/#type=song&mid=' + song['data']['songmid'], 'QQMusic', song['data']['songmid']
            ) for song in toplist_json['songlist']
        ]

        topinfo = toplist_json.get('topinfo', {})
        list_name = topinfo.get('ListName')
        list_description = topinfo.get('info')
        return self.playlist_result(entries, list_id, list_name, list_description)


class QQMusicPlaylistIE(QQPlaylistBaseIE):
    IE_NAME = 'qqmusic:playlist'
    _VALID_URL = r'http://y\.qq\.com/#type=taoge&id=(?P<id>[0-9]+)'

    _TEST = {
        'url': 'http://y.qq.com/#type=taoge&id=3462654915',
        'info_dict': {
            'id': '3462654915',
            'title': '韩国5月新歌精选下旬',
            'description': 'md5:d2c9d758a96b9888cf4fe82f603121d4',
        },
        'playlist_count': 40,
    }

    def _real_extract(self, url):
        list_id = self._match_id(url)

        list_json = self._download_json(
            'http://i.y.qq.com/qzone-music/fcg-bin/fcg_ucc_getcdinfo_byids_cp.fcg?type=1&json=1&utf8=1&onlysong=0&disstid=%s'
            % list_id, list_id, 'Download list page',
            transform_source=strip_jsonp)['cdlist'][0]

        entries = [
            self.url_result(
                'http://y.qq.com/#type=song&mid=' + song['songmid'], 'QQMusic', song['songmid']
            ) for song in list_json['songlist']
        ]

        list_name = list_json.get('dissname')
        list_description = clean_html(unescapeHTML(list_json.get('desc')))
        return self.playlist_result(entries, list_id, list_name, list_description)
Commit	Line	Data
5d98908b YCH	1	# coding: utf-8
	2	from __future__ import unicode_literals
	3
a2043572 YCH	4	import random
a2043572 YCH	5	import time
8afff9f8	6	import re
a2043572	7
5d98908b	8	from .common import InfoExtractor
5edea45f YCH	9	from ..utils import (
	10	strip_jsonp,
	11	unescapeHTML,
0d0d5d37	12	clean_html,
5edea45f	13	)
8afff9f8	14	from ..compat import compat_urllib_request
5d98908b	15
5d98908b YCH	16
5d98908b YCH	17	class QQMusicIE(InfoExtractor):
7ec676bb	18	IE_NAME = 'qqmusic'
5d98908b YCH	19	_VALID_URL = r'http://y.qq.com/#type=song&mid=(?P<id>[0-9A-Za-z]+)'
	20	_TESTS = [{
	21	'url': 'http://y.qq.com/#type=song&mid=004295Et37taLD',
55e5841f	22	'md5': '9ce1c1c8445f561506d2e3cfb0255705',
5d98908b YCH	23	'info_dict': {
5d98908b YCH	24	'id': '004295Et37taLD',
55e5841f	25	'ext': 'mp3',
5d98908b YCH	26	'title': '可惜没如果',
	27	'upload_date': '20141227',
	28	'creator': '林俊杰',
b813d8ca	29	'description': 'md5:d327722d0361576fde558f1ac68a7065',
5d98908b YCH	30	}
	31	}]
	32
55e5841f	33	_FORMATS = {
8b8cde21	34	'mp3-320': {'prefix': 'M800', 'ext': 'mp3', 'preference': 40, 'abr': 320},
8b8cde21	35	'mp3-128': {'prefix': 'M500', 'ext': 'mp3', 'preference': 30, 'abr': 128},
55e5841f	36	'm4a': {'prefix': 'C200', 'ext': 'm4a', 'preference': 10}
	37	}
	38
a2043572 YCH	39	# Reference: m_r_GetRUin() in top_player.js
	40	# http://imgcache.gtimg.cn/music/portal_v3/y/top_player.js
	41	@staticmethod
	42	def m_r_get_ruin():
	43	curMs = int(time.time() * 1000) % 1000
	44	return int(round(random.random() * 2147483647) * curMs % 1E10)
	45
5d98908b YCH	46	def _real_extract(self, url):
	47	mid = self._match_id(url)
	48
	49	detail_info_page = self._download_webpage(
	50	'http://s.plcloud.music.qq.com/fcgi-bin/fcg_yqq_song_detail_info.fcg?songmid=%s&play=0' % mid,
8afff9f8	51	mid, note='Download song detail info',
c9a77969	52	errnote='Unable to get song detail info', encoding='gbk')
5d98908b YCH	53
	54	song_name = self._html_search_regex(
	55	r"songname:\s*'([^']+)'", detail_info_page, 'song name')
	56
	57	publish_time = self._html_search_regex(
	58	r'发行时间：(\d{4}-\d{2}-\d{2})', detail_info_page,
a685ae51 YCH	59	'publish time', default=None)
	60	if publish_time:
	61	publish_time = publish_time.replace('-', '')
5d98908b YCH	62
5d98908b YCH	63	singer = self._html_search_regex(
a685ae51 YCH	64	r"singer:\s*'([^']+)", detail_info_page, 'singer', default=None)
	65
	66	lrc_content = self._html_search_regex(
	67	r'<div class="content" id="lrc_content"[^<>]*>([^<>]+)</div>',
	68	detail_info_page, 'LRC lyrics', default=None)
b813d8ca YCH	69	if lrc_content:
b813d8ca YCH	70	lrc_content = lrc_content.replace('\\n', '\n')
5d98908b	71
a2043572 YCH	72	guid = self.m_r_get_ruin()
a2043572 YCH	73
5d98908b YCH	74	vkey = self._download_json(
	75	'http://base.music.qq.com/fcgi-bin/fcg_musicexpress.fcg?json=3&guid=%s' % guid,
	76	mid, note='Retrieve vkey', errnote='Unable to get vkey',
	77	transform_source=strip_jsonp)['key']
55e5841f	78
55e5841f	79	formats = []
e8ac61e8	80	for format_id, details in self._FORMATS.items():
55e5841f	81	formats.append({
55e5841f	82	'url': 'http://cc.stream.qqmusic.qq.com/%s%s.%s?vkey=%s&guid=%s&fromtag=0'
e8ac61e8 YCH	83	% (details['prefix'], mid, details['ext'], vkey, guid),
	84	'format': format_id,
	85	'format_id': format_id,
	86	'preference': details['preference'],
	87	'abr': details.get('abr'),
55e5841f	88	})
55e5841f	89	self._sort_formats(formats)
5d98908b YCH	90
	91	return {
	92	'id': mid,
55e5841f	93	'formats': formats,
5d98908b YCH	94	'title': song_name,
	95	'upload_date': publish_time,
	96	'creator': singer,
a685ae51	97	'description': lrc_content,
5d98908b	98	}
8afff9f8 YCH	99
8afff9f8 YCH	100
5edea45f YCH	101	class QQPlaylistBaseIE(InfoExtractor):
	102	@staticmethod
	103	def qq_static_url(category, mid):
	104	return 'http://y.qq.com/y/static/%s/%s/%s/%s.html' % (category, mid[-2], mid[-1], mid)
	105
5edea45f YCH	106	@classmethod
	107	def get_entries_from_page(cls, page):
	108	entries = []
	109
	110	for item in re.findall(r'class="data"[^<>]*>([^<>]+)</', page):
	111	song_mid = unescapeHTML(item).split('\|')[-5]
	112	entries.append(cls.url_result(
a685ae51 YCH	113	'http://y.qq.com/#type=song&mid=' + song_mid, 'QQMusic',
a685ae51 YCH	114	song_mid))
5edea45f YCH	115
	116	return entries
	117
	118
	119	class QQMusicSingerIE(QQPlaylistBaseIE):
7ec676bb	120	IE_NAME = 'qqmusic:singer'
8afff9f8 YCH	121	_VALID_URL = r'http://y.qq.com/#type=singer&mid=(?P<id>[0-9A-Za-z]+)'
	122	_TEST = {
	123	'url': 'http://y.qq.com/#type=singer&mid=001BLpXF2DyJe2',
	124	'info_dict': {
	125	'id': '001BLpXF2DyJe2',
	126	'title': '林俊杰',
	127	'description': 'md5:2a222d89ba4455a3af19940c0481bb78',
	128	},
	129	'playlist_count': 12,
	130	}
	131
	132	def _real_extract(self, url):
	133	mid = self._match_id(url)
	134
	135	singer_page = self._download_webpage(
5edea45f	136	self.qq_static_url('singer', mid), mid, 'Download singer page')
8afff9f8	137
5edea45f	138	entries = self.get_entries_from_page(singer_page)
8afff9f8 YCH	139
	140	singer_name = self._html_search_regex(
	141	r"singername\s:\s'([^']+)'", singer_page, 'singer name',
	142	default=None)
	143
	144	singer_id = self._html_search_regex(
	145	r"singerid\s:\s'([0-9]+)'", singer_page, 'singer id',
	146	default=None)
	147
	148	singer_desc = None
	149
	150	if singer_id:
	151	req = compat_urllib_request.Request(
	152	'http://s.plcloud.music.qq.com/fcgi-bin/fcg_get_singer_desc.fcg?utf8=1&outCharset=utf-8&format=xml&singerid=%s' % singer_id)
	153	req.add_header(
	154	'Referer', 'http://s.plcloud.music.qq.com/xhr_proxy_utf8.html')
	155	singer_desc_page = self._download_xml(
5edea45f	156	req, mid, 'Donwload singer description XML')
8afff9f8 YCH	157
	158	singer_desc = singer_desc_page.find('./data/info/desc').text
	159
	160	return self.playlist_result(entries, mid, singer_name, singer_desc)
5edea45f YCH	161
	162
	163	class QQMusicAlbumIE(QQPlaylistBaseIE):
7ec676bb	164	IE_NAME = 'qqmusic:album'
5edea45f YCH	165	_VALID_URL = r'http://y.qq.com/#type=album&mid=(?P<id>[0-9A-Za-z]+)'
5edea45f YCH	166
29b809de	167	_TESTS = [{
29b809de	168	'url': 'http://y.qq.com/#type=album&mid=000gXCTb2AhRR1',
5edea45f YCH	169	'info_dict': {
	170	'id': '000gXCTb2AhRR1',
	171	'title': '我们都是这样长大的',
29b809de	172	'description': 'md5:712f0cdbfc7e776820d08150e6df593d',
5edea45f YCH	173	},
5edea45f YCH	174	'playlist_count': 4,
29b809de	175	}, {
	176	'url': 'http://y.qq.com/#type=album&mid=002Y5a3b3AlCu3',
	177	'info_dict': {
	178	'id': '002Y5a3b3AlCu3',
	179	'title': '그리고...',
	180	'description': 'md5:b1d133b8c9bac8fed4e1a97df759f4cf',
	181	},
	182	'playlist_count': 8,
	183	}]
5edea45f YCH	184
	185	def _real_extract(self, url):
	186	mid = self._match_id(url)
	187
29b809de	188	album = self._download_json(
	189	'http://i.y.qq.com/v8/fcg-bin/fcg_v8_album_info_cp.fcg?albummid=%s&format=json' % mid,
	190	mid, 'Download album page')['data']
	191
	192	entries = [
	193	self.url_result(
	194	'http://y.qq.com/#type=song&mid=' + song['songmid'], 'QQMusic', song['songmid']
	195	) for song in album['list']
	196	]
	197	album_name = album['name']
	198	album_detail = album.get('desc')
5edea45f YCH	199
5edea45f YCH	200	return self.playlist_result(entries, mid, album_name, album_detail)
41333b97	201
	202
	203	class QQMusicToplistIE(QQPlaylistBaseIE):
7ec676bb	204	IE_NAME = 'qqmusic:toplist'
41333b97	205	_VALID_URL = r'http://y\.qq\.com/#type=toplist&p=(?P<id>(top\|global)_[0-9]+)'
54889739	206
41333b97	207	_TESTS = [{
eedda32e	208	'url': 'http://y.qq.com/#type=toplist&p=global_123',
41333b97	209	'info_dict': {
eedda32e	210	'id': 'global_123',
eedda32e	211	'title': '美国iTunes榜',
41333b97	212	},
	213	'playlist_count': 10,
	214	}, {
eedda32e	215	'url': 'http://y.qq.com/#type=toplist&p=top_3',
41333b97	216	'info_dict': {
eedda32e	217	'id': 'top_3',
41333b97	218	'title': 'QQ音乐巅峰榜·欧美',
eedda32e	219	'description': 'QQ音乐巅峰榜·欧美根据用户收听行为自动生成，集结当下最流行的欧美新歌！:更新时间：每周四22点\|统'
	220	'计周期：一周（上周四至本周三）\|统计对象：三个月内发行的欧美歌曲\|统计数量：100首\|统计算法：根据'
	221	'歌曲在一周内的有效播放次数，由高到低取前100名（同一歌手最多允许5首歌曲同时上榜）\|有效播放次数：'
	222	'登录用户完整播放一首歌曲，记为一次有效播放；同一用户收听同一首歌曲，每天记录为1次有效播放'
41333b97	223	},
41333b97	224	'playlist_count': 100,
fd4eefed	225	}, {
eedda32e	226	'url': 'http://y.qq.com/#type=toplist&p=global_106',
fd4eefed	227	'info_dict': {
eedda32e	228	'id': 'global_106',
eedda32e	229	'title': '韩国Mnet榜',
fd4eefed	230	},
fd4eefed	231	'playlist_count': 50,
41333b97	232	}]
41333b97	233
41333b97	234	def _real_extract(self, url):
	235	list_id = self._match_id(url)
	236
29ea5728	237	list_type, num_id = list_id.split("_")
41333b97	238
29ea5728	239	toplist_json = self._download_json(
eedda32e	240	'http://i.y.qq.com/v8/fcg-bin/fcg_v8_toplist_cp.fcg?type=%s&topid=%s&format=json'
	241	% (list_type, num_id),
	242	list_id, 'Download toplist page')
41333b97	243
eedda32e	244	entries = [
	245	self.url_result(
	246	'http://y.qq.com/#type=song&mid=' + song['data']['songmid'], 'QQMusic', song['data']['songmid']
	247	) for song in toplist_json['songlist']
	248	]
41333b97	249
9d4f213f YCH	250	topinfo = toplist_json.get('topinfo', {})
	251	list_name = topinfo.get('ListName')
	252	list_description = topinfo.get('info')
eedda32e	253	return self.playlist_result(entries, list_id, list_name, list_description)
0d0d5d37	254
	255
	256	class QQMusicPlaylistIE(QQPlaylistBaseIE):
	257	IE_NAME = 'qqmusic:playlist'
	258	_VALID_URL = r'http://y\.qq\.com/#type=taoge&id=(?P<id>[0-9]+)'
	259
	260	_TEST = {
	261	'url': 'http://y.qq.com/#type=taoge&id=3462654915',
	262	'info_dict': {
	263	'id': '3462654915',
	264	'title': '韩国5月新歌精选下旬',
	265	'description': 'md5:d2c9d758a96b9888cf4fe82f603121d4',
	266	},
	267	'playlist_count': 40,
	268	}
	269
	270	def _real_extract(self, url):
	271	list_id = self._match_id(url)
	272
	273	list_json = self._download_json(
	274	'http://i.y.qq.com/qzone-music/fcg-bin/fcg_ucc_getcdinfo_byids_cp.fcg?type=1&json=1&utf8=1&onlysong=0&disstid=%s'
	275	% list_id, list_id, 'Download list page',
	276	transform_source=strip_jsonp)['cdlist'][0]
	277
	278	entries = [
	279	self.url_result(
	280	'http://y.qq.com/#type=song&mid=' + song['songmid'], 'QQMusic', song['songmid']
	281	) for song in list_json['songlist']
	282	]
	283
e9d33454	284	list_name = list_json.get('dissname')
0d0d5d37	285	list_description = clean_html(unescapeHTML(list_json.get('desc')))
0d0d5d37	286	return self.playlist_result(entries, list_id, list_name, list_description)