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

Лимиты TikTok API: запросы на аккаунт, приложение и эндпоинт

Лимиты TikTok API for Business действуют сразу на трёх уровнях: 40 запросов в минуту на каждый авторизованный аккаунт на каждом эндпоинте Accounts API, общий бюджет всех эндпоинтов Accounts API на приложение разработчика, 600 в минуту на Basic и 1 000 на более высоких уровнях, а также лимиты приложения на эндпоинт: 10 в секунду, 600 в минуту и 864 000 в день на Basic, с ростом до 50 в секунду на Ultimate.

easyCoexistence публикует посты, читает аналитику и отвечает на комментарии в TikTok для Claude, ChatGPT или вашего кода через TikTok API for Business, возвращает код и сообщение TikTok, когда запрос ограничен, и сопровождает каждый пост до завершения или провала в TikTok.

40 QPM

Запросов в минуту на каждый авторизованный аккаунт TikTok на каждом эндпоинте Accounts API, одна цифра независимо от уровня приложения.

1,000 QPM

Общий бюджет на все эндпоинты Accounts API для приложения разработчика на уровнях Advanced, Premium и Ultimate; на Basic он составляет 600.

50 QPS

Лимит на эндпоинт на уровне Ultimate, самом высоком уровне приложения, вместе с 3 000 запросов в минуту и 4 320 000 в день.

HTTP 200

Статус, который TikTok возвращает вместе с кодами ответа, включая коды 4xxxx, например 40100; только код 0 означает успех.

10 QPS

Лимит частоты запросов для каждого эндпоинта Discovery API на приложение разработчика.

00:00 UTC

Когда сбрасываются дневные лимиты; после минутного лимита TikTok вместо этого просит паузу в 5 минут.

Какие лимиты действуют на запрос к TikTok API?

При каждом запросе к Accounts API одновременно срабатывают до трёх счётчиков, а у некоторых продуктов и действий есть собственные счётчики. TikTok ведёт счётчики эндпоинтов независимо, поэтому один эндпоинт может быть ограничен, в то время как остальные эндпоинты приложения продолжают отвечать:

Per account and endpoint40 queries a minute for each authorized TikTok account on each Accounts API endpoint
Per app, Accounts API combined600 queries a minute at Basic, and 1,000 at Advanced, Premium and Ultimate
Per app and endpointQueries a second, a minute and a day, set by the app's level
PublishingSix posts a minute and 15 a day per account, on the video and on the photo endpoint
Mentions APIThe app's global limits, with TikTok advising one call per endpoint and account a day
Discovery API10 queries a second on each endpoint, per developer app

Что дают четыре уровня приложения?

Все приложения разработчика начинаются с уровня Basic. TikTok повышает приложение на один уровень за раз по запросу, который подаётся в разделе My Apps, App Detail, Authorization, с указанием причины. Каждый уровень задаёт, сколько может получить от приложения один эндпоинт, рядом с общим бюджетом для запросов Accounts API:

Basic10 a second, 600 a minute, 864,000 a day; Accounts API combined: 600 a minute
Advanced20 a second, 1,200 a minute, 1,728,000 a day; Accounts API combined: 1,000 a minute
Premium30 a second, 1,800 a minute, 2,592,000 a day; Accounts API combined: 1,000 a minute
Ultimate50 a second, 3,000 a minute, 4,320,000 a day; Accounts API combined: 1,000 a minute

Поднимает ли более высокий уровень бюджет Accounts API?

Один раз. Переход с Basic на Advanced увеличивает общий бюджет Accounts API с 600 до 1 000 запросов в минуту, и он остаётся на уровне 1 000 вплоть до Premium и Ultimate, тогда как лимиты на эндпоинт в секунду и в день продолжают расти. Лимит 40 запросов в минуту на аккаунт и эндпоинт от уровня не зависит вообще, поэтому загруженный аккаунт ограничивается 40 запросами в минуту на эндпоинт, на каком бы уровне ни находилось приложение.

Как суммируются лимиты при многих аккаунтах?

Лимит аккаунта умножается на каждый аккаунт, а бюджет приложения нет. Десять аккаунтов могут сделать по 40 запросов в минуту к /business/comment/list/, то есть 400 всего, но двадцать, делающие то же самое, потребовали бы 800, что выше 600 запросов в минуту, доступных приложению уровня Basic на все запросы Accounts API вместе, прежде чем учитывается любой другой эндпоинт. На уровнях выше Basic этот общий бюджет достигает 1 000 в минуту.

Что происходит, когда запрос превышает лимит?

TikTok ограничивает этот эндпоинт. Руководство по лимитам называет код 40100 для запроса, получившего ограничение; он приходит в теле ответа HTTP 200, и эндпоинт остаётся закрытым 5 минут после минутного лимита или до сброса дневных счётчиков в 00:00 UTC после дневного, тогда как остальные эндпоинты приложения продолжают отвечать. Распознавание этой ошибки в коде и грамотный повтор запроса описаны в разделе про ошибку 40100.

Являются ли лимиты публикаций ограничениями частоты запросов?

Нет, они считают публикации, а не запросы, и у них есть отдельная страница. TikTok позволяет аккаунту публиковать шесть постов в минуту и 15 в день через /business/video/publish/, а также то же самое через /business/photo/publish/. Пост сверх этого количества завершается ошибкой spam_risk_too_many_posts в статусе публикации, тогда как ограничение частоты запросов отклоняет сам запрос.

Какие привычки быстрее всего расходуют лимиты?

Опрос. Проверка статуса публикации или списка комментариев по таймеру тратит 40 запросов в минуту аккаунта на этот эндпоинт независимо от того, изменилось ли что-то, а вебхуки TikTok существуют, чтобы заменить это: события публикации сообщают о каждом этапе поста, а comment.update сообщает о новом комментарии в течение пяти минут. Чтение страницами по 20 постов или 30 комментариев за запрос и однократное получение упоминаний в день удерживают остальной расход на низком уровне.

Как easyCoexistence обрабатывает ограниченный запрос к TikTok?

Он передаёт ответ TikTok дальше, а не скрывает его. Вызов инструмента, который TikTok ограничивает, например list_social_comments, reply_to_comment или get_tiktok_publish_status, возвращается ИИ как ошибка с кодом 40100 и сообщением TikTok и не повторяется сам по себе. Посты идут другим путём: publish_tiktok_post передаёт каждый пост в очередь easyCoexistence, сразу или на заданное время:

  • Очередь ждёт и повторяет попытку через 5 минут, 30 минут и 2 часа, когда ответ приходит с HTTP 429.
  • TikTok присылает 40100 внутри ответа HTTP 200, поэтому ограниченная публикация в TikTok завершается с сообщением TikTok и ожидает в разделе Needs attention, где её можно запустить кнопкой Retry.
  • 40100 на одной из проверок статуса очереди тоже проваливает пост, хотя TikTok может уже его опубликовать: перед повтором проверьте последние посты аккаунта.
  • Пост, который провалился в фоне, отправляет владельцу письмо не чаще одного раза в 3 часа на каждый канал.

Какие вызовы TikTok делает easyCoexistence для аккаунта?

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

  • /business/get/ примерно каждые 6 часов, чтобы проверить, что аккаунт всё ещё отвечает.
  • Один запрос публикации на пост, затем /business/publish/status/ примерно каждые 20 секунд, пока TikTok не завершит или не провалит пост, но не дольше 2 часов.
  • Если включены правила комментариев или автоматизации, один запрос /business/comment/list/ на каждый новый комментарий верхнего уровня, чтобы прочитать его автора, и один запрос на каждый опубликованный ответ.
  • Инструменты вызываются только тогда, когда ИИ или ваш код запрашивает их, по 20 постов или 30 комментариев за чтение.

Распространённые ошибки

  • Определение ограничения по HTTP-статусу. TikTok отвечает 40100 с HTTP 200, поэтому проверка res.ok или кода 429 его пропускает; читайте код в теле ответа.
  • Повышение уровня приложения ради одного загруженного аккаунта. 40 запросов в минуту на аккаунт и эндпоинт остаются прежними на всех четырёх уровнях, поэтому распределите запросы этого аккаунта во времени.
  • Многократное получение данных Mentions в течение дня. TikTok обновляет их один раз, между полуночью и 7 утра UTC, и рекомендует один запрос на эндпоинт и аккаунт в день.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений, первые 3 дня бесплатно.

Часто задаваемые вопросы

Каков лимит запросов TikTok API на аккаунт?

40 запросов в минуту на каждый эндпоинт Accounts API для каждого авторизованного аккаунта TikTok, в пределах общего бюджета приложения разработчика: 600 в минуту на Basic или 1 000 выше.

Считаются ли лимиты TikTok по эндпоинтам?

Да. В руководстве TikTok сказано, что лимиты эндпоинтов независимы, поэтому достижение лимита одного эндпоинта не останавливает запросы к другому.

Как повысить лимит запросов TikTok API?

Подайте заявку в разделе My Apps, App Detail, Authorization и укажите причину. Уровни повышаются по одному шагу за раз: от Basic к Advanced, затем Premium и Ultimate.

Учитываются ли запросы через easyCoexistence в лимитах TikTok?

Да. Они выполняются от имени подключённого аккаунта с его токеном, поэтому учитываются в его 40 запросах в минуту на эндпоинт, как любой другой запрос для этого аккаунта.

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

Ошибка TikTok 40100: слишком частые запросыОшибка TikTok 40100 означает, что запрос ограничен по частоте. Как найти её в ответе HTTP 200, сколько ждать и как не превышать лимит.Лимиты публикаций TikTok API: сколько постов в деньСколько постов TikTok API публикует с одного аккаунта: шесть в минуту и 15 в день для эндпоинтов видео и фото, и что происходит сверх лимита.Проверка вебхуков TikTok: заголовок подписи и как его проверитьПроверка вебхука TikTok API for Business: заголовок Tiktok-Signature, HMAC-SHA256 от t, точки и тела запроса с секретом приложения, на Node.js.Упоминания в TikTok через API: поиск постов и комментариев с упоминанием аккаунтаTikTok Mentions API: публичные посты и комментарии с упоминанием бизнеса, эндпоинты, область доступа biz.brand.insights, задержки и вебхук.Сбои публикации в TikTok: spam_risk_too_many_posts, picture_size_check_failed и другие причиныЧто означают причины сбоя публикации в TikTok и как их исправить: spam_risk_too_many_posts, picture_size_check_failed, video_pull_failed и другие.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.

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

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

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

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