사업장의 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를 우선 사용합니다. 두 형식 중 어느 것에도 해당하지 않는 값을 사용하면 지표 객체 대신 {"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 분석 데이터와 결합하여 여러 게시 플랫폼을 포괄하는 대시보드를 구성합니다.