Dapatkan analitik Bing untuk suatu lokasi

Parameter

Path

Nama	Tipe	Wajib	Deskripsi
locationId	string	wajib	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.

Query

Nama	Tipe	Wajib	Deskripsi	Default
fromDate	string	opsional	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	opsional	End of the range (YYYY-MM-DD).	—

Respons

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.

Mengembalikan data jumlah tayangan profil Bing Places untuk suatu lokasi. Analitik Bing dikelompokkan per minggu; setiap titik dalam views mewakili jumlah tayangan selama satu minggu yang dimulai pada startTime. Data diperbarui setiap hari Senin untuk minggu sebelumnya, sehingga data yang Anda lihat adalah data dari minggu lengkap terbaru.

Kedua bentuk id dapat digunakan dalam path

bing-analytics menerima id Relay Base64 (TG9jYXRpb246MTgwMDI4OQ==) atau id numerik mentah (1800289), dan keduanya merujuk ke lokasi yang sama. Utamakan id Relay, yang dikembalikan oleh endpoint baca. Jika nilainya bukan salah satu dari kedua bentuk tersebut, endpoint mengembalikan {"data":{"bingInsights":null},"errors":[...]} dengan status 200 alih-alih objek metrik.

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"

Melacak tren visibilitas di Bing

Karena Bing melaporkan satu nilai per minggu, endpoint ini paling sesuai untuk membuat garis tren dibandingkan untuk atribusi pada tingkat harian: ambil data untuk rentang beberapa bulan dan plot views untuk melihat apakah visibilitas profil bisnis di Bing meningkat atau menurun. Jika lokasi tidak memiliki data Bing untuk rentang waktu tersebut (atau profil Bing-nya tidak terhubung), endpoint tetap mengembalikan 200 dengan views berupa array kosong ([]); perlakukan hasil tersebut sebagai "tidak ada data", bukan sebagai kesalahan. Gabungkan dengan analitik Google dan Facebook untuk membuat dasbor lengkap yang mencakup beberapa platform publikasi.