> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # TikTok API > Опції публікації через TikTok API Ayrshare пропонує [пряму публікацію відео TikTok](https://www.ayrshare.com/blog/introducing-tiktok-direct-publishing-analytics-and-commenting/), керування коментарями та отримання розширеної аналітики для вашого особистого чи бізнес-облікового запису TikTok через TikTok API. TikTok обробляє відео та фотографії асинхронно, тому JSON-відповідь буде status: "pending" як для миттєвих, так і для запланованих дописів. Щойно TikTok завершить обробку, буде викликано ваш зареєстрований [Scheduled Action webhook](/apis/webhooks/actions#scheduled-action). ## Відео-допис у TikTok JSON для базового відео-допису TikTok, який публікується напряму: ```json TikTok Video Post theme={"system"} { "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"], "platforms": ["tiktok"] } ``` Приклад JSON-відповіді на публікацію: ```json TikTok Video Post Response theme={"system"} { "status": "success", "errors": [], "postIds": [ { "status": "success", "idShare": "video.7088122496758679353.nzLqBWbf", "id": "pending", "isVideo": true, "platform": "tiktok" } ], "id": "lb42orDhySAZmLWtj6b6", "refId": "23a9da9e0df1184a7a6a1fc2c60b8023aa9a32a1", "post": "The best TikTok video ever #bestvideo" } ``` ### Вимоги до відео TikTok TikTok обмежує API-публікацію відео до 6 відео за хвилину з верхнім лімітом 15 відео на день. ## Фото-допис у TikTok JSON для базового фото-допису TikTok, який публікується напряму: ```json TikTok Image Post theme={"system"} { "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break "mediaUrls": [ "https://img.ayrshare.com/012/gb.jpg", "https://img.ayrshare.com/random/photo-1.jpg" ], // Up to 35 images "platforms": ["tiktok"] } ``` Приклад JSON-відповіді: ```json TikTok Image Post Response theme={"system"} { "status": "success", "errors": [], "postIds": [ { "status": "success", "idShare": "p_pub_url~v2.7408974036430047275", "id": "pending", "isVideo": false, "platform": "tiktok" } ], "id": "8815mJ5bWApEebWjE233", "tikTokId": "p_pub_url~v2.7408974036430047333", "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc333", "post": "Opportunity is missed by most people because it is dressed in overalls and looks like work - Thomas Edison" } ``` ### Вимоги до зображень TikTok TikTok обмежує API-публікацію до 6 фото за хвилину з верхнім лімітом 15 фото на день. ## Обробка у TikTok TikTok виконує асинхронну обробку відео та зображень, тому у відповіді поле `id` буде встановлене на `"pending"`. Після завершення обробки TikTok, зазвичай протягом 1–2 хвилин, поле `id` буде оновлено `id` відео TikTok, і буде додано `postUrl`. ## TikTok Options Під час публікації відео чи зображень у TikTok доступні [додаткові опції](/apis/post/social-networks/tiktok#available-tiktok-options). Приклад публікації відео: ```json TikTok Video Publishing theme={"system"} { "tikTokOptions": { "disableComments": true, // Default false. Disable comments on the published video. "disableDuet": true, // Default false. Disable duets on the published video. "disableStitch": true // Default false. Disable stitches on the published video. } } ``` Приклад публікації зображень: ```json TikTok Image Publishing theme={"system"} { "tikTokOptions": { "imageCoverIndex": 1, // Use the second image in the mediaUrls. "title": "Amazing images" } } ``` ### Опції Для дописів TikTok доступні наведені нижче опції. Їх слід додавати до об'єкта `tikTokOptions`. Див. нижче деталі щодо кожної опції. ```json TikTok Options theme={"system"} { "post": "The best TikTok video ever #bestvideo", "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"], "platforms": ["tiktok"], "tikTokOptions": { "autoAddMusic": true, "disableComments": true, "disableDuet": true, "disableStitch": true, "draft": true, "isAIGenerated": true, "isBrandedContent": true, "isBrandOrganic": true, "imageCoverIndex": 1, "title": "Amazing images", "thumbNailOffset": 30000, "visibility": "public" } } ``` Чи автоматично додавати рекомендовану музику до допису. Якщо ви встановите це поле у `true`, ви зможете змінити музику пізніше у застосунку TikTok. Media type: image Чи вимикати коментарі до опублікованого допису. Media type: video, image Вимкнути duets на опублікованому відео. Media type: video Вимкнути stitch на опублікованому відео. Media type: video Чи створити draft-допис. Див. [опції draft](/apis/post/social-networks/tiktok#tiktok-video-draft-post) для отримання додаткової інформації. Media type: video or image Чи вмикати перемикач AI-згенерованого контенту для відео-допису. Якщо ви ввімкнете перемикач, ваше відео буде помічене як "Creator labeled as AI-generated" після публікації, і це не можна буде змінити. Мітка "Creator labeled as AI-generated" вказує, що вміст був повністю згенерований ШІ або значно відредагований за допомогою ШІ. Увімкнення налаштування AI-генерованого контенту не вплине на розповсюдження вашого відео, поки воно не порушує [Community Guidelines](https://www.tiktok.com/community-guidelines/en/) TikTok. Media type: video Чи вмикати перемикач Branded Content. Якщо це поле встановлено у `true`, відео буде помічене як Branded Content, що вказує на те, що ви перебуваєте у платному партнерстві з брендом. До відео буде додано мітку "Paid partnership". Media type: video, image Чи вмикати перемикач Brand Organic Content. Якщо це поле встановлено у `true`, відео буде помічене як Brand Organic Content, що вказує на те, що ви просуваєте себе або власний бізнес. До відео буде додано мітку "Promotional content". Media type: video, image Індекс у `mediaUrls` для використання як обкладинки допису. Media type: image Заголовок допису. Media type: image Кадр для використання як обкладинка відео. Див. [опції відео-мініатюри](/apis/post/social-networks/tiktok#video-thumbnail) для отримання додаткової інформації. Media type: video Як допис поширюється і хто може його бачити. Значення: `public`, `private`, `followers` або `friends`. Див. [опції видимості](/apis/post/social-networks/tiktok#visibility-options) для отримання додаткової інформації. Media type: image ### Опції видимості | Видимість | Опис | | :-------- | :---------------------------------------------- | | public | Видно всім користувачам TikTok. | | private | Приватний, видно лише самому обліковому запису. | | followers | Видно лише підписникам облікового запису. | | friends | Видно лише взаємним підписникам. | Приватні дописи залишатимуться в статусі `pending`, і webhook TikTok не буде надіслано, доки допис не стане публічним. ## Мініатюра відео Існує два способи встановити мініатюру, також відому як cover photo, для відео TikTok: 1. За допомогою параметра `thumbNailOffset`, щоб встановити кадр мініатюри. 2. За допомогою параметра `thumbNail`, щоб встановити зображення мініатюри за URL. Встановлення мініатюри підтримується лише для відео. ### Зміщення мініатюри Встановіть мініатюру для відео TikTok, вибравши кадр за зміщенням. ```json TikTok Video Thumbnail Offset theme={"system"} { "tikTokOptions": { "thumbNailOffset": 30000 // milliseconds of offset image } } ``` Зміщення — це розташування у мілісекундах кадру мініатюри. Значення за замовчуванням `0`, це перший кадр відео. ### URL мініатюри Встановіть мініатюру для відео TikTok, завантаживши зображення за URL. ```json TikTok Video Thumbnail URL theme={"system"} { "tikTokOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` Якщо ви використовуєте параметр `thumbNail`, параметр `thumbNailOffset` буде проігноровано. Див. [TikTok Thumbnail Requirements](/media-guidelines/tiktok#video-thumbnail) для отримання додаткової інформації. ## Згадування у TikTok Згадайте інший handle TikTok, додавши `@handle` у текст допису. Наприклад: ```json TikTok Mention theme={"system"} { "post": "Love the @ayrshare social media api" } ``` Ознайомтеся з [важливими правилами](/testing/post-verification#mentions) щодо згадувань. ## Draft-допис у TikTok Створіть draft-допис для відео чи зображення TikTok, що дозволяє редагувати відео або зображення перед публікацією. ```json TikTok Video Draft Post theme={"system"} { "post": "The best TikTok video ever #bestvideo", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"], "platforms": ["tiktok"], "tikTokOptions": { "draft": true } } ``` Draft-допис відео або зображення можна знайти під сповіщеннями **Inbox** у нижньому рядку застосунку TikTok. Шукайте повідомлення **System notifications** і потім натисніть верхнє повідомлення **Your content from Ayrshare is ready**. Ayrshare `postUrl` залишатиметься в статусі `pending`, доки відео не буде опубліковано. Перший коментар не підтримується для draft-дописів. TikTok Draft Post ## Оновлення авторизації TikTok повинен бути повторно авторизований *щороку* через сторінку Social Accounts. ## Обмеження символів Див. [TikTok Character Limits](/help-center/technical-support/character_limits#tiktok-character-limits) для отримання додаткової інформації. ## Додаткова інформація Додаткові [приклади використання TikTok API](https://www.ayrshare.com/blog/tiktok-api-how-to-post-to-tiktok-using-a-social-media-api/).