获取地点的 Bing 分析数据

参数

路径

名称	类型	必填	描述
locationId	string	必填	Location ID, either the Base64 Relay id (e.g. TG9jYXRpb246MTgwMDI4OQ==) or the raw numeric database id (e.g. 1800289). Both forms resolve to the same location.

查询

名称	类型	必填	描述	默认值
fromDate	string	可选	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	可选	End of the range (YYYY-MM-DD).	—

响应

200Weekly Bing view metrics. `views` is a time-series array; it is empty when no data exists for the range or the Bing profile is not connected.

Response

{  "data": {    "bingInsights": {      "views": [        { "startTime": "2025-06-02T00:00:00+00:00", "value": 73 },        { "startTime": "2025-06-09T00:00:00+00:00", "value": 58 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

返回某个地点的 Bing Places 商家资料浏览量数据。Bing 分析数据按周分组，views 中的每个数据点表示从 startTime 开始的 1 周内的浏览量。数据每周一更新，涵盖前一周的数据，因此您看到的是最近一个完整周的数据。

路径中可使用任一种 id 格式

bing-analytics 接受 Base64 Relay id（TG9jYXRpb246MTgwMDI4OQ==）或原始数字 id（1800289），两者均指向同一个地点。建议优先使用 Relay id，因为读取端点返回的就是这种 id。如果值不属于这两种格式中的任何一种，端点将返回 {"data":{"bingInsights":null},"errors":[...]}，状态为 200，而非指标对象。

Shell

curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/bing-analytics?fromDate=2025-01-01&toDate=2025-12-31' \  -H "Authorization: API $LISTINGSAPI_KEY"

跟踪 Bing 曝光度趋势

由于 Bing 每周报告 1 个值，此端点最适合用于绘制趋势线，而非按日归因：获取跨越多个月的数据，并绘制 views，即可查看商家信息在 Bing 上的曝光度是在上升还是下降。当地点在该时间范围内没有 Bing 数据（或其 Bing 商家资料尚未连接）时，端点仍会返回 200，其中 views 为空数组（[]），请将其视为“无数据”，而非错误。结合 Google 和 Facebook 分析数据，即可构建完整的多发布平台控制台。