Pluggzy문서

TikTok

게시물동영상사진 캐러셀예약인사이트
게시물동영상사진 캐러셀예약인사이트

어떤 AI 앱에서든 TikTok 계정에 동영상과 사진 캐러셀을 올릴 수 있어요. 바로 올리거나 원하는 시간에 예약하세요. TikTok은 최종 캡션과 미디어를 직접 확인해야 게시할 수 있어서, AI 어시스턴트가 올리기 전에 항상 게시물을 먼저 보여 줘요.

TikTok 연결하기
연결 방법
브라우저에서 TikTok 로그인
도구
공용 게시 도구 6개
받은 메시지
TikTok에서는 지원 안 함
하루 10게시물 (바로 게시 또는 예약)
2–5초동작 사이 무작위 간격
2,200캡션 글자 수
1 또는 35동영상 1개 또는 이미지 최대 35장

한도

동작일일분당최소 간격속도 조절도구
읽기게시 옵션과 계정 목록3,00030——post_optionsget_insights
게시물10230초2–5초create_post
예약 게시물목록 보기와 취소————list_scheduled_postscancel_scheduled_post
읽기3,000/일
게시 옵션과 계정 목록
분당 30 · 속도 조절 없음
post_optionsget_insights
게시물10/일
분당 2 · 최소 간격 30초 · 2–5초 간격
create_post
예약 게시물—
목록 보기와 취소
list_scheduled_postscancel_scheduled_post
  • 연결된 TikTok 계정 1개 기준이에요. 이 계정을 쓰는 모든 AI 앱과 API 키가 한도를 함께 써요.
  • 일일 한도는 00:00 UTC에, 주간 한도는 월요일 00:00 UTC에 초기화돼요.
  • 예약 게시물 목록 보기와 취소는 TikTok 호출 없이 Pluggzy 안에서 처리해요.

게시 규칙

TikTok에서 허용하는 형식이에요. 보내기 전에 미리 확인하니, 잘못된 게시물로 손해 볼 일이 없어요.

캡션필수text에 최대 2,200자.
미디어필수필수: 이미지 최대 35장(image_urls) 또는 동영상 1개(video_url), 둘 중 하나만 올릴 수 있어요. 기기에 있는 파일은 먼저 upload_media로 업로드하세요.
privacy_level필수Who can watch; one of the levels post_options lists for the accountPUBLIC_TO_EVERYONEMUTUAL_FOLLOW_FRIENDSFOLLOWER_OF_CREATORSELF_ONLY
allow_comment필수Allow comments
allow_duetAllow duets
allow_stitchAllow stitches
user_confirmed필수True only once the user has seen the final caption and media and agreed to publish them (TikTok's legal requirement)

안전 한도

TikTok 계정을 안전하게 지켜 주는 장치예요. 이 계정을 쓰는 모든 AI 앱과 API 키에 적용되고, 끌 수 없어요.

속도2–5초
TikTok 동작 사이에 무작위 간격을 둬요. 이 계정의 모든 앱과 키에 공통으로 적용돼요.
중복 게시 방지10분
같은 계정에 10분 안에 같은 게시물을 올리면, 두 번 게시하지 않고 첫 번째 응답을 그대로 돌려줘요.
제한 걸리면 쿨다운5분
요청 제한 응답을 받으면 계정이 최소 5분 쉬어요. TikTok 쪽에서 직접 대기를 요청하면 30분이에요. 그사이 들어온 호출에는 남은 시간을 알려 줘요.
예약 가능 기간1년
publish_at은 최소 1분 뒤부터 최대 1년 뒤까지 정할 수 있어요. 링크는 그때까지 유효해야 하고, 업로드한 파일은 게시물과 함께 보관돼요.
TikTok 자체 게시 중지미리 확인
TikTok은 일정 기간 계정의 게시를 막을 수 있어요. 시도하기 전에 post_options가 알려 줘요(can_post_more).
동의 기록필수
모든 TikTok 게시와 예약에 user_confirmed: true가 필요해요. 없으면 TikTok에 닿기 전에 게시가 거절돼요.

한도에 도달하면

몰래 대기열에 넣거나 재시도하지 않아요. 도구가 오류로 응답하면, AI 앱이 읽고 설명한 뒤 알맞은 때에 다시 시도해요.

invalid_post게시물이 TikTok 규칙에 어긋나요. 메시지에 어떤 규칙인지 나와 있어요.
gap직전 동작과 간격이 너무 짧아요. retry_after_seconds만큼 기다렸다가 다시 시도하세요.
limit일일 또는 주간 한도를 다 썼어요. 언제 초기화되는지 알려 줘요.
cooldownTikTok에서 제한을 걸어 계정이 쉬는 중이에요.
permission이 앱에는 해당 권한이 없어요. 다시 연결해서 권한을 허용하세요.
거절 예시
isError
{
  "error": "TikTok actions are spaced 2–5 s apart, at random, to look human. Wait 2s.",
  "code": "gap",
  "retry_after_seconds": 2
}

분석

TikTok에서 get_insights로 읽는 수치예요. 평소 말투로 물어보면 AI 앱이 리포트를 골라요.

개요overview 기본최근 days일 동안의 조회수, 도달, 참여, 팔로워를 보여 줘요. 플랫폼 고유 지표와 모든 플랫폼에 공통인 헤드라인 수치가 함께 나와요. account를 지정하지 않으면 모든 분석 계정을 나란히 보여 줘요.
팔로워followers 팔로워 수의 일별 추이(YouTube는 구독자)와 늘어난 팔로워, 줄어든 팔로워를 보여 줘요.
오디언스audience 국가별·도시별 팔로워, 그리고 플랫폼이 제공하는 경우 연령별·성별 팔로워를 보여 줘요.
인기 게시물top_posts 기간 중 가장 반응이 좋았던 게시물을 참여 기준 또는 sort(조회수, 도달, 좋아요, 댓글, 공유, 날짜) 기준으로 정렬해요. account를 지정하지 않으면 모든 분석 계정을 대상으로 해요.
게시하기 좋은 시간timing 내 게시물 성과가 가장 좋은 요일과 시간대(UTC), 게시 빈도 대비 참여도, 게시물이 최고치에 도달하는 속도를 보여 줘요. Instagram은 팔로워가 접속해 있는 시간도 보여 줘요.
게시물 1개post list_posts, 인기 게시물 또는 create_post에서 받은 post_id로 게시물 1개의 수치를 보여 줘요. details: true를 넣으면 일별 추이와 플랫폼별 추가 지표도 함께 나와요.

도구

TikTok 전용 도구는 없어요. 모든 게시 채널에서 작동하는 공용 게시 도구를 써요. 이 페이지에는 TikTok에서 읽는 필드만 보여요.

도구 6개 · 읽기 3개 · 쓰기 3개
게시3

Publish a post on one connected account, right away or at publish_at (then it's scheduled: returns a scheduled_post_id for list_scheduled_posts and cancel_scheduled_post). TikTok: text ≤2200, up to 35 images or 1 video (required). TikTok needs privacy_level, allow_comment (and allow_duet, allow_stitch for a video) and user_confirmed: true, meaning the user saw the final caption and media and agreed to publish (TikTok's legal requirement). Call post_options first for an account you haven't posted to in this conversation. Media: media_ids from upload_media (files the user has, or one you made), or public https links (image_urls, video_url); for a scheduled post, links must keep working until publish_at, uploads are kept with the post. Public and irreversible: confirm the account, final text, media, audience and time (with the user's time zone) with the user first.

권한 Send messages & posts한도 게시물 · 하루 10속도 조절 2–5초공개되며 되돌릴 수 없음: 텍스트와 미디어를 먼저 확인
입력TikTok 필드 · 36개 중 11개
accountstring
account_id of the account to post from (list_accounts). Needed only when several accounts that can post are connected.
textstringTikTok에서 필수
The post's text (Instagram: the caption; YouTube and Pinterest: the description; WordPress: the article's HTML)
기본값 ""TikTok에서 최대 2,200자
media_idsstring[]
media_id values from upload_media, in order (images, or one video). Instead of image_urls and video_url
1–35
image_urlsstring[]
Public https links to the images, in order
최대 35개
video_urlstring
Public https link to one video
publish_atstring
Schedule it: ISO 8601 date and time with a UTC offset, like 2026-11-03T09:30:00+01:00, at least a minute ahead, at most a year. Leave it out to publish now.
privacy_levelenumTikTok에서 필수
Who can watch; one of the levels post_options lists for the account
PUBLIC_TO_EVERYONEMUTUAL_FOLLOW_FRIENDSFOLLOWER_OF_CREATORSELF_ONLY
allow_commentbooleanTikTok에서 필수
Allow comments
allow_duetboolean
Allow duets
allow_stitchboolean
Allow stitches
user_confirmedbooleanTikTok에서 필수
True only once the user has seen the final caption and media and agreed to publish them (TikTok's legal requirement)
출력structuredContent
{
  "structuredContent": {
    "url": "https://www.threads.net/@ada.martin/post/DQ3kF8sDk2L",
    "post_id": "18063215523019873",
    "published": true
  },
  "content": [
    {
      "type": "text",
      "text": "Post published."
    }
  ]
}
TikTok에서 아직 처리 중일 때
{
  "published": false,
  "status": "publishing",
  "post_id": "6914b2c8e4a1f0d3c2b5a7e9"
}
게이트가 한 일예시09:41:02 → 09:41:04
  1. 수신09:41:02
  2. 한도 이내오늘 10회 중 3회
  3. 간격 조절+2 s
  4. 전송09:41:04
오늘 게시물: 10회 중 3회 사용 · UTC 00:00 초기화
텍스트 응답 시작 “Post published.” · 거절 코드invalid_postgaplimitcooldownpermission
예약 게시물2
분석1
pluggzy.com/api/docs에서 생성 · 도구 42개헷갈리는 부분이 있나요? 고객 지원에 문의하기 · 서비스 상태