/api/v4/locations/{locationId}/bing-analyticsالحصول على تحليلات Bing لموقع
يُرجع مقاييس مشاهدات الملف التعريفي على Bing Places لموقع، مجمّعة أسبوعيًا، خلال نطاق زمني.
المعلمات
المسار
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| 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.
{ "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. تُحدَّث البيانات كل يوم اثنين لتغطية الأسبوع السابق، لذا سترى بيانات أحدث أسبوع مكتمل.
يمكن استخدام أيٍّ من صيغتَي id في المسار
يقبل bing-analytics معرّف Relay بترميز Base64 (TG9jYXRpb246MTgwMDI4OQ==) أو المعرّف الرقمي الخام (1800289)، ويشير كلاهما إلى الموقع نفسه. يُفضَّل استخدام معرّف Relay، وهو ما تُرجعه نقاط نهاية القراءة. يؤدي إدخال قيمة لا تطابق أيًّا من الصيغتين إلى إرجاع {"data":{"bingInsights":null},"errors":[...]} مع حالة 200 بدلًا من كائن المقاييس.
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 يقدّم قيمة واحدة لكل أسبوع، فإن نقطة النهاية هذه أنسب لعرض خط اتجاه من إسناد النتائج على مستوى اليوم: اجلب بيانات نطاق يمتد لعدة أشهر وارسم views لمعرفة ما إذا كان ظهور إدراج النشاط التجاري على Bing يتزايد أم يتراجع. عندما لا تتوفر للموقع بيانات Bing خلال الفترة المحددة (أو عندما لا يكون ملفه التعريفي على Bing متصلًا)، تظل نقطة النهاية تُرجع 200 مع views كمصفوفة فارغة ([])؛ تعامل مع ذلك على أنه "لا توجد بيانات" وليس خطأً. ادمج هذه البيانات مع تحليلات Google وFacebook للحصول على لوحة تحكم شاملة لعدة منصات نشر.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/bing-analytics' \ -H "Authorization: API $LISTINGSAPI_KEY"