Listings APIListings API
로그인
GET/api/v4/locations/{locationId}/google-analytics

사업장의 Google 분석 데이터 조회

지정된 날짜 범위에 대한 사업장의 일별 Google Business Profile 상호작용 지표를 반환합니다.

API 키가 필요합니다. 헤더 형식과 키 교체는 인증을 참고하세요.

매개변수

경로

이름유형필수설명
locationIdstring필수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.

쿼리

이름유형필수설명기본값
fromDatestring선택Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.—
toDatestring선택End of the range (YYYY-MM-DD).—

응답

200Daily Google interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the profile is not connected.
Response
{  "data": {    "googleInsights": {      "total": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 412 },        { "startTime": "2025-06-02T00:00:00+00:00", "value": 388 }      ],      "search": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 300 }      ],      "maps": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 112 }      ],      "directionsAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 24 }      ],      "phoneAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 8 }      ],      "websiteAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 41 }      ],      "businessBookings": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodOrders": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodMenuClicks": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ]    }  }}
401Unauthenticated, missing or invalid API key.

사업장의 일별 Google Business Profile 상호작용 데이터를 반환합니다. 각 지표는 시계열 데이터 포인트의 배열이며, 각 포인트에는 startTime(집계된 횟수가 속하는 날짜)과 value가 포함됩니다.

사용 가능한 지표:

  • total: 총 프로필 노출 수로, search와 maps를 합한 값입니다. 아래의 행동 지표는 포함하지 않으므로, 위 예시에서는 412 = 검색 300 + 지도 112입니다.
  • search: Google Search 결과의 노출 수(데스크톱 및 모바일 합산)
  • maps: Google Maps 결과의 노출 수(데스크톱 및 모바일 합산)
  • directionsAction: 사업장으로 가는 길찾기 요청 수
  • phoneAction: 통화 버튼 클릭 수
  • websiteAction: 웹사이트로 이동한 클릭 수
  • businessBookings: 프로필에서 시작한 예약 수
  • businessFoodOrders: 프로필에서 접수한 음식 주문 수
  • businessFoodMenuClicks: 음식 메뉴 링크 클릭 수

경로에서 두 id 형식 모두 사용 가능

1800289와 TG9jYXRpb246MTgwMDI4OQ== 모두 동일한 사업장을 가리킵니다. Base64 Relay id를 사용하는 것이 좋습니다. 모든 조회 엔드포인트가 반환하는 값이며 나머지 API에서도 사용하는 형식이기 때문입니다. 숫자도 아니고 디코딩 가능한 Relay id도 아닌 값을 사용하면 본문이 {"data":{"googleInsights":null},"errors":[...]}인 200이 반환되며, 이를 서버 오류로 오인하기 쉽습니다.

Shell
curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2025-06-01&toDate=2025-06-30' \  -H "Authorization: API $LISTINGSAPI_KEY"

데이터 업데이트의 영향 보고

흔히 쓰는 용도는 변경 전후의 노출 현황 보고서입니다. 사업장에 영업시간이나 카테고리 변경 사항을 전송한 후, 변경 전후 몇 주간의 데이터를 google-analytics로 주기적으로 조회하고 search + maps를 차트로 표시하여 증가분을 보여 줍니다. 요청한 기간에 사업장의 Google 데이터가 없거나 Google 프로필이 연결되지 않은 경우 개별 지표는 빈 배열 대신 null로 반환되므로, 집계 시 null과 []를 동일하게 처리합니다. Facebook 및 Bing 분석 데이터와 결합하여 여러 게시 플랫폼의 현황을 함께 확인합니다.

Request
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/google-analytics' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground