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
Отправьте запрос региональной ленты как асинхронную задачу, затем читайте нормализованные видео с курсорной пагинацией результатов задачи.
- Введите непустое значение region; для нужного регионального контекста используйте стандартный двухбуквенный код, например US, и выберите results_limit от 4 до 2 000 или оставьте значение по умолчанию 100.
- Отправьте region и results_limit методом POST на /v1/tiktok/trending-feed и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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, и экранируйте публичные подписи перед выводом.
Связанные API
Помимо 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 Profiles API
- TikTok Hashtags 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 Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists 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