게시물과 지표 조회
동기화된 게시물을 조회하고 플랫폼별 지표를 해석하세요.
게시물 조회
curl --request GET "https://www.posteady.com/api/v1/posts?provider=threads&limit=20&sort=recent" \
--header "Authorization: Bearer $POSTEADY_API_KEY"| 인자 | 의미 |
|---|---|
provider | 플랫폼 필터, 생략 시 지원 플랫폼 전체 |
accountId | 계정 UUID로 필터 |
limit | 1–100, 기본 20 |
sort | 최신순 recent(기본), 조회수 내림차순 top |
응답은 posts·totalMatched·rangeDays를 포함합니다. 범위는 현재 시각부터 최근 90일로 고정되며 날짜 범위·offset·cursor 인자는 없습니다. totalMatched는 limit 적용 전 일치 개수이므로 반환 배열보다 클 수 있습니다.
게시물 ID와 본문
postId는 플랫폼의 원래 ID이며 Posteady DB UUID가 아닙니다. content는 최대 280자의 미리보기입니다. 계정은 accountId·username, 게시 위치와 시각은 permalink·postedAt으로 확인하세요. 원래 ID가 있어도 리포스트를 지원한다는 뜻은 아닙니다.
지표 해석
이 API는 Posteady에 이미 동기화된 데이터를 읽습니다. 호출할 때 플랫폼을 새로 동기화하지 않습니다. metricsUpdatedAt이 제공되면 마지막 갱신 시점을 확인하고 null을 0으로 바꾸지 마세요.
| 플랫폼 | 주요 지표와 차이 |
|---|---|
| Threads, X, LinkedIn | views·likes·replies·reposts·quotes·bookmarks는 숫자. 현재 계약은 누락된 값을 0으로 반환 |
| TikTok | 조회·좋아요·댓글(replies)·공유(shares)는 숫자 또는 null. reposts·quotes·bookmarks는 null |
노출은 views, 도달은 reach, 댓글은 replies, 저장은 bookmarks. 좋아요·댓글은 인사이트와 별도로 있을 수 있음. reposts·quotes는 null | |
| YouTube | views·likes·replies(댓글)는 숫자 또는 null. 공유·리포스트·인용·북마크는 null |
views는 post_media_view, 댓글은 replies, 공유 수는 shares와 reposts 양쪽에 표시. reach·인용·북마크는 null |
TikTok의 metricsUpdatedAt이 null이면 조회·좋아요·댓글·공유도 모두 null입니다. 과거에 누락 지표를 0으로 저장한 기록은 다음 동기화 전까지 유지될 수 있습니다. Facebook의 shares와 reposts는 같은 수치이므로 합산하면 중복 계산입니다.
포함되는 게시물
TikTok은 native ID가 있는 영상·사진을 반환하며 인박스 전송·처리 중·native ID 없는 비공개 기록은 제외합니다. Instagram은 프로페셔널 계정의 동기화된 게시물, YouTube는 native ID가 있는 영상과 SHORTS, Facebook은 삭제되지 않은 페이지 게시물을 조회합니다.