tiktok/
user-playlists

Получайте публичные плейлисты из профиля любого автора TikTok по имени пользователя: название каждого плейлиста, ссылка, обложка, число видео и данные о владельце.

TikTok Playlists API

Поиск по имени пользователя
Названия плейлистов
Число видео в плейлисте
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

TikTok Playlists

Плейлист TikTok — это именованная подборка собственных видео автора, например история в нескольких частях, серия обучающих роликов или регулярная рубрика, которая показывается в профиле с обложкой и числом видео. Список плейлистов по имени пользователя показывает, какие серии автор оформил и сколько видео в каждой из них.

Возможности TikTok Playlists API

  • Все публичные плейлисты профиляОтправьте имя пользователя и получите каждый публичный плейлист отдельной записью — не больше results_limit, который принимает значения от 1 до 100 и по умолчанию равен 20.
  • Длина серии в item_countitem_count — это число видео в плейлисте, поэтому долгая серия сразу отличается от подборки из нескольких роликов.
  • Название, обложка и прямая ссылкаtitle, cover_url и url плейлиста приходят в каждой записи, а author повторяет id, имя пользователя и аватар владельца, чтобы каждая запись была самодостаточной.

Параметры TikTok Playlists API

ПараметрыОбязательныйОписание
usernameОбязательныйИмя пользователя TikTok, чьи плейлисты нужно получить, с начальным @ или без него.
results_limitНеобязательныйСколько плейлистов вернуть, от 1 до 100. По умолчанию 20.

Как использовать TikTok Playlists API

Отправьте имя пользователя и прочитайте плейлисты автора.

  1. Отправьте {"username": "zachking"} методом POST на /v1/tiktok/user-playlists.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте плейлисты из results.items; переходите по results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"zachking"}'

# Each item is one playlist with title and item_count.

Сценарии использования TikTok Playlists API

  • Сравнение форматов серий в нише: Сравнивайте title и item_count у авторов одной категории, чтобы увидеть, в какие форматы серий они продолжают вкладываться и как долго их поддерживают.
  • Проверка партнера перед регулярным сотрудничеством: Прежде чем предлагать многосерийное или регулярное партнерство, проверьте, организует ли потенциальный партнер контент в серии и насколько длинные эти серии.

Практические советы по TikTok Playlists API

  • Сопоставляйте плейлисты между снимками по id, а не по title: автор может переименовать плейлист.
  • Отсортируйте по item_count, чтобы самые долгие серии автора оказались наверху, прежде чем читать названия.

Помимо TikTok Playlists API, используйте эти API, когда нужен другой тип публичных данных TikTok.

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Videos API — Получайте по URL видео автора, подпись, медиа, музыку, теги, упоминания и вовлеченность.
  • TikTok User Videos API — Собирайте публичные видео из ленты профиля по имени пользователя: подписи, авторы, медиа, метки времени, вовлеченность и контекст исходного аккаунта.
  • TikTok Trending Feed API — Собирайте текущую публичную ленту видео для региона: автор, подпись, обложка, метка времени и видимая вовлеченность.
  • TikTok Video Transcript API — Извлекайте доступный текст расшифровки, язык, формат и контекст источника по URL публичных видео.
  • TikTok Reposts API — Получайте видео, которые аккаунт опубликовал репостом: автор оригинала, подпись и число просмотров.

Другие платформы

Объединяйте данные TikTok с публичными данными других поддерживаемых соцсетей.

TikTok Playlists API — FAQ

TikTok Playlists API — это программный интерфейс для получения публичных плейлистов из профиля автора TikTok по его имени пользователя. Для каждого плейлиста он возвращает ID, название, ссылку, обложку, число видео и данные о владельце.

Нет. Каждая запись описывает сам плейлист, а item_count показывает, сколько в нем видео. Чтобы получить видео автора, используйте TikTok User Videos.

Нет. Плейлист — это публичная подборка собственных видео автора в профиле, и именно ее возвращает этот эндпоинт. Коллекции — это личные папки сохраненных видео, и в результат они не входят.

У автора нет публичных плейлистов, и это обычная ситуация, потому что TikTok разрешает создавать плейлисты только авторам, которые соответствуют условиям. Задача всё равно завершается успешно, и ничего не списывается; каждый возвращенный плейлист стоит 0,5 кредита.

Запустите то же имя пользователя позже и сравните item_count каждого плейлиста; collected_at в каждой записи указывает дату снимка.