拠点の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を優先して使用してください。どちらにも該当しない値を指定すると、指標オブジェクトの代わりに、ステータス200で{"data":{"bingInsights":null},"errors":[...]}が返されます。

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のアナリティクスと組み合わせることで、複数の掲載先を網羅するダッシュボードを構築できます。