가이드플랫폼
Threads
Threads 공개 API의 연결 요건·발행 예제·제한.
연결 요건
GET /accounts에서 capabilities.publishPosts: true인 Threads 계정을 선택하세요. 계정은 API 키의 워크스페이스에 속해야 합니다.
지원 형식
텍스트 게시물과 1–25개 글의 스레드 체인을 지원합니다. 요청 하나에 텍스트 지원 계정 1–5개를 지정할 수 있습니다. 공개 API는 Threads 이미지·영상 첨부를 받지 않습니다.
최소 발행 요청
계정·미디어 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 도구
제한과 오류
글마다 유니코드 문자 최대 500개이며 각 항목은 비어 있으면 안 됩니다. 여러 항목은 답글 체인으로 발행되며 앞 글이 발행된 뒤 뒷 글이 실패할 수 있습니다. 재시도 전에 postIds를 확인하세요. 리포스트와 동기화된 게시물 지표 조회도 지원합니다.