Posteady
Posteady Docs
사용 가이드개발자 가이드API 레퍼런스MCP
API 레퍼런스계정과 워크스페이스

계정 분석 조회

기간을 정해 계정마다 팔로워 변화와 게시물 성과를 확인합니다.

GET
/api/v1/accounts/analytics
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
형식uuid
since?string

기간의 시작 시각이며 이 시각을 포함합니다. 시간대가 있는 ISO 8601 시각을 쓰고, +는 %2B로 URL 인코딩하세요. 기본값은 until의 90일 전입니다.

형식date-time
until?string

기간의 끝 시각이며 이 시각은 포함하지 않습니다. 기본값은 지금입니다. since부터 until까지는 최대 90일입니다.

형식date-time

응답 본문

application/json

application/json

application/json