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
Отправьте имя пользователя и прочитайте плейлисты автора.
- Отправьте {"username": "zachking"} методом POST на /v1/tiktok/user-playlists.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте плейлисты из 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, чтобы самые долгие серии автора оказались наверху, прежде чем читать названия.
Связанные API
Помимо 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 Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API