Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Ustawienia postów TikTok przez API: prywatność, komentarze, Duet i Stitch

API dla firm TikTok przyjmuje ustawienia posta w wywołaniu publikacji, głównie wewnątrz post_info. Wideo przyjmuje disable_comment, disable_duet i disable_stitch, okładkę z thumbnail_offset lub custom_thumbnail_url, oznaczenia is_brand_organic i is_branded_content oraz is_ai_generated. Posty zdjęciowe przyjmują privacy_level, disable_comment, te same oznaczenia marki i auto_add_music. GET /business/video/settings/ zwraca wartości dozwolone dla każdego konta.

easyCoexistence publikuje wideo i posty zdjęciowe TikTok za pomocą publish_tiktok_post z Claude, ChatGPT lub własnego kodu, z podpisem, tytułem posta zdjęciowego i włączonymi lub wyłączonymi komentarzami, a get_social_credentials daje własnemu kodowi token do odczytu dozwolonych ustawień konta.

3 levels

Opcje prywatności postów zdjęciowych publicznego konta: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY.

FOLLOWER_OF_CREATOR

Poziom prywatności, jaki konto prywatne otrzymuje zamiast PUBLIC_TO_EVERYONE: widoczny tylko dla jego obserwujących.

false

Domyślna wartość disable_comment, disable_duet i disable_stitch, więc komentarze, Duety i Stitche pozostają włączone, o ile ich nie wyłączono.

1080 x 1920

Własna okładka wideo musi mieć co najmniej 360 x 360 pikseli i co najwyżej 20 MB.

Paid partnership

Oznaczenie is_branded_content ma pierwszeństwo, gdy is_brand_organic także ma wartość true.

privacy_level

Pole wymagane w post_info posta zdjęciowego, ograniczone do opcji, które GET /business/video/settings/ zwraca dla konta.

Jakich ustawień wymaga każdy endpoint publikacji?

/business/video/publish/ i /business/photo/publish/ mają wspólne ustawienia i różnią się w innych. Większość znajduje się w post_info, a custom_thumbnail_url i photo_cover_index na najwyższym poziomie treści żądania. Poniżej zestawienie tak, jak podają je referencje TikTok, z oznaczeniem „Brak pola” tam, gdzie endpoint nie opisuje danego ustawienia:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

Na co pozwala konto?

GET /business/video/settings/ z business_id zwraca limity konta dla jego postów. Odczytaj je przed publikacją, ponieważ TikTok przyjmuje tylko wartości, które wymienia:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY dla konta publicznego; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY dla prywatnego.
  • comment_disabled: true, gdy konto nie przyjmuje komentarzy od nikogo; wtedy disable_comment przyjmuje wyłącznie true.
  • duet_disabled i stitch_disabled: true, gdy konto zezwala na Duet lub Stitch tylko dla „Tylko ty” albo jest prywatne; odpowiedni przełącznik przyjmuje wtedy wyłącznie true.
  • max_video_post_duration_sec: najdłuższe wideo, jakie konto może opublikować; dłuższe zakończy się błędem.
Read an account's post settings
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "comment_disabled": false,
    "duet_disabled": false,
    "max_video_post_duration_sec": 600,
    "privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
    "stitch_disabled": false
  }
}

Kto może zobaczyć post?

W poście zdjęciowym o widoczności decyduje privacy_level, który wysyłasz: PUBLIC_TO_EVERYONE dla osób na TikToku i poza nim, MUTUAL_FOLLOW_FRIENDS dla obserwujących, których konto obserwuje w zamian, FOLLOWER_OF_CREATOR dla obserwujących konta prywatnego, albo SELF_ONLY. Endpoint wideo nie ma pola prywatności, bo publikuje publiczne posty wideo. Post ustawiony na Znajomi lub „Tylko ty” nie może być też oglądany przez embed_url.

Jak działają komentarze, Duet i Stitch?

Każdy z nich to przełącznik, który po ustawieniu na true wyłącza daną funkcję. disable_comment występuje w obu endpointach; disable_duet i disable_stitch tylko przy wideo. Wszystkie domyślnie mają wartość false, co pozostawia funkcję włączoną, w granicach ustawień prywatności konta: konto, które nie przyjmuje komentarzy od nikogo albo ogranicza Duet lub Stitch do „Tylko ty”, może publikować wyłącznie z ustawionym na true odpowiednim przełącznikiem.

Jak wybierana jest okładka?

W przypadku wideo na dwa sposoby. post_info.thumbnail_offset wybiera klatkę po czasie w milisekundach, domyślnie 0, zaokrągloną w górę do najbliższej klatki; czas wykraczający poza koniec wideo wysyła webhook o błędzie, a wideo nie zostaje opublikowane. custom_thumbnail_url na najwyższym poziomie treści żądania podaje obraz zamiast tego i powoduje, że TikTok ignoruje offset. W poście zdjęciowym photo_cover_index wybiera jedno ze zdjęć, numerując od 0.

  • Własna okładka: JPG, JPEG, WebP lub PNG, do 20 MB.
  • Rozmiar: od 360 x 360 pikseli do 1080 x 1920 albo 1920 x 1080.
  • Lokalizacja: domena lub prefiks URL zweryfikowany dla aplikacji, tak jak samo wideo.

Co oznaczają etykiety marki?

Informacje, które TikTok pokazuje pod postem. is_brand_organic ustawione na true oznacza go jako „Promotional content”, czyli treść promującą własną firmę konta. is_branded_content ustawione na true oznacza go jako „Paid partnership”, czyli post powstały we współpracy płatnej z marką, i ma pierwszeństwo, gdy oba są true. W wideo z is_branded_content parametr tto_invite_link może powiązać post z kampanią TikTok One Creator Marketplace, do której konto dołączyło.

Jakie inne opcje są w post_info?

Kilka kolejnych, każda opisana w endpoincie, który ją przyjmuje:

  • is_ai_generated, wideo: oznacza post jako „Creator labeled as AI-generated”, czego nie można zmienić po publikacji.
  • location_id z location_name: oznaczenie lokalizacji znalezione przez GET /business/publish/location/.
  • music_sound_info: dźwięk komercyjny po ID; w wideo także jego głośność, od 0 do 100, oraz początek i koniec w milisekundach.
  • auto_add_music, posty zdjęciowe: dodaje zalecaną muzykę, którą można później zmienić w aplikacji TikTok.
  • upload_to_draft lub is_draft: wysyła post z wideo do skrzynki twórcy jako szkic, z zakresem video.upload.
  • is_ads_only, wideo: publikuje post „Only show in ads”, który nie pojawia się na profilu.

Które ustawienia ustawia publish_tiktok_post?

Trzy pochodzą z Twojego żądania: podpis, tytuł posta zdjęciowego i disable_comment. easyCoexistence wysyła is_brand_organic i is_branded_content jako false, publikuje posty zdjęciowe jako PUBLIC_TO_EVERYONE z pierwszym obrazem jako okładką i pomija resztę ustawień wideo, więc obowiązują domyślne wartości TikTok: disable_duet i disable_stitch to false, thumbnail_offset to 0, a is_ai_generated to false.

Jak wysyłać pozostałe ustawienia?

Z własnego kodu, z tokenem i business_id konta z get_social_credentials, na ścieżkach Business API pod business/. GET do business/video/settings/ odczytuje limity konta. POST do business/video/publish/ lub business/photo/publish/ może zawierać pełną, udokumentowaną treść żądania i trafia do TikTok dokładnie tak, jak zapisano, z adresami mediów, które muszą znajdować się w domenie lub prefiksie URL zweryfikowanym dla aplikacji. publish_tiktok_post to wywołanie, które kieruje Twój link przez zweryfikowaną trasę mediów easyCoexistence.

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

Typowe błędy

  • Oczekiwanie, że privacy_level zadziała przy wideo. Endpoint wideo publikuje posty publiczne, a jego referencje nie zawierają pola prywatności; posty zdjęciowe przyjmują privacy_level.
  • Włączanie komentarzy na koncie, które ich nie przyjmuje. Gdy comment_disabled ma wartość true, TikTok przyjmuje disable_comment wyłącznie jako true.
  • Ustawienie thumbnail_offset za końcem wideo. TikTok wysyła webhook o błędzie, a wideo nie zostaje opublikowane.
  • Wysyłanie PUBLIC_TO_EVERYONE dla konta prywatnego. Jego privacy_level_options zawiera zamiast tego FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0,75 za połączenie miesięcznie, cena spada wraz z dodawaniem połączeń. Pierwsze 3 dni są bezpłatne.

Najczęściej zadawane pytania

Czy mogę opublikować prywatne wideo TikTok przez API?

Nie endpointem wideo, który publikuje posty publiczne. Posty zdjęciowe przyjmują privacy_level, w tym SELF_ONLY, a wideo może trafić do skrzynki twórcy jako szkic przez upload_to_draft.

Jak wyłączyć Duety i Stitche przez API?

Ustaw post_info.disable_duet i post_info.disable_stitch na true w /business/video/publish/. Gdy konto już je ogranicza, TikTok przyjmuje wyłącznie true.

Czy mogę dodać oznaczenie lokalizacji przez API TikTok?

Tak. post_info przyjmuje location_id z location_name, dla oznaczenia lokalizacji znalezionego przez GET /business/publish/location/.

Jaka jest różnica między is_brand_organic a is_branded_content?

is_brand_organic dodaje etykietę „Promotional content” dla własnej firmy konta; is_branded_content dodaje etykietę „Paid partnership” i ma pierwszeństwo, gdy oba są true.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w