tiktok/
trending-feed

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

TikTok Trending Feed API

Региональная лента
Нормализованные видео
Текущий снимок
0,7 кредита за результат
Готово
README

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

TikTok Trending Feed

Видео TikTok Trending Feed — это публичные записи ленты, доступные в региональном контексте, с данными о видео и авторе, подписями, обложками, метками времени и видимыми показателями вовлеченности. Эти сигналы о контенте и его эффективности помогают делать региональные снимки для поиска контента, исследовать креативы и сравнивать состояние ленты на определенный момент времени.

Возможности TikTok Trending Feed API

  • Публичная лента по регионуПринимает непустое значение region и собирает текущую публичную ленту видео, доступную в контексте этого регионального запроса.
  • Нормализованные данные о видео и авторахВозвращает в единообразных записях ID видео и исходные URL, подписи, данные об авторе, ссылки на обложки, а также время создания и сбора.
  • Видимые показатели вовлеченностиХранит вместе публичные счетчики просмотров, лайков, комментариев, репостов и сохранений для каждого возвращенного видео.
  • Ограниченный текущий снимокОбрезает один ответ региональной ленты до results_limit, не переходя к продолжению в источнике, и сохраняет текущую выборку ленты, а не позиции или исторические ряды.

Параметры TikTok Trending Feed API

ПараметрыОбязательныйОписание
regionОбязательныйОбязательное непустое значение региона. Сервер обрезает пробелы и переводит его в верхний регистр; для нужного регионального контекста используйте стандартный двухбуквенный код региона, например US.
results_limitНеобязательныйНеобязательный целочисленный лимит от 4 до 2 000; по умолчанию 100. Обрезает единственный ответ ленты, в котором может оказаться меньше видео.

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

Отправьте запрос региональной ленты как асинхронную задачу, затем читайте нормализованные видео с курсорной пагинацией результатов задачи.

  1. Введите непустое значение region; для нужного регионального контекста используйте стандартный двухбуквенный код, например US, и выберите results_limit от 4 до 2 000 или оставьте значение по умолчанию 100.
  2. Отправьте region и results_limit методом POST на /v1/tiktok/trending-feed и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items из /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/trending-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"US","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

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

  • Снимок региональной ленты: Сохраняйте ID видео, исходные URL, подписи, авторов и collected_at из одного запроса региональной ленты, чтобы зафиксировать публично доступный набор на момент сбора.
  • Выборка текущих креативных паттернов: Изучайте подписи, имена авторов, обложки и время создания, чтобы сравнивать видимый набор креативов в выбранной региональной ленте.
  • Сравнение видимой вовлеченности: Используйте счетчики просмотров, лайков, комментариев, репостов и сохранений вместе с collected_at, чтобы сравнивать публичные сигналы вовлеченности у возвращенных видео.

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

  • Используйте стандартный двухбуквенный код региона, хотя текущая реализация требует только непустое значение; сервер обрезает пробелы и переводит значение в верхний регистр.
  • Выбирайте results_limit как верхний предел, а не ожидаемое количество: эндпоинт обрезает один ответ ленты и не запрашивает следующие страницы в источнике.
  • Считайте region контекстом доступности ленты, а не доказательством происхождения видео; extra.region — это данные на уровне строки, они могут быть пустыми или отличаться от запроса.
  • Курсоры результатов задачи нужны только для постраничного чтения записей, уже сохраненных SocQ; они не загружают следующую страницу региональной ленты.
  • При сравнении повторных запусков убирайте дубли по id видео и сохраняйте collected_at, потому что состав и порядок ленты между запросами могут меняться.
  • Обрабатывайте поля автора, метрики, обложки, метки времени и значения extra как поля, которые могут быть null, и экранируйте публичные подписи перед выводом.

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

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

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

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

TikTok Trending Feed API — FAQ

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

Передайте непустое значение region; сервер обрезает пробелы и переводит его в верхний регистр. Используйте стандартный двухбуквенный код, например US, потому что публичная документация и интерфейс источника определяют региональный параметр именно так, хотя текущая реализация не проверяет двухбуквенный формат.

results_limit по умолчанию равен 100 и принимает целые числа от 4 до 2 000. Он обрезает один возвращенный ответ региональной ленты, поэтому более высокий лимит не запускает продолжение в источнике и не гарантирует такое количество видео.

Запись может содержать ID видео и исходный URL, подпись, ID автора, имя пользователя и отображаемое имя, видимые счетчики просмотров, лайков, комментариев, репостов и сохранений, одну обложку, время создания и сбора, а также extra.region и extra.is_ad.

Нет. region задает контекст доступности ленты для запроса, а не местоположение автора или происхождение видео; extra.region передается для каждой строки отдельно и может быть пустым или отличаться.

Нет. Он возвращает видео из текущей доступной ленты без нормализованных полей позиции, изменения позиции, агрегатов по хештегам, чартов авторов, чартов музыки или исторических рядов. Для сравнений сохраняйте результаты повторных задач вместе с collected_at.

Каждое успешно сохраненное нормализованное видео стоит 0,7 кредита без базовой платы за задачу. Предварительная оценка использует results_limit или значение по умолчанию 100, а неиспользованные предоплаченные кредиты возвращаются при окончательном расчете задачи.