Лимиты 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.
Запросов в минуту на каждый авторизованный аккаунт TikTok на каждом эндпоинте Accounts API, одна цифра независимо от уровня приложения.
Общий бюджет на все эндпоинты Accounts API для приложения разработчика на уровнях Advanced, Premium и Ultimate; на Basic он составляет 600.
Лимит на эндпоинт на уровне Ultimate, самом высоком уровне приложения, вместе с 3 000 запросов в минуту и 4 320 000 в день.
Статус, который TikTok возвращает вместе с кодами ответа, включая коды 4xxxx, например 40100; только код 0 означает успех.
Лимит частоты запросов для каждого эндпоинта Discovery API на приложение разработчика.
Когда сбрасываются дневные лимиты; после минутного лимита TikTok вместо этого просит паузу в 5 минут.
Какие лимиты действуют на запрос к TikTok API?
При каждом запросе к Accounts API одновременно срабатывают до трёх счётчиков, а у некоторых продуктов и действий есть собственные счётчики. TikTok ведёт счётчики эндпоинтов независимо, поэтому один эндпоинт может быть ограничен, в то время как остальные эндпоинты приложения продолжают отвечать:
Что дают четыре уровня приложения?
Все приложения разработчика начинаются с уровня Basic. TikTok повышает приложение на один уровень за раз по запросу, который подаётся в разделе My Apps, App Detail, Authorization, с указанием причины. Каждый уровень задаёт, сколько может получить от приложения один эндпоинт, рядом с общим бюджетом для запросов Accounts API:
Поднимает ли более высокий уровень бюджет 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, и рекомендует один запрос на эндпоинт и аккаунт в день.
От 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 запросах в минуту на эндпоинт, как любой другой запрос для этого аккаунта.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на