淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	描述
top_service_context	TopServiceContext	必须	topServiceContext
└ biz_code String 必须 xxxxx api业务线编码
creative_query_v_o	CreativeQueryVo	必须	creativeQueryVO
└ adgroup_id_list Number [] 可选 [68798447504] 单元id集合 └ campaign_id_list Number [] 必须 [68792788657] 计划id集合 └ offset Number 可选 0 偏移量 └ page_size Number 可选 20 页面大小 rpt_query RptQueryVO 可选报表查询条件 └ fields String 可选 charge,adPv,click,ctr,ecpc,cartInshopNum,itemColInshopNum,cvr,alipayInshopNum,alipayInshopAmt 查询指标字段 condition_list RptQueryConditionVO [] 可选 [] 查询条件列表;场景1、实体列表中只需填充汇总报表数据，此时条件列表传一个即可；场景2、实体列表中需同时查询两天的数据做对比，此时条件列表内传两天各自的查询条件； └ adzone_pkg_id_list String [] 可选 [] 流量来源(资源位包id),可为空 └ unify_type String 可选 zhai 归因口径 └ start_time String 可选 2023-08-25 开始时间 └ end_time String 可选 2023-08-25 结束时间 └ is_rt Boolean 可选 true 是否查询实时报表，true查实时、false查离线，不传则默认查离线 └ creative_id Number 可选 68792788612 创意id

名称	类型	示例值	描述
result	TopResult		结果体
info TopInfo 请求系统信息 └ ok Boolean true 是否成功 └ message String 参数错误错误信息 └ error_code String xxxxx 错误编码 creative_ref_v_o_top_bulk_data TopBulkData 结果集 creative_ref_v_o_list CreativeRefVo [] 批量结果集 └ campaign_id Number 68796878069 计划id └ campaign_name String 管家计划_宝贝候选集计划名称 └ adgroup_id Number 68793666608 单元id └ adgroup_name String ds460418344 单元名称 └ creative_id Number 6843262308 创意id └ creative_name String sss 创意名称 └ creative_type Number 1 创意分类,1:静态创意,2:智能创意,3:PSD创意,4:动态文案创意,5:自动化创意,6:智能创意,7:综合静态创意,8:综合智能创意,9:自动直播创意,10:元素化创意,11:素材类创意,12:钻展多图创意 └ source Number 1 创意来源,1:本地上传,2:BannerMaker,3:CreativeCenter,4:LuBan,5:直播广场,6:活动招商,7:海棠,8:原生创意 └ creative_center_id String 225349579 前端创意中心id └ format Number 2 创意格式,1:文字,2:图片,3:Flash,4:视频,5:文字链,9:FLASH不遮盖,10:创意模板,11:视频直播,12:微视频,203:智能创意-三图创意 material_list ItemMaterialVo [] 单品创意素材 └ material_id Number 714616513841 物料id └ video_id Number 398436114008 视频id └ source Number 1 创意来源,1:本地上传,2:BannerMaker,3:CreativeCenter,4:LuBan,5:直播广场,6:活动招商,7:海棠,8:原生创意 └ haitang_id Number 989898 对应的海棠id └ format_type Number 1 格式类型,1:图片,2:抄底文案,3:产品词,4:属性词,5:链接,51:淘积木URL,6:文案,7:长图,8:短文本,9:长文本,10:LOGO,11:视频,12:底图,13:tag,14:智能文案,15:促销词,16:标签词,17:优惠券,18:原价,19:折扣价,20:智能标题候选词,21:宝贝图包括主图长图副图,22:宝贝标题,23:智能图,24:美观图,32:短标题,33:算法产出，仅供审核用图,34:淘宝素材中心图片,35:店铺名称,36:商品SKU图,37:商品详情页图,38:创意图,39:算法加工后的直播间封面图,40:算法加工后的直播间宝贝图,41:算法加工后的直播间宝贝标题文案,42:长图3:4,44:创意样式,45:主搜商品卡片轮播图,46:主搜商品3比4图,47:图标图片,48:二跳短视频,101:用户主标题,102:用户副标题,103:用户标题3,25:长图微视频,26:方图微视频,27:审核通过后原图做成的ppt视频,28:账号头像,29:素材组下非审核素材内容，主要传递数据用,30:鹿班商品图,31:算法剪辑视频,60:创意中心打包的图(只有外审使用),50:视频ID素材,124:自动审核通过,125:仅合理性审核的图片,126:仅合理性审核的文案 └ url String https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg url └ cover_url String https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png 封面url └ template_id Number 2000000000 创意模板ID, └ outer_id Number 225349579 外部实体id,eg:前端创意中心id └ js_in_html String https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html 从海棠获取的地址 └ template_data String { "_creationType": { "selectedOption": "video" }, "_apng": "https://a1.alicdn.com/assets/%E6%B4%BB%E5%8A%A8%E4%BF%83%E9%94%80%E5%80%BE%E5%90%91/%E6%B5%81%E6%98%9F%E9%9B%A8.png", "image": "https://img.alicdn.com/imgextra/i2/2247603103/O1CN01cHB4B71YnDo0G1MBV_!!2247603103-0-alimamacc.jpg" } 从海棠获取的templateData └ clickurl_media_type_list String [] [1] 跳转地址媒体类型,1:PC,2:无线,3:PC和无线 audit AuditVo 审核信息 └ status String W 状态,PW:待送审,W:待审核,P:审核通过,R:审核拒绝,AW:合成中,AP:合成通过,AR:合成失败,T:排查中,PP:部分通过,E:创意过期,A:创意故障 └ audit_status Number 2 创意审核状态,-10:to_promote,-4:tobeadd,-3:feed_handle,-2:reject,-1:handle,0:notchecked,1:passed,-9:qa_reject,-5:uneffect,-7:item_offshelf,-11:business_reject,-12:to_outer_audit,-13:handle_tanx,-14:part_reject,-15:to_rational_audit,-16:part_passed └ effective_time String 2023-05-29 18:21:40 生效时间 └ expire_time String 2999-12-31 23:59:59 创意过期时间 └ audit_reason String 直播已结束，结束后创意自动变为审核拒绝状态审核原因 adzone_audit_result_list AuditVo [] 审核信息 └ status String W 状态,PW:待送审,W:待审核,P:审核通过,R:审核拒绝,AW:合成中,AP:合成通过,AR:合成失败,T:排查中,PP:部分通过,E:创意过期,A:创意故障 └ audit_status Number 2 创意审核状态,-10:to_promote,-4:tobeadd,-3:feed_handle,-2:reject,-1:handle,0:notchecked,1:passed,-9:qa_reject,-5:uneffect,-7:item_offshelf,-11:business_reject,-12:to_outer_audit,-13:handle_tanx,-14:part_reject,-15:to_rational_audit,-16:part_passed └ effective_time String 2023-05-29 18:21:40 生效时间 └ expire_time String 2999-12-31 23:59:59 创意过期时间 └ audit_reason String 直播已结束，结束后创意自动变为审核拒绝状态审核原因 preview_list CreativeAdzonePreviewVo [] 创意预览信息 └ adzone_type Number 1 资源位类型,1:首焦,2:猜你喜欢,3:NewDetail └ adzone_name String 全屏微详情资源包名字 └ adzone_id Number 111287850198 资源包id preview_data_list CreativePreviewResultVo [] 创意预览返回前端展示对象 └ preview_format Number 2 预览创意类型,2:图片,10:创意模板,12:微视频 └ preview_img_url String https://kb-render.chuangyi.taobao.com/template/93214.html?data=%7B%22image%22%3A%22https%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi2%2F2247603103%2FO1CN011YnDptRlLOusjIj_%21%212247603103-0-alimamacc.jpg%22%2C%22video_duration%22%3A6%2C%22buyInfo%22%3A%220%E4%BA%BA%E4%BB%98%E6%AC%BE%22%2C%22price%22%3A110.00%2C%22video%22%3A%22https%3A%2F%2Fcloud.video.taobao.com%2Fplay%2Fu%2F2%2C247%2C603%2C103%2Fp%2F2%2Fe%2F6%2Ft%2F1%2F412128529977.mp4%3FsBizCode%3Dalimama_tuijian.mp4%22%2C%22title%22%3A%22%E4%B8%BB%E5%9B%BE%E8%A7%86%E9%A2%91%E6%B5%8B%E8%AF%95%E8%AF%B7%E4%B8%8D%E8%A6%81%E6%8B%8D%E7%8C%AB%E7%B2%AE%E5%B9%BC%E7%8C%AB%E5%A5%B6%E7%B3%95%E7%8C%AB%E4%B8%BB%E7%B2%AE%22%7D 预览创意图片地址 └ preview_click_url String https://a.m.taobao.com/i678729730773.htm 预览落地页地址 └ preview_size String 342x530 预览创意尺寸 └ preview_scale String 0.5 预览创意尺寸 └ preview_video_path String 342x530 视频地址 └ preview_video_image String 342x530 视频封面 └ creative_size String 513x750 创意尺寸 item_videos ItemVideoVo [] 单品创意视频 └ cover_url String https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png 封面url └ poster String https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg 封面url(海棠） └ item_id Number 708275631127 商品 └ video_url String https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4 视频url └ audit_state Number 1 创意审核状态,-10:to_promote,-4:tobeadd,-3:feed_handle,-2:reject,-1:handle,0:notchecked,1:passed,-9:qa_reject,-5:uneffect,-7:item_offshelf,-11:business_reject,-12:to_outer_audit,-13:handle_tanx,-14:part_reject,-15:to_rational_audit,-16:part_passed └ audit_desc String xxxxx 审核描述 └ video_id Number 415780011227 视频id └ source Number 1 创意来源,1:本地上传,2:BannerMaker,3:CreativeCenter,4:LuBan,5:直播广场,6:活动招商,7:海棠,8:原生创意 └ type Number 1 格式类型,1:图片,2:抄底文案,3:产品词,4:属性词,5:链接,51:淘积木URL,6:文案,7:长图,8:短文本,9:长文本,10:LOGO,11:视频,12:底图,13:tag,14:智能文案,15:促销词,16:标签词,17:优惠券,18:原价,19:折扣价,20:智能标题候选词,21:宝贝图包括主图长图副图,22:宝贝标题,23:智能图,24:美观图,32:短标题,33:算法产出，仅供审核用图,34:淘宝素材中心图片,35:店铺名称,36:商品SKU图,37:商品详情页图,38:创意图,39:算法加工后的直播间封面图,40:算法加工后的直播间宝贝图,41:算法加工后的直播间宝贝标题文案,42:长图3:4,44:创意样式,45:主搜商品卡片轮播图,46:主搜商品3比4图,47:图标图片,48:二跳短视频,101:用户主标题,102:用户副标题,103:用户标题3,25:长图微视频,26:方图微视频,27:审核通过后原图做成的ppt视频,28:账号头像,29:素材组下非审核素材内容，主要传递数据用,30:鹿班商品图,31:算法剪辑视频,60:创意中心打包的图(只有外审使用),50:视频ID素材,124:自动审核通过,125:仅合理性审核的图片,126:仅合理性审核的文案 └ width Number 800 视频宽度 └ height Number 1200 视频高度 └ duration Number 32 视频时长 └ haitang_id Number 989898 对应的海棠id └ online_status Number 1 创意状态,1:ON,-1:ARCHIVE └ start_time String 2023-05-29 18:00:00 创意开始时间，用户设置 └ end_time String 2024-05-28 17:59:00 创意结束时间，用户设置 └ create_time String 2023-05-29 18:21:40 创建时间 └ update_time String 2023-05-29 18:21:40 更新时间 creative_promotion_entity CreativePromotionEntityVo 推广主体 └ promotion_type String item 推广主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,content:内容,short_video:短视频,user_define:自定义; └ sub_promotion_type String item 推广子主体类型,item:商品，item_private_mini:独享橱窗，shop:店铺，you_hao_huo:有好货，picture:图文，short_video:短视频，live_room:直播间，live_spot:看点，tao_blocks:淘积木，user_define_url:自定义url └ promotion_entity_id Number 714616513841 推广主体id material PromotionMaterialInfoVo 主体物料信息 └ material_id Number 714616513841 物料id └ img_url String //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg 图片地址 └ link_url String http://item.taobao.com/item.htm?id=715121254343 跳转链接 └ material_name String yiliantest测试请不要拍22 物料名称 └ title String yiliantest测试请不要拍22 标题 └ extend_data String https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html 扩展数据 material_image_info MaterialImageInfoVo 物料图片信息 └ material_id Number 714616513841 物料id └ image_position Number 0 主副图图片位置，主图0,副图从1开始 └ img_url String https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg 图片链接 └ link_url String http://item.taobao.com/item.htm?id=668800719012 物料链接 └ material_name String 外投宝贝测试，请不要拍物料名称 └ title String 薄荷脑软膏,测试请不要拍推广标题 └ image_path String https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg 一跳地址 └ click_url String https://a.m.taobao.com/i679056995041.htm 二跳地址 └ video_id Number 398436114008 视频id └ video_duration String 10 视频时长 └ video_path String https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4 视频地址 └ video_image_path String https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg 视频封面地址 └ item_id_list Number [] [679056995041] 创意关联宝贝 children CreativeChildrenVo [] 关键词推广素材 material_list ItemMaterialVo [] 素材集合 └ material_id Number 714616513841 物料id └ video_id Number 398436114008 视频id └ source Number 1 创意来源,1:本地上传,2:BannerMaker,3:CreativeCenter,4:LuBan,5:直播广场,6:活动招商,7:海棠,8:原生创意 └ haitang_id Number 989898 对应的海棠id └ format_type Number 1 格式类型,1:图片,2:抄底文案,3:产品词,4:属性词,5:链接,51:淘积木URL,6:文案,7:长图,8:短文本,9:长文本,10:LOGO,11:视频,12:底图,13:tag,14:智能文案,15:促销词,16:标签词,17:优惠券,18:原价,19:折扣价,20:智能标题候选词,21:宝贝图包括主图长图副图,22:宝贝标题,23:智能图,24:美观图,32:短标题,33:算法产出，仅供审核用图,34:淘宝素材中心图片,35:店铺名称,36:商品SKU图,37:商品详情页图,38:创意图,39:算法加工后的直播间封面图,40:算法加工后的直播间宝贝图,41:算法加工后的直播间宝贝标题文案,42:长图3:4,44:创意样式,45:主搜商品卡片轮播图,46:主搜商品3比4图,47:图标图片,48:二跳短视频,101:用户主标题,102:用户副标题,103:用户标题3,25:长图微视频,26:方图微视频,27:审核通过后原图做成的ppt视频,28:账号头像,29:素材组下非审核素材内容，主要传递数据用,30:鹿班商品图,31:算法剪辑视频,60:创意中心打包的图(只有外审使用),50:视频ID素材,124:自动审核通过,125:仅合理性审核的图片,126:仅合理性审核的文案 └ url String https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg url └ cover_url String https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png 封面url └ tab_type String 103 tab类型,101:竖版大图800x1200,102:竖版视频800x1200,103:竖版长图513x750,104:竖版视频512x750,105:竖版模板513x750,113:方图800x800,114:方视频800x800,115:横版大图320x90,116:横版大图240x100,117:横版大图140x120,118:横版大图730x350,119:横版大图846x220,120:横版大图780x210,121:横版大图840x90,122:横版大图180x100,124:横版大图980x200,125:横版大图820x90,126:竖版视频750x1000,127:竖版视频720x960,128:竖版视频1080x1440,129:竖版视频720x1280,130:竖版视频1080x1920 └ tab_type_name String 103 tab类型名称,101:竖版大图800x1200,102:竖版视频800x1200,103:竖版长图513x750,104:竖版视频512x750,105:竖版模板513x750,113:方图800x800,114:方视频800x800,115:横版大图320x90,116:横版大图240x100,117:横版大图140x120,118:横版大图730x350,119:横版大图846x220,120:横版大图780x210,121:横版大图840x90,122:横版大图180x100,124:横版大图980x200,125:横版大图820x90,126:竖版视频750x1000,127:竖版视频720x960,128:竖版视频1080x1440,129:竖版视频720x1280,130:竖版视频1080x1920 └ type_name String 自定义创意创意类型名称,1:自定义创意,1:主副图创意,1:主图视频创意,5:智能创意 └ type String 1 创意类型名称,1:自定义创意,1:主副图创意,1:主图视频创意,5:智能创意 └ main_pic_video String 1 创意是否为主图视频创意，异步创建,1:是,其他不是 └ report_info String 报表数据 └ count Number 1 数量

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpCreativeHorizontalFindpageRequest req = new UniversalbpCreativeHorizontalFindpageRequest();
UniversalbpCreativeHorizontalFindpageRequest.TopServiceContext obj1 = new UniversalbpCreativeHorizontalFindpageRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpCreativeHorizontalFindpageRequest.CreativeQueryVo obj2 = new UniversalbpCreativeHorizontalFindpageRequest.CreativeQueryVo();
obj2.setAdgroupIdList(new Long[] { 68798447504 };
);
obj2.setCampaignIdList(new Long[] { 68792788657 };
);
obj2.setOffset(0L);
obj2.setPageSize(20L);
UniversalbpCreativeHorizontalFindpageRequest.RptQueryVO obj3 = new UniversalbpCreativeHorizontalFindpageRequest.RptQueryVO();
obj3.setFields("charge,adPv,click,ctr,ecpc,cartInshopNum,itemColInshopNum,cvr,alipayInshopNum,alipayInshopAmt");
List<UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVO> list5 = new ArrayList<UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVO>();
UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVO obj6 = new UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVO();
list5.add(obj6);
obj6.setAdzonePkgIdList("");
obj6.setUnifyType("zhai");
obj6.setStartTime("2023-08-25");
obj6.setEndTime("2023-08-25");
obj6.setIsRt(true);
obj3.setConditionList(list5);
obj2.setRptQuery(obj3);
obj2.setCreativeId(68792788612L);
req.setCreativeQueryVO(obj2);
UniversalbpCreativeHorizontalFindpageResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
UniversalbpCreativeHorizontalFindpageRequest req = new UniversalbpCreativeHorizontalFindpageRequest();
UniversalbpCreativeHorizontalFindpageRequest.TopServiceContextDomain obj1 = new UniversalbpCreativeHorizontalFindpageRequest.TopServiceContextDomain();
obj1.BizCode = "xxxxx";
req.TopServiceContext_ = obj1;
UniversalbpCreativeHorizontalFindpageRequest.CreativeQueryVoDomain obj2 = new UniversalbpCreativeHorizontalFindpageRequest.CreativeQueryVoDomain();
obj2.AdgroupIdList = new long[] { 68798447504 };
;
obj2.CampaignIdList = new long[] { 68792788657 };
;
obj2.Offset = 0L;
obj2.PageSize = 20L;
UniversalbpCreativeHorizontalFindpageRequest.RptQueryVODomain obj3 = new UniversalbpCreativeHorizontalFindpageRequest.RptQueryVODomain();
obj3.Fields = "charge,adPv,click,ctr,ecpc,cartInshopNum,itemColInshopNum,cvr,alipayInshopNum,alipayInshopAmt";
List<UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVODomain> list5 = new List<UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVODomain>();
UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVODomain obj6 = new UniversalbpCreativeHorizontalFindpageRequest.RptQueryConditionVODomain();
list5.Add(obj6);
obj6.AdzonePkgIdList = "";
obj6.UnifyType = "zhai";
obj6.StartTime = "2023-08-25";
obj6.EndTime = "2023-08-25";
obj6.IsRt = true;
obj3.ConditionList= list5;
obj2.RptQuery= obj3;
obj2.CreativeId = 68792788612L;
req.CreativeQueryVO_ = obj2;
UniversalbpCreativeHorizontalFindpageResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new UniversalbpCreativeHorizontalFindpageRequest;
$top_service_context = new TopServiceContext;
$top_service_context->biz_code="xxxxx";
$req->setTopServiceContext(json_encode($top_service_context));
$creative_query_v_o = new CreativeQueryVo;
$creative_query_v_o->adgroup_id_list="[68798447504]";
$creative_query_v_o->campaign_id_list="[68792788657]";
$creative_query_v_o->offset="0";
$creative_query_v_o->page_size="20";
$rpt_query = new RptQueryVO;
$rpt_query->fields="charge,adPv,click,ctr,ecpc,cartInshopNum,itemColInshopNum,cvr,alipayInshopNum,alipayInshopAmt";
$condition_list = new RptQueryConditionVO;
$condition_list->adzone_pkg_id_list="[]";
$condition_list->unify_type="zhai";
$condition_list->start_time="2023-08-25";
$condition_list->end_time="2023-08-25";
$condition_list->is_rt="true";
$rpt_query->condition_list = $condition_list;
$creative_query_v_o->rpt_query = $rpt_query;
$creative_query_v_o->creative_id="68792788612";
$req->setCreativeQueryVO(json_encode($creative_query_v_o));
$resp = $c->execute($req, $sessionKey);

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.universalbp.creative.horizontal.findpage' \
-d 'partner_id=apidoc' \
-d 'session=2cc82cd2-aec9-49dc-a86c-4ec2a034efbe' \
-d 'sign=37497DC8A5C417D43AEDF30D83212F5E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+22%3A56%3A22' \
-d 'v=2.0' \
-d 'creative_query_v_o=null' \
-d 'top_service_context=null'

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

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

req.top_service_context="数据结构示例JSON格式"
req.creative_query_v_o="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	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.universalbp.creative.horizontal.findpage");
add_param(pRequest,"top_service_context","数据结构JSON示例");
add_param(pRequest,"creative_query_v_o","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
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.universalbp.creative.horizontal.findpage', {
	'top_service_context':'数据结构JSON示例',
	'creative_query_v_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<universalbp_creative_horizontal_findpage_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <creative_ref_v_o_top_bulk_data>
            <creative_ref_v_o_list>
                <creative_ref_vo>
                    <campaign_id>68796878069</campaign_id>
                    <campaign_name>管家计划_宝贝候选集</campaign_name>
                    <adgroup_id>68793666608</adgroup_id>
                    <adgroup_name>ds460418344</adgroup_name>
                    <creative_id>6843262308</creative_id>
                    <creative_name>sss</creative_name>
                    <creative_type>1</creative_type>
                    <source>1</source>
                    <creative_center_id>225349579</creative_center_id>
                    <format>2</format>
                    <material_list>
                        <item_material_vo>
                            <material_id>714616513841</material_id>
                            <video_id>398436114008</video_id>
                            <source>1</source>
                            <haitang_id>989898</haitang_id>
                            <format_type>1</format_type>
                            <url>https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg</url>
                            <cover_url>https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png</cover_url>
                        </item_material_vo>
                    </material_list>
                    <template_id>2000000000</template_id>
                    <outer_id>225349579</outer_id>
                    <js_in_html>https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html</js_in_html>
                    <template_data>{
          &quot;_creationType&quot;: {
            &quot;selectedOption&quot;: &quot;video&quot;
          },
          &quot;_apng&quot;: &quot;https://a1.alicdn.com/assets/%E6%B4%BB%E5%8A%A8%E4%BF%83%E9%94%80%E5%80%BE%E5%90%91/%E6%B5%81%E6%98%9F%E9%9B%A8.png&quot;,
          &quot;image&quot;: &quot;https://img.alicdn.com/imgextra/i2/2247603103/O1CN01cHB4B71YnDo0G1MBV_!!2247603103-0-alimamacc.jpg&quot;
        }</template_data>
                    <clickurl_media_type_list>
                        <string>[1]</string>
                    </clickurl_media_type_list>
                    <audit>
                        <status>W</status>
                        <audit_status>2</audit_status>
                        <effective_time>2023-05-29 18:21:40</effective_time>
                        <expire_time>2999-12-31 23:59:59</expire_time>
                        <audit_reason>直播已结束，结束后创意自动变为审核拒绝状态</audit_reason>
                    </audit>
                    <adzone_audit_result_list>
                        <audit_vo>
                            <status>W</status>
                            <audit_status>2</audit_status>
                            <effective_time>2023-05-29 18:21:40</effective_time>
                            <expire_time>2999-12-31 23:59:59</expire_time>
                            <audit_reason>直播已结束，结束后创意自动变为审核拒绝状态</audit_reason>
                        </audit_vo>
                    </adzone_audit_result_list>
                    <preview_list>
                        <creative_adzone_preview_vo>
                            <adzone_type>1</adzone_type>
                            <adzone_name>全屏微详情</adzone_name>
                            <adzone_id>111287850198</adzone_id>
                            <preview_data_list>
                                <creative_preview_result_vo>
                                    <preview_format>2</preview_format>
                                    <preview_img_url>https://kb-render.chuangyi.taobao.com/template/93214.html?data=%7B%22image%22%3A%22https%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi2%2F2247603103%2FO1CN011YnDptRlLOusjIj_%21%212247603103-0-alimamacc.jpg%22%2C%22video_duration%22%3A6%2C%22buyInfo%22%3A%220%E4%BA%BA%E4%BB%98%E6%AC%BE%22%2C%22price%22%3A110.00%2C%22video%22%3A%22https%3A%2F%2Fcloud.video.taobao.com%2Fplay%2Fu%2F2%2C247%2C603%2C103%2Fp%2F2%2Fe%2F6%2Ft%2F1%2F412128529977.mp4%3FsBizCode%3Dalimama_tuijian.mp4%22%2C%22title%22%3A%22%E4%B8%BB%E5%9B%BE%E8%A7%86%E9%A2%91%E6%B5%8B%E8%AF%95%E8%AF%B7%E4%B8%8D%E8%A6%81%E6%8B%8D%E7%8C%AB%E7%B2%AE%E5%B9%BC%E7%8C%AB%E5%A5%B6%E7%B3%95%E7%8C%AB%E4%B8%BB%E7%B2%AE%22%7D</preview_img_url>
                                    <preview_click_url>https://a.m.taobao.com/i678729730773.htm</preview_click_url>
                                    <preview_size>342x530</preview_size>
                                    <preview_scale>0.5</preview_scale>
                                    <preview_video_path>342x530</preview_video_path>
                                    <preview_video_image>342x530</preview_video_image>
                                </creative_preview_result_vo>
                            </preview_data_list>
                        </creative_adzone_preview_vo>
                    </preview_list>
                    <creative_size>513x750</creative_size>
                    <item_videos>
                        <item_video_vo>
                            <cover_url>https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png</cover_url>
                            <poster>https://img.alicdn.com/imgextra/i3/2208746800922/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg</poster>
                            <item_id>708275631127</item_id>
                            <video_url>https://cloud.video.taobao.com/play/u/167873659/p/2/e/6/t/1/412089156502.mp4?sBizCode=alimama_tuijian.mp4</video_url>
                            <audit_state>1</audit_state>
                            <audit_desc>xxxxx</audit_desc>
                            <video_id>415780011227</video_id>
                            <source>1</source>
                            <type>1</type>
                            <width>800</width>
                            <height>1200</height>
                            <duration>32</duration>
                            <haitang_id>989898</haitang_id>
                        </item_video_vo>
                    </item_videos>
                    <online_status>1</online_status>
                    <start_time>2023-05-29 18:00:00</start_time>
                    <end_time>2024-05-28 17:59:00</end_time>
                    <create_time>2023-05-29 18:21:40</create_time>
                    <update_time>2023-05-29 18:21:40</update_time>
                    <creative_promotion_entity>
                        <promotion_type>item</promotion_type>
                        <sub_promotion_type>item</sub_promotion_type>
                        <promotion_entity_id>714616513841</promotion_entity_id>
                        <material>
                            <material_id>714616513841</material_id>
                            <img_url>//img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg</img_url>
                            <link_url>http://item.taobao.com/item.htm?id=715121254343</link_url>
                            <material_name>yiliantest测试请不要拍22</material_name>
                            <title>yiliantest测试请不要拍22</title>
                        </material>
                    </creative_promotion_entity>
                    <extend_data>https://kb-render.alicdn.com/html/208565/2023/02/20/9976a3a6-fb588e85-225600921.html</extend_data>
                    <material_image_info>
                        <material_id>714616513841</material_id>
                        <image_position>0</image_position>
                        <img_url>https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg</img_url>
                        <link_url>http://item.taobao.com/item.htm?id=668800719012</link_url>
                        <material_name>外投宝贝测试，请不要拍</material_name>
                    </material_image_info>
                    <title>薄荷脑软膏,测试请不要拍</title>
                    <image_path>https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg</image_path>
                    <click_url>https://a.m.taobao.com/i679056995041.htm</click_url>
                    <video_id>398436114008</video_id>
                    <video_duration>10</video_duration>
                    <video_path>https://a1.alibabausercontent.com/prod/feupload/user/qr/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4</video_path>
                    <video_image_path>https://img.alicdn.com/imgextra/i2/2247603103/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg</video_image_path>
                    <item_id_list>
                        <number>[679056995041]</number>
                    </item_id_list>
                    <children>
                        <creative_children_vo>
                            <material_list>
                                <item_material_vo>
                                    <material_id>714616513841</material_id>
                                    <video_id>398436114008</video_id>
                                    <source>1</source>
                                    <haitang_id>989898</haitang_id>
                                    <format_type>1</format_type>
                                    <url>https://img.alicdn.com/imgextra/i4/2247603103/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg</url>
                                    <cover_url>https://img.alicdn.com/tps/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png</cover_url>
                                </item_material_vo>
                            </material_list>
                        </creative_children_vo>
                    </children>
                    <tab_type>103</tab_type>
                    <tab_type_name>103</tab_type_name>
                    <type_name>自定义创意</type_name>
                    <type>1</type>
                    <main_pic_video>1</main_pic_video>
                </creative_ref_vo>
            </creative_ref_v_o_list>
            <count>1</count>
        </creative_ref_v_o_top_bulk_data>
    </result>
</universalbp_creative_horizontal_findpage_response>

{
    "universalbp_creative_horizontal_findpage_response":{
        "result":{
            "info":{
                "ok":true,
                "message":"参数错误",
                "error_code":"xxxxx"
            },
            "creative_ref_v_o_top_bulk_data":{
                "creative_ref_v_o_list":{
                    "creative_ref_vo":[
                        {
                            "campaign_id":68796878069,
                            "campaign_name":"管家计划_宝贝候选集",
                            "adgroup_id":68793666608,
                            "adgroup_name":"ds460418344",
                            "creative_id":6843262308,
                            "creative_name":"sss",
                            "creative_type":1,
                            "source":1,
                            "creative_center_id":"225349579",
                            "format":2,
                            "material_list":{
                                "item_material_vo":[
                                    {
                                        "material_id":714616513841,
                                        "video_id":398436114008,
                                        "source":1,
                                        "haitang_id":989898,
                                        "format_type":1,
                                        "url":"https:\/\/img.alicdn.com\/imgextra\/i4\/2247603103\/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg",
                                        "cover_url":"https:\/\/img.alicdn.com\/tps\/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png"
                                    }
                                ]
                            },
                            "template_id":2000000000,
                            "outer_id":225349579,
                            "js_in_html":"https:\/\/kb-render.alicdn.com\/html\/208565\/2023\/02\/20\/9976a3a6-fb588e85-225600921.html\n",
                            "template_data":"{\n          \"_creationType\": {\n            \"selectedOption\": \"video\"\n          },\n          \"_apng\": \"https:\/\/a1.alicdn.com\/assets\/%E6%B4%BB%E5%8A%A8%E4%BF%83%E9%94%80%E5%80%BE%E5%90%91\/%E6%B5%81%E6%98%9F%E9%9B%A8.png\",\n          \"image\": \"https:\/\/img.alicdn.com\/imgextra\/i2\/2247603103\/O1CN01cHB4B71YnDo0G1MBV_!!2247603103-0-alimamacc.jpg\"\n        }",
                            "clickurl_media_type_list":{
                                "string":[
                                    "[1]"
                                ]
                            },
                            "audit":{
                                "status":"W",
                                "audit_status":2,
                                "effective_time":"2023-05-29 18:21:40",
                                "expire_time":"2999-12-31 23:59:59",
                                "audit_reason":"直播已结束，结束后创意自动变为审核拒绝状态"
                            },
                            "adzone_audit_result_list":{
                                "audit_vo":[
                                    {
                                        "status":"W",
                                        "audit_status":2,
                                        "effective_time":"2023-05-29 18:21:40",
                                        "expire_time":"2999-12-31 23:59:59",
                                        "audit_reason":"直播已结束，结束后创意自动变为审核拒绝状态"
                                    }
                                ]
                            },
                            "preview_list":{
                                "creative_adzone_preview_vo":[
                                    {
                                        "adzone_type":1,
                                        "adzone_name":"全屏微详情",
                                        "adzone_id":111287850198,
                                        "preview_data_list":{
                                            "creative_preview_result_vo":[
                                                {
                                                    "preview_format":2,
                                                    "preview_img_url":"https:\/\/kb-render.chuangyi.taobao.com\/template\/93214.html?data=%7B%22image%22%3A%22https%3A%2F%2Fimg.alicdn.com%2Fimgextra%2Fi2%2F2247603103%2FO1CN011YnDptRlLOusjIj_%21%212247603103-0-alimamacc.jpg%22%2C%22video_duration%22%3A6%2C%22buyInfo%22%3A%220%E4%BA%BA%E4%BB%98%E6%AC%BE%22%2C%22price%22%3A110.00%2C%22video%22%3A%22https%3A%2F%2Fcloud.video.taobao.com%2Fplay%2Fu%2F2%2C247%2C603%2C103%2Fp%2F2%2Fe%2F6%2Ft%2F1%2F412128529977.mp4%3FsBizCode%3Dalimama_tuijian.mp4%22%2C%22title%22%3A%22%E4%B8%BB%E5%9B%BE%E8%A7%86%E9%A2%91%E6%B5%8B%E8%AF%95%E8%AF%B7%E4%B8%8D%E8%A6%81%E6%8B%8D%E7%8C%AB%E7%B2%AE%E5%B9%BC%E7%8C%AB%E5%A5%B6%E7%B3%95%E7%8C%AB%E4%B8%BB%E7%B2%AE%22%7D",
                                                    "preview_click_url":"https:\/\/a.m.taobao.com\/i678729730773.htm",
                                                    "preview_size":"342x530",
                                                    "preview_scale":"0.5",
                                                    "preview_video_path":"342x530",
                                                    "preview_video_image":"342x530"
                                                }
                                            ]
                                        }
                                    }
                                ]
                            },
                            "creative_size":"513x750",
                            "item_videos":{
                                "item_video_vo":[
                                    {
                                        "cover_url":"https:\/\/img.alicdn.com\/tps\/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png",
                                        "poster":"https:\/\/img.alicdn.com\/imgextra\/i3\/2208746800922\/O1CN01kOmOXg1IgJwyU0HAt_!!2208746800922-0-alimamacc.jpg",
                                        "item_id":708275631127,
                                        "video_url":"https:\/\/cloud.video.taobao.com\/play\/u\/167873659\/p\/2\/e\/6\/t\/1\/412089156502.mp4?sBizCode=alimama_tuijian.mp4",
                                        "audit_state":1,
                                        "audit_desc":"xxxxx",
                                        "video_id":415780011227,
                                        "source":1,
                                        "type":1,
                                        "width":800,
                                        "height":1200,
                                        "duration":32,
                                        "haitang_id":989898
                                    }
                                ]
                            },
                            "online_status":1,
                            "start_time":"2023-05-29 18:00:00",
                            "end_time":"2024-05-28 17:59:00",
                            "create_time":"2023-05-29 18:21:40",
                            "update_time":"2023-05-29 18:21:40",
                            "creative_promotion_entity":{
                                "promotion_type":"item",
                                "sub_promotion_type":"item",
                                "promotion_entity_id":714616513841,
                                "material":{
                                    "material_id":714616513841,
                                    "img_url":"\/\/img.alicdn.com\/bao\/uploaded\/i1\/3838159498\/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg",
                                    "link_url":"http:\/\/item.taobao.com\/item.htm?id=715121254343",
                                    "material_name":"yiliantest测试请不要拍22",
                                    "title":"yiliantest测试请不要拍22"
                                }
                            },
                            "extend_data":"https:\/\/kb-render.alicdn.com\/html\/208565\/2023\/02\/20\/9976a3a6-fb588e85-225600921.html",
                            "material_image_info":{
                                "material_id":714616513841,
                                "image_position":0,
                                "img_url":"https:\/\/img.alicdn.com\/bao\/uploaded\/i1\/3838159498\/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg",
                                "link_url":"http:\/\/item.taobao.com\/item.htm?id=668800719012",
                                "material_name":"外投宝贝测试，请不要拍"
                            },
                            "title":"薄荷脑软膏,测试请不要拍",
                            "image_path":"https:\/\/img.alicdn.com\/imgextra\/i4\/2247603103\/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg",
                            "click_url":"https:\/\/a.m.taobao.com\/i679056995041.htm",
                            "video_id":398436114008,
                            "video_duration":"10",
                            "video_path":"https:\/\/a1.alibabausercontent.com\/prod\/feupload\/user\/qr\/2008b520-b0ee-11ed-a2a7-412df572c89c.mp4_.mp4",
                            "video_image_path":"https:\/\/img.alicdn.com\/imgextra\/i2\/2247603103\/O1CN01torMqR1YnDnyNTsIt_!!2247603103-0-alimamacc.jpg",
                            "item_id_list":{
                                "number":[
                                    [679056995041]
                                ]
                            },
                            "children":{
                                "creative_children_vo":[
                                    {
                                        "material_list":{
                                            "item_material_vo":[
                                                {
                                                    "material_id":714616513841,
                                                    "video_id":398436114008,
                                                    "source":1,
                                                    "haitang_id":989898,
                                                    "format_type":1,
                                                    "url":"https:\/\/img.alicdn.com\/imgextra\/i4\/2247603103\/O1CN011YnDpyANl3b4vZq_!!2247603103-0-alimamacc.jpg",
                                                    "cover_url":"https:\/\/img.alicdn.com\/tps\/TB1z00ULpXXXXXeXXXXXXXXXXXX-184-184.png"
                                                }
                                            ]
                                        }
                                    }
                                ]
                            },
                            "tab_type":"103",
                            "tab_type_name":"103",
                            "type_name":"自定义创意",
                            "type":"1",
                            "main_pic_video":"1"
                        }
                    ]
                },
                "count":1
            }
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

开放平台

直通车API

taobao.universalbp.creative.horizontal.findpage (横向管理创意分页查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ