리뷰 분석 타임라인 조회

매개변수

경로

이름	유형	필수	설명
locationId	string	필수	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

쿼리

이름	유형	필수	설명	기본값
startDate	string	선택	First day of the series (`YYYY-MM-DD`). Omitting it lets the service pick its default window, so pass it whenever the chart's range matters.	—
endDate	string	선택	Last day of the series (`YYYY-MM-DD`).	—
site	string	선택	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

응답

200One entry per day in the requested range. Response key `interactionsChartData`.

Response

{  "data": {    "interactionsChartData": {      "data": [        { "date": "2026-08-01", "interactionCount": 4, "averageRating": 4.5 },        { "date": "2026-08-02", "interactionCount": 0, "averageRating": null },        { "date": "2026-08-03", "interactionCount": 7, "averageRating": 4.285714285714286 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

403The key is valid but not permitted to read this location (`SY90003`).

추세 차트의 기반이 되는 일별 리뷰 시계열을 반환합니다. 여기에는 각 날짜에 받은 리뷰 수와 해당 리뷰의 평균 별점이 포함됩니다. 상호작용 분석 조회(전체 KPI)와 사이트별 리뷰 분석 조회(소스별 분석)의 타임라인 버전입니다.

각 항목에는 3개의 필드가 포함됩니다.

date: YYYY-MM-DD 형식의 달력 날짜입니다.
interactionCount: 해당 날짜에 받은 리뷰 수입니다.
averageRating: 해당 날짜에 받은 리뷰의 평균 별점이며, 리뷰가 없는 날에는 null입니다. 누적 평균이 아닌 일별 평균이므로, 평점이 좋은 매장이라도 리뷰가 적은 날에 별점 1점짜리 리뷰를 1개만 받으면 1.0으로 표시됩니다.

사용 사례: 30일 스파크라인

사업장의 평균 별점 아래에 30일 추세를 그리려면 해당 기간을 포괄하는 startDate와 endDate를 지정하여 이 엔드포인트를 호출하고, interactionCount를 막대로, averageRating을 선으로 표시합니다. 주요 수치는 개요 엔드포인트에서 가져옵니다. 개요의 delta 필드에는 이미 직전의 동일한 길이의 기간과 비교한 결과가 포함되어 있으므로, 2개의 기간을 직접 조회할 필요가 없습니다.

시계열을 소스별로 나누려면 site를 전달합니다. 예를 들어, 평점 하락이 모든 플랫폼에서 발생한 것이 아니라 특정 플랫폼 1곳에서 발생했음을 보여 줄 수 있습니다. 이 값은 사업장의 리뷰 소스 목록 조회의 siteSettings[].name에 표시된 사이트 URL입니다.

위 응답은 예시입니다.