淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
offset	Number	可选	0	默认值：0	偏移量
page_size	Number	可选	20	默认值：20	分页大小

名称	类型	示例值	描述
result	Result		result
└ code String SUCCESS code └ detail_message String - detailMessage └ message String 成功 message └ success Boolean true success value ShowPageResult - 数据详情 └ has_next_page Boolean true 是否有下一页数据 └ offset Number 654764 当前偏移量 show_list Show [] - 节目列表详情 └ area String 大陆、香港国家地区 └ category String 电影节目一级分类 └ check_state_list String [] CIBN 节目校验通过牌照列表（目前只针对CIBN有用） └ description String 孙悟空（周星驰饰）护送唐三藏（罗家英饰）去西天取经路上，与牛魔王（陆树铭饰）合谋欲杀害唐三藏，并偷走了月光宝盒，此举使观音萌生将其铲除心思，经唐三藏请求，孙悟空被判五百年后重新投胎做人赎其罪孽。　　五百年后孙悟空化身强盗头头至尊宝（周星驰饰）。当遇见预谋吃唐僧肉的妖怪姐妹蜘蛛精春三十娘（蓝洁瑛饰）和白骨精白晶晶（莫文蔚饰）时，因为五百年前孙悟空曾与白晶晶有过一段恋情，至尊宝与她一见钟情，但因菩提老祖（刘镇伟饰）将二人妖怪身份相告，至尊宝仍带领众强盗开始与二妖展开周旋，过程中，白晶晶为救至尊宝打伤春三十娘，自己也中毒受伤，为了救白晶晶，至尊宝去找春三十娘，遭白晶晶误会，绝望自杀，至尊宝开始用月光宝盒以期使时光倒流。描述 director_list Person [] - 导演 └ charactor String [] ["至尊宝"] 描述 └ id Number 123 id └ name String 刘镇伟名字 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ episode_count String 12 总集数 └ keyword String ["网剧"] 关键字 └ keyword_list String [] ["网剧"] 关键字列表 └ language_list String [] 国语语言列表 └ license_list String [] CIBN 牌照列表 └ paid Number 0 是否收费 0:免费 1:收费 └ pay_type_list String [] mon 付费模式，mon=包月，vod=单点 performer_list Person [] - 演员列表 └ charactor String [] ["至尊宝"] 描述 └ id Number 123 id └ name String 周星驰名字 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ price Number 500 价格，单位为人民币分 └ release_date String 2016-10-01 00:00:00 节目发行时间 └ show_id String cc036ab2962411de83b1 节目id └ small_thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 横版海报缩略图 └ small_vthumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 竖版海报缩略图 starring_list Person [] - 主演列表 └ charactor String [] ["至尊宝"] 角色 └ id Number 123 id └ name String 周星驰名字 └ thumb_url String http://r4.ykimg.com/0513000051FA14A36758391B7F0C4011 人物图片 └ status String 在线数娱媒资状态，包括“在线”，“下线” └ sub_category String 奇幻、冒险、动作、喜剧、爱情子分类 └ thumb_url String http://r4.ykimg.com/050B000051D6667F6758397997070849 海报(横版) └ title String 大话西游节目名称 └ try_episodes Number 0 试看集数 └ try_time Number 0 试看时间(秒) └ try_type String time 试看类型不支持试看(cannot) 节目按时长试看(time) 节目按集数试看(episodes) └ vthumb_url String http://r4.ykimg.com/050D000051D666A267583979CB05E2DE 海报(竖版) └ web_url String http://www.soku.com/detail/show/XNDAwMDQ= webUrl └ youku_rating String 7.456 优酷评分 └ huge_thumb_url String http://r4.ykimg.com/050D000051D666A267583979CB05E2DE 大海报 └ huge_vthumb_url String http://r4.ykimg.com/050D000051D666A267583979CB05E2DE 大海报(竖) └ vod_fullprice Boolean false 是否是全价节目,true为全价，false为半价 └ exclusive Boolean true 节目是否独播 ,true独播，false非独播 └ vod_ticket Boolean true 点播是否可用券,true为可用券false为非可用券 └ releasedate_youku String 2016-10-01 00:00:00 优酷发行时间 └ show_kind String ["PGC","文化"] 节目性质 └ completed Boolean false 是否完结 └ liveid String 12121212 直播id └ episode_last Number 6 最新集数 └ distributor String 发行公司 20世纪福克斯电影公司、环球影业 └ production String 制作公司河北电影电视剧制作中心、太原电视台 guest_list Person [] -- 嘉宾列表 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ name String 王凯人物名 └ id Number id id └ charactor String [] ["至尊宝"] 角色名 └ program_id Number 136008 program id └ sub_title String 三生爱恨牵引三世纠葛节目子标题 └ zreal Boolean false 是否是帧享 └ update_notice String 每天24点更新更新提示 └ permit_duration Number 2 消费期(收费节目)(天)

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmacShowpageGetRequest req = new VmacShowpageGetRequest();
req.setOffset(0L);
req.setPageSize(20L);
VmacShowpageGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
VmacShowpageGetRequest req = new VmacShowpageGetRequest();
req.Offset = 0L;
req.PageSize = 20L;
VmacShowpageGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new VmacShowpageGetRequest;
$req->setOffset("0");
$req->setPageSize("20");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.vmac.showpage.get' \
-d 'partner_id=apidoc' \
-d 'sign=0B746F54756211C0E6E8BE347C9CA738' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+16%3A39%3A25' \
-d 'v=2.0' \
-d 'offset=0' \
-d 'page_size=20'

# -*- coding: utf-8 -*-
import top.api

req=top.api.VmacShowpageGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.offset=0
req.page_size=20
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.vmac.showpage.get");
add_param(pRequest,"offset","0");
add_param(pRequest,"page_size","20");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.vmac.showpage.get', {
	'offset':'0',
	'page_size':'20'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<vmac_showpage_get_response>
    <result>
        <code>SUCCESS</code>
        <detail_message>-</detail_message>
        <message>成功</message>
        <success>true</success>
        <value>
            <has_next_page>true</has_next_page>
            <offset>654764</offset>
            <show_list>
                <show>
                    <area>大陆、香港</area>
                    <category>电影</category>
                    <check_state_list>
                        <string>CIBN</string>
                    </check_state_list>
                    <description>孙悟空（周星驰 饰）护送唐三藏（罗家英 饰）去西天取经路上，与牛魔王（陆树铭 饰）合谋欲杀害唐三藏，并偷走了月光宝盒，此举使观音萌生将其铲除心思，经唐三藏请求，孙悟空被判五百年后重新投胎做人赎其罪孽。 　　五百年后孙悟空化身强盗头头至尊宝（周星驰 饰）。当遇见预谋吃唐僧肉的妖怪姐妹蜘蛛精春三十娘（蓝洁瑛 饰）和白骨精白晶晶（莫文蔚 饰）时，因为五百年前孙悟空曾与白晶晶有过一段恋情，至尊宝与她一见钟情，但因菩提老祖（刘镇伟 饰）将二人妖怪身份相告，至尊宝仍带领众强盗开始与二妖展开周旋，过程中，白晶晶为救至尊宝打伤春三十娘，自己也中毒受伤，为了救白晶晶，至尊宝去找春三十娘，遭白晶晶误会，绝望自杀，至尊宝开始用月光宝盒以期使时光倒流。</description>
                    <director_list>
                        <person>
                            <charactor>
                                <string>[&quot;至尊宝&quot;]</string>
                            </charactor>
                            <id>123</id>
                            <name>刘镇伟</name>
                            <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        </person>
                    </director_list>
                    <episode_count>12</episode_count>
                    <keyword>[&quot;网剧&quot;]</keyword>
                    <keyword_list>
                        <string>[&quot;网剧&quot;]</string>
                    </keyword_list>
                    <language_list>
                        <string>国语</string>
                    </language_list>
                    <license_list>
                        <string>CIBN</string>
                    </license_list>
                    <paid>0</paid>
                    <pay_type_list>
                        <string>mon</string>
                    </pay_type_list>
                    <performer_list>
                        <person>
                            <charactor>
                                <string>[&quot;至尊宝&quot;]</string>
                            </charactor>
                            <id>123</id>
                            <name>周星驰</name>
                            <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        </person>
                    </performer_list>
                    <price>500</price>
                    <release_date>2016-10-01 00:00:00</release_date>
                    <show_id>cc036ab2962411de83b1</show_id>
                    <small_thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</small_thumb_url>
                    <small_vthumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</small_vthumb_url>
                    <starring_list>
                        <person>
                            <charactor>
                                <string>[&quot;至尊宝&quot;]</string>
                            </charactor>
                            <id>123</id>
                            <name>周星驰</name>
                            <thumb_url>http://r4.ykimg.com/0513000051FA14A36758391B7F0C4011</thumb_url>
                        </person>
                    </starring_list>
                    <status>在线</status>
                    <sub_category>奇幻、冒险、动作、喜剧、爱情</sub_category>
                    <thumb_url>http://r4.ykimg.com/050B000051D6667F6758397997070849</thumb_url>
                    <title>大话西游</title>
                    <try_episodes>0</try_episodes>
                    <try_time>0</try_time>
                    <try_type>time</try_type>
                    <vthumb_url>http://r4.ykimg.com/050D000051D666A267583979CB05E2DE</vthumb_url>
                    <web_url>http://www.soku.com/detail/show/XNDAwMDQ=</web_url>
                    <youku_rating>7.456</youku_rating>
                    <huge_thumb_url>http://r4.ykimg.com/050D000051D666A267583979CB05E2DE</huge_thumb_url>
                    <huge_vthumb_url>http://r4.ykimg.com/050D000051D666A267583979CB05E2DE</huge_vthumb_url>
                    <vod_fullprice>false</vod_fullprice>
                    <exclusive>true</exclusive>
                    <vod_ticket>true</vod_ticket>
                    <releasedate_youku>2016-10-01 00:00:00</releasedate_youku>
                    <show_kind>[&quot;PGC&quot;,&quot;文化&quot;]</show_kind>
                    <completed>false</completed>
                    <liveid>12121212</liveid>
                    <episode_last>6</episode_last>
                    <distributor>发行公司</distributor>
                    <production>制作公司</production>
                    <guest_list>
                        <person>
                            <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                            <name>王凯</name>
                            <id>id</id>
                            <charactor>
                                <string>[&quot;至尊宝&quot;]</string>
                            </charactor>
                        </person>
                    </guest_list>
                    <program_id>136008</program_id>
                    <sub_title>三生爱恨牵引三世纠葛</sub_title>
                    <zreal>false</zreal>
                    <update_notice>每天24点更新</update_notice>
                    <permit_duration>2</permit_duration>
                </show>
            </show_list>
        </value>
    </result>
</vmac_showpage_get_response>

{
    "vmac_showpage_get_response":{
        "result":{
            "code":"SUCCESS",
            "detail_message":"-",
            "message":"成功",
            "success":true,
            "value":{
                "has_next_page":true,
                "offset":654764,
                "show_list":{
                    "show":[
                        {
                            "area":"大陆、香港",
                            "category":"电影",
                            "check_state_list":{
                                "string":[
                                    "CIBN"
                                ]
                            },
                            "description":"孙悟空（周星驰 饰）护送唐三藏（罗家英 饰）去西天取经路上，与牛魔王（陆树铭 饰）合谋欲杀害唐三藏，并偷走了月光宝盒，此举使观音萌生将其铲除心思，经唐三藏请求，孙悟空被判五百年后重新投胎做人赎其罪孽。 　　五百年后孙悟空化身强盗头头至尊宝（周星驰 饰）。当遇见预谋吃唐僧肉的妖怪姐妹蜘蛛精春三十娘（蓝洁瑛 饰）和白骨精白晶晶（莫文蔚 饰）时，因为五百年前孙悟空曾与白晶晶有过一段恋情，至尊宝与她一见钟情，但因菩提老祖（刘镇伟 饰）将二人妖怪身份相告，至尊宝仍带领众强盗开始与二妖展开周旋，过程中，白晶晶为救至尊宝打伤春三十娘，自己也中毒受伤，为了救白晶晶，至尊宝去找春三十娘，遭白晶晶误会，绝望自杀，至尊宝开始用月光宝盒以期使时光倒流。",
                            "director_list":{
                                "person":[
                                    {
                                        "charactor":{
                                            "string":[
                                                "[\"至尊宝\"]"
                                            ]
                                        },
                                        "id":123,
                                        "name":"刘镇伟",
                                        "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD"
                                    }
                                ]
                            },
                            "episode_count":"12",
                            "keyword":"[\"网剧\"]",
                            "keyword_list":{
                                "string":[
                                    "[\"网剧\"]"
                                ]
                            },
                            "language_list":{
                                "string":[
                                    "国语"
                                ]
                            },
                            "license_list":{
                                "string":[
                                    "CIBN"
                                ]
                            },
                            "paid":0,
                            "pay_type_list":{
                                "string":[
                                    "mon"
                                ]
                            },
                            "performer_list":{
                                "person":[
                                    {
                                        "charactor":{
                                            "string":[
                                                "[\"至尊宝\"]"
                                            ]
                                        },
                                        "id":123,
                                        "name":"周星驰",
                                        "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD"
                                    }
                                ]
                            },
                            "price":500,
                            "release_date":"2016-10-01 00:00:00",
                            "show_id":"cc036ab2962411de83b1",
                            "small_thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                            "small_vthumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                            "starring_list":{
                                "person":[
                                    {
                                        "charactor":{
                                            "string":[
                                                "[\"至尊宝\"]"
                                            ]
                                        },
                                        "id":123,
                                        "name":"周星驰",
                                        "thumb_url":"http:\/\/r4.ykimg.com\/0513000051FA14A36758391B7F0C4011"
                                    }
                                ]
                            },
                            "status":"在线",
                            "sub_category":"奇幻、冒险、动作、喜剧、爱情",
                            "thumb_url":"http:\/\/r4.ykimg.com\/050B000051D6667F6758397997070849",
                            "title":"大话西游",
                            "try_episodes":0,
                            "try_time":0,
                            "try_type":"time",
                            "vthumb_url":"http:\/\/r4.ykimg.com\/050D000051D666A267583979CB05E2DE",
                            "web_url":"http:\/\/www.soku.com\/detail\/show\/XNDAwMDQ=",
                            "youku_rating":"7.456",
                            "huge_thumb_url":"http:\/\/r4.ykimg.com\/050D000051D666A267583979CB05E2DE",
                            "huge_vthumb_url":"http:\/\/r4.ykimg.com\/050D000051D666A267583979CB05E2DE",
                            "vod_fullprice":false,
                            "exclusive":true,
                            "vod_ticket":true,
                            "releasedate_youku":"2016-10-01 00:00:00",
                            "show_kind":"[\"PGC\",\"文化\"]",
                            "completed":false,
                            "liveid":"12121212",
                            "episode_last":6,
                            "distributor":"发行公司",
                            "production":"制作公司",
                            "guest_list":{
                                "person":[
                                    {
                                        "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                        "name":"王凯",
                                        "id":id,
                                        "charactor":{
                                            "string":[
                                                "[\"至尊宝\"]"
                                            ]
                                        }
                                    }
                                ]
                            },
                            "program_id":136008,
                            "sub_title":"三生爱恨牵引三世纠葛",
                            "zreal":false,
                            "update_notice":"每天24点更新",
                            "permit_duration":2
                        }
                    ]
                }
            }
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
SYSTEM_ERROR	系统错误	请联系家庭娱乐媒资开发，并提供错误信息排查。

API测试工具错误码查询工具 SDK下载

开放平台

数娱媒资输出

taobao.vmac.showpage.get (获取节目分页)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ