TikTok API

Ayrshare пропонує пряму публікацію відео TikTok, керування коментарями та отримання розширеної аналітики для вашого особистого чи бізнес-облікового запису TikTok через TikTok API.TikTok обробляє відео та фотографії асинхронно, тому JSON-відповідь буде status: “pending” як для миттєвих, так і для запланованих дописів. Щойно TikTok завершить обробку, буде викликано ваш зареєстрований Scheduled Action webhook.

Відео-допис у TikTok

JSON для базового відео-допису TikTok, який публікується напряму:

TikTok Video Post

{
  "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-відповіді на публікацію:

TikTok Video Post Response

{
  "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 наразі не підтримує розриви рядків у тексті допису. Включені розриви рядків будуть проігноровані.
Можна опублікувати або одне відео, або до 35 зображень. TikTok не підтримує комбінацію відео та зображень. Див. нижче для отримання додаткової інформації.
Якщо відео не закінчується відомим розширенням, використовуйте isVideo.
TikTok також підтримує надсилання медіа без тексту допису. Якщо ви не хочете включати текст допису, надішліть порожній рядок post: "".
Див. TikTok Media Guidelines та TikTok Authorization для отримання додаткової інформації.

Вимоги до відео TikTok

Див. TikTok Video Requirements.
Відео має закінчуватися відомим розширенням відео, як-от mp4. Використайте reverse proxy для URL, додайте vanity URL з CDN, або використовуйте ендпоінт /media.
Обмеження символів тексту допису TikTok — 2 200.

TikTok обмежує API-публікацію відео до 6 відео за хвилину з верхнім лімітом 15 відео на день.

Фото-допис у TikTok

JSON для базового фото-допису TikTok, який публікується напряму:

TikTok Image Post

{
  "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-відповіді:

TikTok Image Post Response

{
  "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 наразі не підтримує розриви рядків у тексті допису. Включені розриви рядків будуть проігноровані.
Можна опублікувати або одне відео, або до 35 зображень.
TikTok не підтримує комбінацію відео та зображень. Див. нижче для отримання додаткової інформації.
Зображення мають бути типу JPG, JPEG або WEBP. TikTok не приймає медіафайли PNG.
Ви також можете вибрати одне із зображень як обкладинку за допомогою imageCoverIndex. За замовчуванням використовується перше зображення. Див. деталі нижче.

Вимоги до зображень TikTok

Див. TikTok Image Requirements.
До допису може бути включено до 35 зображень по 20 МБ на зображення.
Зображення мають бути типу JPG, JPEG або WEBP. TikTok не приймає медіафайли PNG.
Обмеження символів тексту допису TikTok — 2 200.

TikTok обмежує API-публікацію до 6 фото за хвилину з верхнім лімітом 15 фото на день.

Обробка у TikTok

TikTok виконує асинхронну обробку відео та зображень, тому у відповіді поле id буде встановлене на "pending". Після завершення обробки TikTok, зазвичай протягом 1–2 хвилин, поле id буде оновлено id відео TikTok, і буде додано postUrl.

Ви можете отримати остаточний статус допису TikTok за допомогою webhooks або ендпоінта /history; зазвичай це доступно протягом 1–2 хвилин.
Коли користувач публікує відео в мобільному застосунку TikTok, буде надіслано webhook “scheduled” з subAction: "tikTokPublished".
Перший коментар до допису TikTok відкладено: він публікується автоматично, коли webhook tikTokPublished розв’язує реальне id відео, а не в момент публікації. visibility відео має бути public, інакше перший коментар не може бути опубліковано і повертається помилка коментаря.
Якщо станеться помилка, як-от TikTok не зміг обробити відео або внутрішні тести Ayrshare завершилися невдачею, поле id буде встановлено як “failed”, а поле errors буде містити деталі помилки.
idShare використовується для внутрішнього посилання на очікуване відео.

TikTok Options

Під час публікації відео чи зображень у TikTok доступні додаткові опції. Приклад публікації відео:

TikTok Video Publishing

{
  "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.
  }
}

Приклад публікації зображень:

TikTok Image Publishing

{
  "tikTokOptions": {
    "imageCoverIndex": 1, // Use the second image in the mediaUrls.
    "title": "Amazing images"
  }
}

Опції

Для дописів TikTok доступні наведені нижче опції. Їх слід додавати до об’єкта tikTokOptions. Див. нижче деталі щодо кожної опції.

TikTok Options

{
  "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"
  }
}

autoAddMusic

boolean

за замовчуванням:false

Чи автоматично додавати рекомендовану музику до допису. Якщо ви встановите це поле у true, ви зможете змінити музику пізніше у застосунку TikTok.Media type: image

disableComments

boolean

за замовчуванням:false

Чи вимикати коментарі до опублікованого допису.Media type: video, image

disableDuet

boolean

за замовчуванням:false

Вимкнути duets на опублікованому відео.Media type: video

disableStitch

boolean

за замовчуванням:false

Вимкнути stitch на опублікованому відео.Media type: video

draft

boolean

за замовчуванням:false

Чи створити draft-допис.Див. опції draft для отримання додаткової інформації.Media type: video or image

isAIGenerated

boolean

за замовчуванням:false

Чи вмикати перемикач AI-згенерованого контенту для відео-допису.Якщо ви ввімкнете перемикач, ваше відео буде помічене як “Creator labeled as AI-generated” після публікації, і це не можна буде змінити. Мітка “Creator labeled as AI-generated” вказує, що вміст був повністю згенерований ШІ або значно відредагований за допомогою ШІ.

Увімкнення налаштування AI-генерованого контенту не вплине на розповсюдження вашого відео, поки воно не порушує Community Guidelines TikTok.

Media type: video

isBrandedContent

boolean

за замовчуванням:false

Чи вмикати перемикач Branded Content. Якщо це поле встановлено у true, відео буде помічене як Branded Content, що вказує на те, що ви перебуваєте у платному партнерстві з брендом. До відео буде додано мітку “Paid partnership”.Media type: video, image

isBrandOrganic

boolean

за замовчуванням:false

Чи вмикати перемикач Brand Organic Content. Якщо це поле встановлено у true, відео буде помічене як Brand Organic Content, що вказує на те, що ви просуваєте себе або власний бізнес. До відео буде додано мітку “Promotional content”.Media type: video, image

imageCoverIndex

number

за замовчуванням:"0"

Індекс у mediaUrls для використання як обкладинки допису.Media type: image

title

string

Заголовок допису.Media type: image

thumbNailOffset

number

Кадр для використання як обкладинка відео.Див. опції відео-мініатюри для отримання додаткової інформації.Media type: video

visibility

string

за замовчуванням:"public"

Як допис поширюється і хто може його бачити.Значення: public, private, followers або friends.Див. опції видимості для отримання додаткової інформації.Media type: image

Опції видимості

Видимість	Опис
public	Видно всім користувачам TikTok.
private	Приватний, видно лише самому обліковому запису.
followers	Видно лише підписникам облікового запису.
friends	Видно лише взаємним підписникам.

Приватні дописи залишатимуться в статусі pending, і webhook TikTok не буде надіслано, доки допис не стане публічним.

Мініатюра відео

Існує два способи встановити мініатюру, також відому як cover photo, для відео TikTok:

За допомогою параметра thumbNailOffset, щоб встановити кадр мініатюри.
За допомогою параметра thumbNail, щоб встановити зображення мініатюри за URL.

Встановлення мініатюри підтримується лише для відео.

Зміщення мініатюри

Встановіть мініатюру для відео TikTok, вибравши кадр за зміщенням.

TikTok Video Thumbnail Offset

{
  "tikTokOptions": {
    "thumbNailOffset": 30000 // milliseconds of offset image
  }
}

Зміщення — це розташування у мілісекундах кадру мініатюри. Значення за замовчуванням 0, це перший кадр відео.

URL мініатюри

Встановіть мініатюру для відео TikTok, завантаживши зображення за URL.

TikTok Video Thumbnail URL

{
  "tikTokOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

Якщо ви використовуєте параметр thumbNail, параметр thumbNailOffset буде проігноровано. Див. TikTok Thumbnail Requirements для отримання додаткової інформації.

Згадування у TikTok

Згадайте інший handle TikTok, додавши @handle у текст допису. Наприклад:

TikTok Mention

{
  "post": "Love the @ayrshare social media api"
}

Ознайомтеся з важливими правилами щодо згадувань.

Draft-допис у TikTok

Створіть draft-допис для відео чи зображення TikTok, що дозволяє редагувати відео або зображення перед публікацією.

TikTok Video Draft Post

{
  "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 повинен бути повторно авторизований щороку через сторінку Social Accounts.

Сповіщення електронною поштою та webhook social action буде надіслано за 15 днів до закінчення авторизації.
Дата, до якої потрібне оновлення, та кількість днів, що залишилися, можна отримати з ендпоінта /user.

Обмеження символів

Див. TikTok Character Limits для отримання додаткової інформації.

Додаткова інформація

Додаткові приклади використання TikTok API.

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Відео-допис у TikTok

Вимоги до відео TikTok

Фото-допис у TikTok

Вимоги до зображень TikTok

Обробка у TikTok

TikTok Options

Опції

Опції видимості

Мініатюра відео

Зміщення мініатюри

URL мініатюри

Згадування у TikTok

Draft-допис у TikTok

Оновлення авторизації

Обмеження символів

Додаткова інформація

​Відео-допис у TikTok

​Вимоги до відео TikTok

​Фото-допис у TikTok

​Вимоги до зображень TikTok

​Обробка у TikTok

​TikTok Options

​Опції

​Опції видимості

​Мініатюра відео

​Зміщення мініатюри

​URL мініатюри

​Згадування у TikTok

​Draft-допис у TikTok

​Оновлення авторизації

​Обмеження символів

​Додаткова інформація

Відео-допис у TikTok

Вимоги до відео TikTok

Фото-допис у TikTok

Вимоги до зображень TikTok

Обробка у TikTok

TikTok Options

Опції

Опції видимості

Мініатюра відео

Зміщення мініатюри

URL мініатюри

Згадування у TikTok

Draft-допис у TikTok

Оновлення авторизації

Обмеження символів

Додаткова інформація