연결 요건

capabilities.publishPosts: true인 X 계정을 선택하세요. 긴 글을 작성하기 전에 응답의 isPremium을 확인하세요.

지원 형식

텍스트 게시물과 1–25개 글의 체인을 지원하며 텍스트 계정 최대 5개에 함께 요청할 수 있습니다. X 공개 발행 입력에는 미디어 첨부가 없습니다.

최소 발행 요청

계정·미디어 UUID는 합성 예시이므로 실제 값으로 바꾸세요. API 키는 POSTEADY_API_KEY 환경 변수로 설정합니다.

curl --request POST "https://www.posteady.com/api/v1/posts" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "accountIds": [
    "11111111-1111-4111-8111-111111111111"
  ],
  "posts": [
    "Hello from Posteady!"
  ]
}'

스레드 체인

{
  "accountIds": [
    "11111111-1111-4111-8111-111111111111"
  ],
  "posts": [
    "Here is our announcement.",
    "And here is the next part."
  ]
}

성공 확인

HTTP 200 응답의 계정별 success·postIds와 summary.failed를 확인하세요. 일부 계정이나 체인 뒷부분이 실패할 수 있으므로 HTTP 코드만으로 전체 성공을 판단하지 마세요.

예약·조회·관련 작업

예약은 같은 플랫폼 입력에 미래 scheduledAt과 선택 timezone을 추가하여 /scheduled-posts로 보내세요. 비동기 플랫폼은 UUID requestId를 새 작업마다 생성하고 재시도 때 유지합니다.

예약과 취소 · 게시물·지표 조회 · 재시도 · MCP 도구

일반 X 계정은 가중 글자 수 280개까지 지원합니다. Premium의 단일 글 또는 체인 첫 글은 25,000개까지이며 두 번째 이후 답글은 Premium도 280개로 제한됩니다. URL·이모지는 X의 글자 수 계산 규칙을 적용하므로 단순 문자열 길이와 다를 수 있습니다. 여러 계정에 함께 발행해도 각 계정의 한도가 적용됩니다. 리포스트는 지원하지만 X 리포스트는 이후 GET /posts 지표에 나타나지 않습니다.

발행 레퍼런스 · 오류 해결

X