ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Список видео аккаунта 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, ссылкой и счётчиками.

20

Наибольшее число постов, которое /business/video/list/ возвращает на страницу; max_count по умолчанию равен 10.

Milliseconds

Единица измерения cursor: метка времени Unix в UTC. Эндпоинт возвращает посты, опубликованные раньше неё.

item_id

Поле по умолчанию, которое должно входить в запрос с несколькими полями, иначе может возникнуть ошибка.

40/min

Лимит вызовов на каждый авторизованный аккаунт для этого эндпоинта, как и для любого эндпоинта 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:

List the latest posts
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, сокращённый до описательных полей и счётчиков:

A page from /business/video/list/
{
  "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, даже если постов ещё много.

Every page, in Python
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. Фильтрованный запрос принимает те же поля, что и любой другой, поэтому один вызов может вернуть свежие показатели для нескольких известных постов.

The filters parameter
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:

The next page from your own code
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, поэтому запрашивайте новую, когда она нужна.
  • Поиск приватных постов в списке. Эндпоинт возвращает только публичные посты.
Настройка с EasyCoexistence

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 исключает посты, отфильтрованные за нарушения, например за авторские права на музыку.

Читайте дальше

Метрики видео TikTok через API: просмотры, время просмотра и досмотрыМетрики видео в API for Business TikTok: просмотры, охват, время просмотра, досмотры, удержание, источники показов и страны зрителей.Как опубликовать видео в TikTok через APIПубликуйте видео в TikTok через API for Business: эндпоинт публикации, тело JSON, share_id из ответа и проверка статуса в curl и Python.Ответы на комментарии TikTok и модерация через APIКак API TikTok для бизнеса читает и скрывает комментарии, отвечает на них и удаляет свои, а правила по ключевым словам отвечают на новые сами.Демография аудитории TikTok через APIДемография подписчиков из API TikTok: доли по возрасту, полу, стране и городу, почасовая активность и порог в 100 подписчиков.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на