Posteady
Posteady Docs
사용 가이드개발자 가이드API 레퍼런스MCP

게시물 조회

발행된 게시물과 플랫폼별로 제공되는 성과 지표를 조회합니다.

GET
/api/v1/posts
curl -X GET "https://example.com/api/v1/posts?provider=threads&accountId=11111111-1111-4111-8111-111111111111&limit=20&sort=recent&since=2026-10-01T00%3A00%3A00Z&until=2026-11-01T00%3A00%3A00Z&offset=0"

{  "posts": [    {      "postId": "18000000000000001",      "platform": "threads",      "type": "post",      "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,  "hasMore": false,  "since": "2026-06-10T00:00:00.000Z",  "until": "2026-09-08T00:00:00.000Z",  "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 갱신을 실행하지 않습니다. Threads, X, LinkedIn의 리포스트는 type이 repost입니다. 리포스트의 지표는 null이며, 원 글 작성자와 링크를 알면 repostOf에 담습니다. 기본으로 최근 90일을 조회합니다. since와 until로 최대 90일의 다른 기간을 조회할 수 있습니다. hasMore가 true이면 offset으로 다음 페이지를 요청하세요. 새 게시물 때문에 페이지가 밀리지 않도록 첫 응답의 until을 모든 페이지 요청에 함께 보내세요.

인증

apiKey
인증Bearer <token>

위치: header

쿼리 매개변수

provider?string

허용값

  • "threads"
  • "x"
  • "linkedin"
  • "tiktok"
  • "instagram"
  • "youtube"
  • "facebook"
accountId?string
형식uuid
limit?integer
범위1 <= value <= 100
sort?string

허용값

  • "recent"
  • "top"
since?string

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

형식date-time
until?string

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

형식date-time
offset?integer

건너뛸 게시물 수입니다. 다음 페이지는 이전 offset에 반환된 게시물 수를 더해 요청하세요. since, until, sort와 필터는 그대로 두세요.

범위0 <= value <= 9900
기본값0

응답 본문

application/json

application/json

카카오톡 문의하기