Bir konum için Bing analizlerini alın

Parametreler

Yol

Ad	Tür	Zorunlu	Açıklama
locationId	string	zorunlu	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.

Sorgu

Ad	Tür	Zorunlu	Açıklama	Varsayılan
fromDate	string	isteğe bağlı	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	isteğe bağlı	End of the range (YYYY-MM-DD).	—

Yanıtlar

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.

Bir konum için Bing Places profil görüntüleme verilerini döndürür. Bing analizleri haftalık olarak gruplandırılır; views içindeki her nokta, startTime tarihinde başlayan bir haftanın görüntüleme sayısını temsil eder. Veriler, önceki haftayı kapsayacak şekilde her Pazartesi yenilenir; dolayısıyla en son tamamlanan haftayı görürsünüz.

Yolda her iki id biçimi de kullanılabilir

bing-analytics, Base64 Relay id (TG9jYXRpb246MTgwMDI4OQ==) veya ham sayısal id (1800289) kabul eder ve her ikisi de aynı konuma karşılık gelir. Okuma endpoint'lerinin döndürdüğü Relay id biçimini tercih edin. Bu iki biçimden hiçbirine uymayan bir değer kullanıldığında, metrik nesnesi yerine 200 durumuyla {"data":{"bingInsights":null},"errors":[...]} döndürülür.

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 görünürlük eğilimlerini izleme

Bing haftada bir değer raporladığından, bu endpoint günlük düzeyde ilişkilendirme yerine bir eğilim çizgisi için daha uygundur: birkaç aylık bir aralığın verilerini alın ve işletme kaydının Bing'deki görünürlüğünün artıp artmadığını veya azalıp azalmadığını görmek için views verilerini grafiğe dökün. Konumun bu zaman aralığı için Bing verisi olmadığında (veya Bing profili bağlı olmadığında), endpoint yine 200 döndürür ve views boş bir dizi ([]) olur; bunu hata olarak değil, "veri yok" olarak değerlendirin. Birden çok yayın platformunu kapsayan eksiksiz bir kontrol paneli için Google ve Facebook analizleriyle birleştirin.