API 레퍼런스게시물
게시물 조회
발행된 게시물과 플랫폼별로 제공되는 성과 지표를 조회합니다.
curl -X GET "https://example.com/api/v1/posts?provider=threads&accountId=11111111-1111-4111-8111-111111111111&limit=20&sort=recent"{ "posts": [ { "postId": "18000000000000001", "platform": "threads", "accountId": "11111111-1111-4111-8111-111111111111", "username": "your_brand", "content": "Hello from the Posteady API!", "permalink": "https://www.threads.net/@your_brand/post/example", "postedAt": "2026-09-07T12:00:00Z", "metrics": { "views": 240, "likes": 12, "replies": 2, "reposts": 1, "quotes": 0, "bookmarks": 0 } } ], "totalMatched": 1, "rangeDays": 90}Threads, X, LinkedIn, TikTok, Instagram, YouTube, Facebook 게시물을 조회합니다. TikTok은 TikTok for Business Developers로 연결한 계정만 지원합니다. 이는 계정 유형이 아닌 연결 방식이며 Login Kit 연결은 제외됩니다. TikTok은 동기화된 데이터 중 플랫폼 게시물 ID가 있는 동영상·사진을 반환합니다. 인박스 전송, 처리 중 기록, 플랫폼 ID가 없는 비공개 기록은 제외됩니다. 지표 동기화 시각은 metricsUpdatedAt으로 확인하세요. TikTok 공개 동영상 발행·예약은 지원하며 사진 발행·리포스트는 지원하지 않습니다. Instagram도 동기화된 프로페셔널 계정 데이터를 사용하며 실시간 갱신을 실행하지 않습니다. YouTube는 동기화된 채널 동영상 중 플랫폼 동영상 ID가 있는 항목을 반환하며 title과 mediaType(VIDEO 또는 SHORTS)을 포함합니다. 지표 갱신 시각은 metricsUpdatedAt으로 확인하세요. Facebook은 동기화된 페이지 게시물 중 삭제되지 않은 항목을 반환하며 mediaType을 포함합니다. 이 요청은 실시간 Graph 갱신을 실행하지 않습니다.
인증
apiKey 인증Bearer <token>
위치: header
쿼리 매개변수
provider?string
허용값
- "threads"
- "x"
- "linkedin"
- "tiktok"
- "instagram"
- "youtube"
- "facebook"
accountId?string
형식
uuidlimit?integer
범위
1 <= value <= 100sort?string
허용값
- "recent"
- "top"
응답 본문
application/json