TikTok

연결 요건

TikTok for Business Developers 방식으로 연결한 계정을 사용하세요. 계정 유형이 아닌 연결 방식을 뜻하며 Login Kit 연결은 제외됩니다. capabilities.publishPosts를 확인하고 같은 워크스페이스의 확인된 영상을 사용하세요.

지원 형식

정확히 계정 1개·영상 1개·비어 있지 않은 캡션 1개를 받습니다. posts와 video를 함께 사용하세요. privacyLevel: PUBLIC_TO_EVERYONE만 허용하며 사진 발행·인박스 전송·리포스트는 지원하지 않습니다.

미디어가 필요한 형식은 업로드 가이드의 예약 → PUT → confirm을 먼저 마치세요. 완료 확인된 mediaId만 발행할 수 있습니다.

최소 발행 요청

계정·미디어 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": [
    "A look behind the scenes"
  ],
  "video": {
    "requestId": "33333333-3333-4333-8333-333333333333",
    "mediaId": "22222222-2222-4222-8222-222222222222",
    "privacyLevel": "PUBLIC_TO_EVERYONE"
  }
}'

성공 확인

HTTP 202는 작업 접수입니다. results[0].jobId를 저장하고 아래 요청으로 조회하여 status: published를 확인하세요. 예시 ID는 실제 반환값으로 바꿔야 합니다.

curl --request GET "https://www.posteady.com/api/v1/publish-jobs/44444444-4444-4444-8444-444444444444" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

예약·조회·관련 작업

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

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

제한과 오류

캡션은 UTF-16 코드 유닛 최대 2,200개입니다. 공용 미디어 라이브러리는 MP4·QuickTime 영상을 최대 2 GiB까지 받으며 TikTok도 최종 미디어 검증을 수행합니다. video의 선택 필드는 disableComment·disableDuet·disableStitch·brandOrganicToggle·brandContentToggle입니다. 같은 입력을 재시도할 때 requestId를 유지하세요. 이 API의 발행은 영상만 지원하지만 동기화된 조회 결과에는 영상·사진 게시물이 모두 있을 수 있습니다.

발행 레퍼런스 · 오류 해결