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

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

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

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 Facebook Page interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the Page is not connected.
Response
{  "data": {    "facebookInsights": {      "views": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 120 }      ],      "ctaAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 5 }      ],      "directionsAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 3 }      ],      "phoneAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 2 }      ],      "websiteAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 9 }      ]    }  }}
401Unauthenticated, missing or invalid API key.

사업장의 일별 Facebook 페이지 상호작용 데이터를 반환합니다. 각 지표는 startTime(집계 기준일)과 value를 포함하는 시계열 데이터 포인트의 배열입니다. 사업장의 Facebook 페이지가 연결되어 있어야 합니다.

사용 가능한 지표:

  • views: 총 페이지 조회 수
  • ctaAction: 페이지의 행동 유도 버튼 클릭 수
  • directionsAction: 페이지를 통한 길찾기 요청 수
  • phoneAction: 페이지에서 시작한 통화 수
  • websiteAction: 페이지에서 웹사이트로 이동한 클릭 수

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

다른 분석 엔드포인트와 마찬가지로 facebook-analytics는 Base64 Relay id(TG9jYXRpb246MTgwMDI4OQ==) 또는 원시 숫자 id(1800289)를 받으며, 두 형식 모두 동일한 사업장으로 해석됩니다. 조회 엔드포인트에서 반환하는 Relay id를 우선적으로 사용합니다. 어느 형식에도 해당하지 않는 값을 전달하면 200 상태와 함께 {"data":{"facebookInsights":null},"errors":[...]}를 반환합니다.

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

CTA 버튼으로 발생한 참여 측정

사업장이 페이지에 "지금 예약" 또는 "지금 전화" 행동 유도 버튼을 설정한 경우, ctaAction과 phoneAction을 사용하면 캠페인 기간 동안 해당 버튼이 유도한 클릭 수를 정량적으로 파악할 수 있습니다. 페이지에 해당 기간의 데이터가 없거나 페이지가 연결되어 있지 않으면 모든 지표가 빈 배열이 아닌 null로 반환되므로, 반복 처리 전에 null인지 확인합니다. Google 및 Bing 분석 데이터와 결합하여 여러 게시 플랫폼의 성과를 하나의 화면에서 볼 수 있도록 구성합니다.

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