API 레퍼런스계정과 워크스페이스
계정 분석 조회
기간을 정해 계정마다 팔로워 변화와 게시물 성과를 확인합니다.
curl -X GET "https://example.com/api/v1/accounts/analytics?provider=instagram&accountId=11111111-1111-4111-8111-111111111111&since=2026-10-01T00%3A00%3A00Z&until=2026-11-01T00%3A00%3A00Z"{ "since": "2026-10-01T00:00:00.000Z", "until": "2026-11-01T00:00:00.000Z", "rangeDays": 31, "previousSince": "2026-08-31T00:00:00.000Z", "accounts": [ { "accountId": "11111111-1111-4111-8111-111111111111", "provider": "threads", "username": "your_brand", "displayName": "Your brand", "followers": { "current": 1250, "atSince": 1100, "atUntil": 1240, "change": 140 }, "postCount": 18, "reactions": 420, "comments": 64, "engagementRate": 3.85, "previous": { "postCount": 15, "reactions": 350, "comments": 51, "engagementRate": 3.4 } }, { "accountId": "99999999-9999-4999-8999-999999999999", "provider": "youtube", "username": "your_channel", "displayName": "Your channel", "followers": { "current": 820, "atSince": null, "atUntil": null, "change": null }, "postCount": 4, "reactions": 96, "comments": 12, "engagementRate": 2.1, "previous": { "postCount": 3, "reactions": 70, "comments": 9, "engagementRate": 1.95 } } ]}API 키의 워크스페이스에서 지원되는 계정마다 기간 동안의 팔로워 변화와 게시물 성과를 반환합니다. 지표 정의는 Posteady 분석 화면과 같습니다. 기본으로 최근 90일을 조회하며, since와 until로 최대 90일의 다른 기간을 조회할 수 있습니다. previous에는 since에서 끝나는 같은 길이의 직전 기간에 대한 같은 지표가 담깁니다. 게시물 지표는 기간 안에 발행된 게시물로 계산하며 비공개 게시물(TikTok SELF_ONLY, YouTube 비공개·일부 공개 동영상)은 뺍니다. followers.atSince와 followers.atUntil은 UTC 날짜 기준 일별 팔로워 스냅샷에서 읽습니다. 스냅샷은 Threads, X, Instagram, LinkedIn에만 있어 다른 플랫폼은 이 값이 null입니다. 이 요청은 동기화된 데이터를 읽으며 플랫폼을 새로 고치지 않습니다. 다만 Facebook 페이지의 현재 팔로워 수는 Facebook에서 읽습니다.
인증
apiKey 인증Bearer <token>
위치: header
쿼리 매개변수
provider?string
허용값
- "threads"
- "x"
- "linkedin"
- "tiktok"
- "instagram"
- "youtube"
- "facebook"
accountId?string
형식
uuidsince?string
기간의 시작 시각이며 이 시각을 포함합니다. 시간대가 있는 ISO 8601 시각을 쓰고, +는 %2B로 URL 인코딩하세요. 기본값은 until의 90일 전입니다.
형식
date-timeuntil?string
기간의 끝 시각이며 이 시각은 포함하지 않습니다. 기본값은 지금입니다. since부터 until까지는 최대 90일입니다.
형식
date-time응답 본문
application/json
application/json
application/json