淘宝开放平台

登录
文档中心 > API类目 > 本地生活联盟平台-饿了么单店推广API

本地生活联盟平台-饿了么单店推广API

alibaba.alsc.union.eleme.storepromotion.reviewbwc.query (本地联盟饿了么评价有礼店铺列表)

本地联盟饿了么评价有礼店铺列表（滚动列表，相同session_id请求随请求次数自动翻页）

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 20 每页数量（1~20，默认20）
session_id String 可选 8497813e6deb4bddac841aca76e3bf8a 会话ID（分页场景首次请求结果返回，后续请求必须携带，服务根据同一个session_id的请求次数自动叠加翻页返回数据，直至分页结束，返回空）
pid String 必须 alsc_xxx_xxx_xxx 渠道PID
longitude String 必须 113.562976 经度
latitude String 必须 22.123043 纬度
sort_type String 可选 normal 排序类型，默认normal，排序规则包括:{"normal":"佣金倒序","distance_asc":"距离由近到远","commission_desc":"佣金倒序","month_sales_desc":"月销量从高到低","commission_rate_desc":"佣金比例倒序", "activity_reward_desc":"返现金额倒序"}
min_commission_rate String 可选 0.01 店铺佣金比例下限，代表筛选店铺全店佣金大于等于0.01的店铺
sid String 可选 1111 三方扩展id
filter_first_categories String 可选 xxx,xxx 以一级类目进行类目限定，以,或者|进行类目分隔
filter_one_point_five_categories String 可选 3131|xxx|xxx 1.5级类目查询，以"|"分隔
filter_city_id String 可选 310100 城市ID（经纬度范围覆盖多个城市时，精准召回）
search_content String 可选 汉堡王 搜索内容（店铺名）
exclude_link Boolean 可选 true
  • 默认值：true
    		•  false-返回链接，true-不返回链接；8.1号及以后该属性移除，默认不返回链接

    响应参数

    名称 类型 示例值 描述
    data PageModel {} 分页数据
    • └ session_id
    • String
    • 8497813e6deb4bddac841aca76e3bf8a
    • 会话ID（下次请求作为请求参数，用于标记分页会话自动翻页）
    • records
    • ReviewBwcStorePromotionDto []
    • []
    • 分页记录（记录空时表示当前sessionId对应分页记录已全部返回，分页结束）
    • └ shop_id
    • String
    • DAD123E1ADDA
    • 门店ID（加密）
    • └ shop_name
    • String
    • 淘客连锁店铺2(分店名)
    • 门店名称
    • └ shop_picture
    • String
    • https://xxx
    • 门店主图
    • └ indistinct_monthly_sales
    • String
    • 400+
    • 月销量（模糊）
    • └ category_1_id
    • String
    • 260
    • 一级类目ID
    • └ category_1_name
    • String
    • 全球美食
    • 一级类目名称
    • └ delivery_distance
    • Number
    • 105
    • 配送距离（米）
    • └ delivery_time
    • Number
    • 34
    • 配送时间（分）
    • └ delivery_price_cent
    • Number
    • 400
    • 起送价（分）
    • └ service_rating
    • String
    • 4.6
    • 服务评级
    • link
    • PromotionItem
    • 推广链接，8.1号及以后该属性移除，默认不返回链接
    • └ wx_appid
    • String
    • wxxxxxxxx
    • 小程序appId
    • └ wx_path
    • String
    • xsxxxxxx
    • 微信小程序path链接
    • activities
    • ReviewBwcActivity []
    • 活动
    • └ activity_id
    • String
    • 131
    • 活动ID
    • └ start_time
    • Number
    • 1639122622
    • 开始时间（秒）
    • └ end_time
    • Number
    • 1639122622
    • 结束时间（秒）
    • └ daily_stock
    • Number
    • 123
    • 活动的日库存
    • └ daily_remain_stock
    • Number
    • 12
    • 活动日剩余库存
    • └ reward_cent
    • String
    • 100
    • 返现金额（分）
    • └ reward_threshold_cent
    • String
    • 1000
    • 返现门槛（分）
    • └ commission_rate
    • String
    • 0.2
    • 佣金比例
    • └ commission
    • String
    • 1345
    • 预估佣金（分）
    biz_error_code String 0 错误码
    biz_error_message String xxx不正确 错误消息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAlscUnionElemeStorepromotionReviewbwcQueryRequest req = new AlibabaAlscUnionElemeStorepromotionReviewbwcQueryRequest();
    req.setPageSize(20L);
    req.setSessionId("8497813e6deb4bddac841aca76e3bf8a");
    req.setPid("alsc_xxx_xxx_xxx");
    req.setLongitude("113.562976");
    req.setLatitude("22.123043");
    req.setSortType("normal");
    req.setMinCommissionRate("0.01");
    req.setSid("1111");
    req.setFilterFirstCategories("xxx,xxx");
    req.setFilterOnePointFiveCategories("3131|xxx|xxx");
    req.setFilterCityId("310100");
    req.setSearchContent("汉堡王");
    req.setExcludeLink(true);
    AlibabaAlscUnionElemeStorepromotionReviewbwcQueryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    <alibaba_alsc_union_eleme_storepromotion_reviewbwc_query_response>
        <data>
            <session_id>8497813e6deb4bddac841aca76e3bf8a</session_id>
            <records>
                <review_bwc_store_promotion_dto>
                    <shop_id>DAD123E1ADDA</shop_id>
                    <shop_name>淘客连锁店铺2(分店名)</shop_name>
                    <shop_picture>https://xxx</shop_picture>
                    <indistinct_monthly_sales>400+</indistinct_monthly_sales>
                    <category_1_id>260</category_1_id>
                    <category_1_name>全球美食</category_1_name>
                    <delivery_distance>105</delivery_distance>
                    <delivery_time>34</delivery_time>
                    <delivery_price_cent>400</delivery_price_cent>
                    <service_rating>4.6</service_rating>
                    <link>
                        <wx_appid>wxxxxxxxx</wx_appid>
                        <wx_path>xsxxxxxx</wx_path>
                    </link>
                    <activities>
                        <review_bwc_activity>
                            <activity_id>131</activity_id>
                            <start_time>1639122622</start_time>
                            <end_time>1639122622</end_time>
                            <daily_stock>123</daily_stock>
                            <daily_remain_stock>12</daily_remain_stock>
                            <reward_cent>100</reward_cent>
                            <reward_threshold_cent>1000</reward_threshold_cent>
                            <commission_rate>0.2</commission_rate>
                            <commission>1345</commission>
                        </review_bwc_activity>
                    </activities>
                </review_bwc_store_promotion_dto>
            </records>
        </data>
        <biz_error_code>0</biz_error_code>
        <biz_error_message>xxx不正确</biz_error_message>
    </alibaba_alsc_union_eleme_storepromotion_reviewbwc_query_response>

    异常示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

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

    如何获得此API

    FAQ

    我要提问
    返回
    顶部