Список видео аккаунта TikTok через API
API for Business у TikTok выводит публичные посты аккаунта через GET /business/video/list/, начиная с самых новых, до 20 на страницу. Укажите поля для возврата, например item_id, caption, share_url и video_views, и листайте страницы через cursor, пока has_more равен true. filters.video_ids выделяет конкретные посты, а каждый item_id является тем ID, который принимают вызовы комментариев.
easyCoexistence выводит последние посты аккаунта TikTok с помощью list_social_posts из Claude, ChatGPT или вашего кода: с item_id, caption, ссылкой и счётчиками.
Наибольшее число постов, которое /business/video/list/ возвращает на страницу; max_count по умолчанию равен 10.
Единица измерения cursor: метка времени Unix в UTC. Эндпоинт возвращает посты, опубликованные раньше неё.
Поле по умолчанию, которое должно входить в запрос с несколькими полями, иначе может возникнуть ошибка.
Лимит вызовов на каждый авторизованный аккаунт для этого эндпоинта, как и для любого эндпоинта Accounts API.
Что возвращает эндпоинт?
Публичные посты аккаунта: видео, которые показываются в его профиле, фото- и текстовые посты, а также видео «Only show in ads», которые идут как реклама и не появляются в профиле. media_type отличает VIDEO от PHOTO, куда входят фото- и текстовые посты. Посты, которые TikTok отфильтровал за нарушения, например за авторские права на музыку, в список не попадают.
Как его вызвать?
GET-запросом с параметрами в URL: business_id, fields как JSON-массив и, по желанию, filters, cursor и max_count, по умолчанию 10. Токен передаётся в заголовке Access-Token, а приложению разработчика нужно разрешение Get Account Media в разделе TikTok Accounts:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","create_time","media_type","caption","share_url","thumbnail_url","video_views","likes","comments","shares"]' \
--data-urlencode 'max_count=20'Какие поля описывают пост?
Помимо метрик, от video_views до impression_sources, список содержит следующие поля, все в рамках области video.list:
item_id: ID поста, который используют вызовы комментариев и filters.video_ids.media_type: VIDEO или PHOTO для фото- или текстового поста.is_ad: используется ли пост в рекламе.create_time: время публикации поста в секундах Unix в UTC.- caption: описание поста, включая хэштеги.
share_url: ссылка для отправки, которая ведёт себя по-разному на мобильных устройствах и на компьютере.embed_url: ссылка на плеер для других сайтов; она не воспроизводит посты с настройкой «Friends» или «Only you».thumbnail_url: временное превью-изображение, срок действия которого указан в параметре x-expires.video_duration: длительность в секундах с тремя знаками после запятой.
Как выглядит страница результатов?
Массив videos в порядке, в котором его вернул TikTok, а также cursor, значение для следующей страницы, и has_more, который показывает, есть ли она. create_time приходит строкой с секундами Unix. Пример TikTok, сокращённый до описательных полей и счётчиков:
{
"code": 0,
"message": "OK",
"request_id": "2021080307532501024502410704A7306F",
"data": {
"videos": [
{
"item_id": "6990565363377392901",
"create_time": "1627617835",
"caption": "little coco",
"share_url": "https://www.tiktok.com/@feather_in_the_w1nd/video/6990565363377392901?utm_campaign=tt4d_open_api&utm_source=6979330045630218242",
"likes": 10,
"comments": 2,
"shares": 0,
"video_views": 1231
}
],
"cursor": 0,
"has_more": false
}
}Как работает пагинация?
По времени. cursor по умолчанию равен текущему моменту в миллисекундах, поэтому первая страница содержит самые новые посты, а каждый ответ возвращает cursor для следующего запроса. Передавайте его, пока has_more равен true. Пользовательская метка времени выводит посты, опубликованные до этого момента. Правила TikTok в области доверия и безопасности могут сделать страницу короче max_count, даже если постов ещё много.
import json, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
def all_posts(token: str, business_id: str, fields: list[str]):
params = {"business_id": business_id, "fields": json.dumps(fields), "max_count": 20}
while True:
r = requests.get(f"{API}/business/video/list/", headers={"Access-Token": token},
params=params, timeout=30).json()
if r["code"] != 0:
raise RuntimeError(f"{r['code']}: {r['message']}")
yield from r["data"].get("videos", [])
if not r["data"].get("has_more"):
return
params["cursor"] = r["data"]["cursor"]Как получить отдельные посты?
С помощью filters, JSON-объекта: video_ids перечисляет ID постов, которые нужно вернуть, например post_ids из статуса публикации. ad_post_only, который действует только вместе с video_ids, оставляет лишь посты, разрешённые рекламодателям для Spark Ads. Фильтрованный запрос принимает те же поля, что и любой другой, поэтому один вызов может вернуть свежие показатели для нескольких известных постов.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Какие ограничения действуют?
Accounts API разрешает 40 вызовов в минуту на каждый авторизованный аккаунт для этого эндпоинта, а общий лимит вызовов Accounts API для приложения составляет 600 в минуту на базовом уровне и 1 000 на более высоких. Описательные поля обновляются в реальном времени, счётчики обычно отстают на 24–48 часов, а данные поста перестают обновляться через 365 дней после публикации.
Как easyCoexistence получает список видео?
С помощью list_social_posts, который принимает account_id и необязательный limit, от 1 до 20 для TikTok. Он возвращает первую страницу TikTok: самые свежие посты с item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments и shares, а также cursor и has_more. Следующие страницы и другие поля берутся из вашего кода, с токеном и business_id из get_social_credentials:
GET https://business-api.tiktok.com/open_api/v1.3/business/video/list/
?business_id=<BUSINESS_ID>
&fields=["item_id","media_type","caption","embed_url"]
&cursor=1793404800000
&max_count=20
Access-Token: <ACCESS_TOKEN>Распространённые ошибки
- Запрос полей без item_id. В справочнике TikTok сказано, что запрос с несколькими полями без него может завершиться ошибкой.
- Остановка, когда страница приходит неполной. TikTok может вернуть меньше постов, чем max_count, при has_more, равном true, поэтому ориентируйтесь на has_more.
- Сохранение thumbnail_url на будущее. Это временная ссылка, которая истекает в момент, указанный в параметре x-expires, поэтому запрашивайте новую, когда она нужна.
- Поиск приватных постов в списке. Эндпоинт возвращает только публичные посты.
get_social_credentials даёт вашему коду токен для следующих страниц и других полей. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Сколько видео TikTok API может вывести за раз?
До 20 на страницу из /business/video/list/. max_count задаёт размер страницы и по умолчанию равен 10; для следующих постов используйте cursor.
Выводит ли API TikTok и фото-посты?
Да. /business/video/list/ возвращает публичные видео-, фото- и текстовые посты, а media_type отличает VIDEO от PHOTO.
Входят ли в список видео TikTok посты только для рекламы?
Да. /business/video/list/ также возвращает видео «Only show in ads», которые идут как реклама и не появляются в профиле, а is_ad показывает, используется ли пост в рекламе.
Почему пост TikTok не попал в список API?
Эндпоинт выводит публичные посты, а TikTok исключает посты, отфильтрованные за нарушения, например за авторские права на музыку.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на