엔드포인트 하나로 모든 네트워크의 지표 조회
FoPost가 연결된 각 계정의 성과 데이터를 수집해 일관된 형식으로 제공해요. 워크스페이스 개요를 가져오거나, 게시물 하나를 자세히 보거나, 계정을 시간 흐름에 따라 추적하고, 사용하는 보고 도구로 보내세요.
curl "https://api.fopost.com/v1/analytics/overview?workspace_id=9b2f6c1e-...&days=30" \
-H "X-API-Key: $API_KEY"
{
"total_accounts": 6,
"total_followers": 42810,
"total_posts": 86,
"total_engagement": 9127,
"total_impressions": 184320,
"total_reach": 121904,
"engagement_rate": 0.0749,
"deltas": { "followers": 2.89, "posts": 12.5 },
"today_stats": { "posts": 3, "follower_change": 41, "engagement": 312 },
"platforms": [{ "platform": "linkedin", "accounts": 2, "followers": 18402 }]
}정규화된 지표
노출수, 참여, 팔로워는 모든 네트워크에서 같은 필드 이름을 사용해요.
세 가지 수준
워크스페이스 개요, 게시물 하나, 또는 계정 하나.
읽기 전용 범위
analytics 범위만 있는 키는 수치만 읽을 수 있어요.
월간 보고서를 호출 한 번으로
overview 엔드포인트는 기간별로 워크스페이스 데이터를 합산해요. 노출수, 참여, 팔로워 변화, 게시한 게시물 수의 합계를 제공하므로 주간 요약이나 클라이언트 보고서를 요청 하나와 템플릿으로 만들 수 있어요.
분석 레퍼런스 읽기
기간 설정
days를 전달하면 최대 365일까지 최근 기간을 조회해요. 변화량은 직전 기간과 비교해요.
계정별 필터
클라이언트가 채널 하나에 대해 물어보면 개요를 계정 하나로 좁히세요.
워크스페이스별
에이전시 키는 클라이언트 워크스페이스별이라 보고서가 서로 섞이지 않아요.
어떤 게시물이 성과를 냈는지 확인
API로 만든 모든 게시물은 id를 유지하고, 그 id로 게시된 각 네트워크의 지표를 조회할 수 있어요. 자체 캠페인 데이터와 결합하거나, 한 달 동안의 게시물 순위를 매겨 무엇을 반복할지 확인하세요.
게시물별 지표 보기curl "https://api.fopost.com/v1/posts/7d3e0a52-.../analytics" \
-H "X-API-Key: $API_KEY"
{
"post_id": "7d3e0a52-...",
"totals": { "impressions": 21050, "reach": 15230, "engagements": 1374, "likes": 501, "comments": 60, "shares": 71, "reposts": 0, "clicks": 721, "saves": 21, "video_views": 0, "follows": 12 },
"platforms": [
{ "platform": "linkedin", "username": "yourbrand", "external_post_id": "urn:li:share:7301...", "permalink": "https://linkedin.com/feed/update/...", "metrics": { "impressions": 12840, "likes": 311, "comments": 42, "shares": 27, "clicks": 508 } },
{ "platform": "twitter", "username": "yourbrand", "external_post_id": "1830...", "permalink": "https://x.com/...", "metrics": { "impressions": 8210, "likes": 190, "comments": 18, "shares": 44, "clicks": 213 } }
],
"last_fetched_at": "2026-09-02T09:00:00Z"
}계정별 분석
게시물 하나에 네트워크별 행 하나씩, 어떤 채널이 성과를 이끌었는지 볼 수 있어요.
클릭과 퍼머링크
링크 클릭수와 게시물 퍼머링크가 수치와 함께 제공돼요.
라벨별 그룹화
먼저 라벨로 게시물을 조회한 다음, 해당 묶음의 지표를 읽으세요.
채널별 성장을 시간 흐름에 따라 추적
account 엔드포인트는 팔로워 수, 도달, 프로필 조회수의 스냅샷 시계열을 반환해요. 자체 차트에 넣거나, 하락 시 알림을 보내거나, 상승하는 그래프를 그 원동력이 된 게시물과 함께 클라이언트에게 보여 주세요.
개발 시작하기curl "https://api.fopost.com/v1/accounts/4a71d80b-.../analytics?limit=7" \
-H "X-API-Key: $API_KEY"
{
"account_id": "4a71d80b-...",
"platform": "linkedin",
"username": "yourbrand",
"history": [
{ "followers": 41651, "following": 210, "total_posts": 412, "reach": 6034, "profile_views": 341, "fetched_at": "2026-08-02T06:00:00Z" },
{ "followers": 41606, "following": 210, "total_posts": 411, "reach": 5120, "profile_views": 288, "fetched_at": "2026-08-01T06:00:00Z" }
]
}스냅샷 시계열
수집할 때마다 팔로워, 도달, 프로필 조회수 데이터 포인트가 하나씩 쌓여요.
나만의 알림 만들기
일정에 따라 폴링하고, 채널 수치가 평소 범위를 벗어나면 알림을 보내세요.
기록은 직접 보관
시계열을 데이터 웨어하우스에 저장하고 원하는 만큼 보관하세요.