API文档 >>  批量获取指定商户信息

  • API名称: 批量获取指定商户信息 business/get_batch_businesses_by_id
  • 描述:根据多个商户ID批量获取指定商户的详细信息
  • 数据格式:JSON/XML
  • 方法:HTTP GET
  • 等级:普通
  • 是否需要用户授权:
  • 请求URL:http://api.dianping.com/v1/business/get_batch_businesses_by_id

请求参数

  • 必选参数

    名称 类型 说明
    appkey string App Key,应用的唯一标识
    sign string 请求签名,生成方式见《API请求签名生成文档》
    business_ids string 一个或多个商户ID集合,多ID之间以英文逗号分隔,如“4659232,5257123,5185318”,一次传入的ID数量上限为40个,其他参数限制请参考下方注意事项
  • 可选参数

    名称 类型 说明
    out_offset_type int 传出经纬度偏移类型,1:高德坐标系偏移,2:图吧坐标系偏移,如不传入,默认值为1
    platform int 传出链接类型,1:web站链接(适用于网页应用),2:HTML5站链接(适用于移动应用和联网车载应用),如不传入,默认值为1
    format string 返回数据格式,可选值为json或xml,如不传入,默认值为json

返回结果

  • 状态字段

    名称 类型 说明
    status string 本次API访问状态,如果成功返回"OK",并返回结果字段,如果失败返回"ERROR",并返回错误说明
    count int 本次API访问所获取的商户数量(调用此API,返回值恒为1)
  • 结果字段

    名称 类型 说明
    business_id int 商户ID
    name string 商户名
    branch_name string 分店名
    address string 地址
    telephone string 带区号的电话
    city string 所在城市
    regions list 所在区域信息列表,如[徐汇区,徐家汇]
    categories list 所属分类信息列表,如[宁波菜,婚宴酒店]
    latitude float 纬度坐标
    longitude float 经度坐标
    avg_rating float 星级评分,5.0代表五星,4.5代表四星半,依此类推
    rating_img_url string 星级图片链接
    rating_s_img_url string 小尺寸星级图片链接
    product_grade int 产品/食品口味评价,1:一般,2:尚可,3:好,4:很好,5:非常好
    decoration_grade int 环境评价,1:一般,2:尚可,3:好,4:很好,5:非常好
    service_grade int 服务评价,1:一般,2:尚可,3:好,4:很好,5:非常好
    product_score float 产品/食品口味评价单项分,精确到小数点后一位(十分制)
    decoration_score float 环境评价单项分,精确到小数点后一位(十分制)
    service_score float 服务评价单项分,精确到小数点后一位(十分制)
    avg_price int 人均价格,单位:元,若没有人均,返回-1
    review_count int 点评数量
    review_list_url list 点评页面URL链接
    business_url string 商户页面链接
    photo_url string 照片链接,照片最大尺寸700×700
    s_photo_url string 小尺寸照片链接,照片最大尺寸278×200
    photo_count int 照片数量
    photo_list_url list 照片页面URL链接
    has_coupon int 是否有优惠券,0:没有,1:有
    coupon_id int 优惠券ID
    coupon_description string 优惠券标题
    coupon_url string 优惠券页面链接
    has_deal int 是否有团购,0:没有,1:有
    deal_count int 商户当前在线团购数量
    deals list 团购列表
    deals.id string 团购ID
    deals.description string 团购标题
    deals.url string 团购页面链接

注意事项

  • 通过审核前,返回的是测试数据;通过审核后,返回的是正式数据

API测试工具

示例请求

http://api.dianping.com/v1/business/get_batch_businesses_by_id?business_ids=4659232,5257123&appkey=[appkey]&sign=[signature]

示例结果

{
  "status": "OK",
  "count": 1,
  "businesses": [
    {
      "business_id": 6110204,
      "name": "海底捞火锅店",
      "branch_name": "徐家汇店",
      "address": "徐汇区华山路2068号百联徐汇商业广场南5楼",
      "telephone": "021-64188837",
      "city": "上海",
      "regions": [
        "徐汇区",
        "徐家汇"
      ],
      "categories": [
        "火锅"
      ],
      "latitude": 31.196983,
      "longitude": 121.43721,
      "avg_rating": 5.0,
      "rating_img_url": "http://i3.dpfile.com/s/i/app/api/32_5star.png",
      "rating_s_img_url": "http://i1.dpfile.com/s/i/app/api/16_5star.png",
      "product_grade": 5,
      "decoration_grade": 5,
      "service_grade": 5,
      "product_score": 9.0,
      "decoration_score": 9.0,
      "service_score": 9.4,
      "review_count": 2381,
      "review_list_url": "http://dpurl.cn/p/OqQVL46omC",
      "avg_price": 112,
      "business_url": "http://dpurl.cn/p/w0uHHZh+n-",
      "photo_url": "http://i3.dpfile.com/pc/4dc5d4d37bb8fda8aa502740c4a82d96(700x700)/thumb.jpg",
      "s_photo_url": "http://i2.dpfile.com/pc/4dc5d4d37bb8fda8aa502740c4a82d96(278x200)/thumb.jpg",
      "photo_count": 1027,
      "photo_list_url": "http://dpurl.cn/p/osdXYt5+QC",
      "has_coupon": 0,
      "coupon_id": 0,
      "coupon_description": "",
      "coupon_url": "",
      "has_deal": 0,
      "deal_count": 0,
      "deals": [],
      "has_online_reservation": 0,
      "online_reservation_url": ""
    }
  ]
}