alibaba.matrix.tcp.outer.querymarketobjects (淘宝直播选品广场商品查询接口)

淘宝直播选品广场商品查询(仅针对服务商开放)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_query_market_objects_request PageQueryMarketObjectsRequest 必须 市场商品查询参数
  • └ aduser_ids
  • String
  • 可选
  • "12345"
  • 主播id列表
  • └ page_size
  • Number
  • 必须
  • 10
  • 每页条数
  • └ current_page_num
  • Number
  • 必须
  • 1
  • 当前页码
  • └ servant_ids
  • String
  • 可选
  • "123"
  • 团长id
  • └ object_ids
  • String
  • 可选
  • "1234"
  • 商品Id
  • └ type_list
  • String
  • 可选
  • 3,4,5
  • 同时查询多种推广计划(逗号隔开,只支持3,4,5,7)
  • └ price_select
  • String
  • 可选
  • [100, 1500]
  • 商品价格范围
  • └ predict_commission_select
  • String
  • 可选
  • [255, 5555]
  • 佣金金额范围
  • └ commission_rate_select
  • String
  • 可选
  • [100, 1500]
  • 佣金比率范围
  • └ type
  • Number
  • 可选
  • 3
  • 推广计划类型
  • └ title
  • String
  • 可选
  • "牛奶"
  • 商品标题查询
  • └ cate_level1_name_list
  • String []
  • 可选
  • ["美容美妆"]
  • 一级类目名称列表
  • └ sort_rule
  • String
  • 可选
  • "ratio"
  • 排序规则,不填则默认排序,可填ratio,lowPrice,highPrice,commission,sold365d等
  • └ channel_id
  • Number
  • 可选
  • 1234
  • 活动id

响应参数

名称 类型 示例值 描述
result Result 返回结果
  • model
  • PageResultTO
  • 页面返回信息
  • └ total
  • Number
  • 10
  • 查询商品数量
  • list
  • TcpOuterMarketObjectVO []
  • 商品详情
  • └ object_id
  • Number
  • 12345
  • 商品Id
  • └ object_desc
  • String
  • "六神花露水"
  • 商品描述
  • └ object_pic
  • String
  • "url="
  • 商品主图
  • └ aduser_id
  • Number
  • 123456
  • 主播id
  • └ ratio_str
  • String
  • 10%
  • 佣金率
  • └ ratio_type
  • Number
  • 1
  • 佣金计算类型
  • └ live_start_time
  • Number
  • 1713172129
  • 预计开播时间
  • └ auction_price
  • String
  • "123"
  • 商品原始价格
  • └ item_title
  • String
  • "六神花露水"
  • 商品标题
  • └ is_living
  • Number
  • 1
  • 是否开播
  • └ live_id
  • Number
  • 123
  • 直播间id
  • └ promotion_id
  • Number
  • 10001234
  • 推广计划id
  • └ second_category
  • String
  • 饮料
  • 商品二级类目
  • └ partner_ratio
  • String
  • 10%
  • 直播客分成
  • └ platform_fee
  • String
  • 10%
  • 平台服务费
  • └ cate_level1_name
  • String
  • "食品"
  • 商品一级类目
  • └ shop_name
  • String
  • "蒙牛"
  • 店铺名称
  • └ subsidy_info
  • String
  • "JSON"
  • 补贴信息
  • └ msg_info
  • String
  • "System Error"
  • 错误信息
  • └ msg_code
  • String
  • "参数错误"
  • 错误码
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMatrixTcpOuterQuerymarketobjectsRequest req = new AlibabaMatrixTcpOuterQuerymarketobjectsRequest();
AlibabaMatrixTcpOuterQuerymarketobjectsRequest.PageQueryMarketObjectsRequest obj1 = new AlibabaMatrixTcpOuterQuerymarketobjectsRequest.PageQueryMarketObjectsRequest();
obj1.setAduserIds("\"12345\"");
obj1.setPageSize(10L);
obj1.setCurrentPageNum(1L);
obj1.setServantIds("\"123\"");
obj1.setObjectIds("\"1234\"");
obj1.setTypeList("3,4,5");
obj1.setPriceSelect("[100, 1500]");
obj1.setPredictCommissionSelect("[255, 5555]");
obj1.setCommissionRateSelect("[100, 1500]");
obj1.setType(3L);
obj1.setTitle("\"牛奶\"");
obj1.setCateLevel1NameList(""美容美妆"");
obj1.setSortRule("\"ratio\"");
obj1.setChannelId(1234L);
req.setPageQueryMarketObjectsRequest(obj1);
AlibabaMatrixTcpOuterQuerymarketobjectsResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_matrix_tcp_outer_querymarketobjects_response>
    <result>
        <model>
            <total>10</total>
            <list>
                <tcp_outer_market_object_v_o>
                    <object_id>12345</object_id>
                    <object_desc>&quot;六神花露水&quot;</object_desc>
                    <object_pic>&quot;url=&quot;</object_pic>
                    <aduser_id>123456</aduser_id>
                    <ratio_str>10%</ratio_str>
                    <ratio_type>1</ratio_type>
                    <live_start_time>1713172129</live_start_time>
                    <auction_price>&quot;123&quot;</auction_price>
                    <item_title>&quot;六神花露水&quot;</item_title>
                    <is_living>1</is_living>
                    <live_id>123</live_id>
                    <promotion_id>10001234</promotion_id>
                    <second_category>饮料</second_category>
                    <partner_ratio>10%</partner_ratio>
                    <platform_fee>10%</platform_fee>
                    <cate_level1_name>&quot;食品&quot;</cate_level1_name>
                    <shop_name>&quot;蒙牛&quot;</shop_name>
                    <subsidy_info>&quot;JSON&quot;</subsidy_info>
                </tcp_outer_market_object_v_o>
            </list>
        </model>
        <msg_info>&quot;System Error&quot;</msg_info>
        <msg_code>&quot;参数错误&quot;</msg_code>
        <success>true</success>
    </result>
</alibaba_matrix_tcp_outer_querymarketobjects_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案
invalid-sessionkey 权限错误 校验登录态
accesscontrol.limited-by-api-access-count 限流 提高限流

API工具

如何获得此API

FAQ

返回
顶部