개발자
읽기 API
화면과 같은 숫자를 JSON 으로 받아요. 설정 → 공유와 API 에서 키를 만들면 바로 쓸 수 있어요. 읽기만 되고, 아무것도 바꿀 수 없어요.
AI 도구에 연결할 계정 토큰은 MCP 연결을 따라 만들어요. 이 REST API는 사이트 키(adp_)를 그대로 써요.
부르는 법
curl -H "Authorization: Bearer adp_…" \ "https://app.finallydata.com/api/v1/stats?period=30d&channel=meta"
쿼리
| 이름 | 값 |
|---|---|
period | today, yesterday, 7d, 30d, month, lastmonth, 90d, 12m(유료). 기간을 직접 정하려면 period=custom&from=2026-10-01&to=2026-10-15 |
| 필터 | 화면과 같은 이름: channel, referrer, campaign, country, region, city, device, browser, os, host, visitor, entry, page, goal |
| 분류 탭 | src(channel, referrer, campaign), geo(country, region, city), tech(device, browser, os, visitor) |
realtime=1 | 실시간(최근 5분 방문자, 살 것 같은 손님)을 같이 |
받는 것
사이트 주소, 플랜, 화폐와 함께 대시보드의 숫자를 그대로 받아요: 지표 칸(kpis, 앞 기간 previous), 날짜별 흐름(series), 유입, 페이지, 지역, 기기 표, 구매 퍼널(funnel, 4주 비교, 들어온 페이지별), 전환 이벤트. 내가 만든 퍼널은 이 응답에서 비어 있어요(customFunnels, customFunnelWeeks). 만든 퍼널의 숫자는 MCP의 get_funnels로 받아요. 방문이 많은 사이트는 화면처럼 계산한 숫자를 최대 10분 나눠 쓰고, 새 주문이나 취소가 생기면 다시 계산해요.
제한과 오류
| 상태 | 뜻 |
|---|---|
| 401 | 키가 없거나, 틀렸거나, 꺼졌어요 |
| 402 | 화면이 잠긴 계정이에요 (체험 끝, 이번 달 이벤트 한도 넘음). 화면과 같은 기준이에요 |
| 429 | 키마다 1분에 20번까지예요. 잠시 뒤 다시 불러 주세요 |
| 503 | 같은 숫자를 다른 요청이 계산하고 있어요. Retry-After(초)만큼 기다렸다 다시 불러 주세요 |
“새 키로 바꾸기”를 누르면 옛 키는 바로 안 돼요. 키가 새어 나갔다면 바꾸거나 꺼 주세요.