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.
Opcje prywatności postów zdjęciowych publicznego konta: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS i SELF_ONLY.
Poziom prywatności, jaki konto prywatne otrzymuje zamiast PUBLIC_TO_EVERYONE: widoczny tylko dla jego obserwujących.
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.
Własna okładka wideo musi mieć co najmniej 360 x 360 pikseli i co najwyżej 20 MB.
Oznaczenie is_branded_content ma pierwszeństwo, gdy is_brand_organic także ma wartość true.
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 post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_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_FRIENDSiSELF_ONLYdla konta publicznego;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSiSELF_ONLYdla prywatnego.comment_disabled: true, gdy konto nie przyjmuje komentarzy od nikogo; wtedydisable_commentprzyjmuje wyłącznie true.duet_disabledistitch_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.
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_idzlocation_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_draftlubis_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.
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.
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