User Finder API
← Приложение

HTTP API

Простой JSON-API для получения публичных данных аккаунтов TikTok: профиль, статистика, регион, подписчики и подписки. Ключ не нужен — просто отправляйте GET-запросы.

Базовый URL
ФорматJSON, UTF-8
АвторизацияНе требуется
МетодыТолько GET

Быстрый старт

Один запрос — и вы получаете профиль:


        
Любой ответ с ошибкой имеет вид {"error": "текст"} и соответствующий HTTP-статус.

      


      

        
Ошибки и лимиты

        

          
КодЗначение

          
            
200Успех

            
400Не передан обязательный параметр

            
403Список подписчиков/подписок закрыт или недоступен

            
404Пользователь не найден

            
429Превышен лимит запросов источника. Для подписчиков/подписок в ответе есть retryAfter (секунды)

            
502Источник данных недоступен или вернул ошибку — повторите позже

            
504Источник не ответил вовремя

            
503База данных временно недоступна (эндпоинты /api/db/* и /api/health)

          
        

        
💡 При 429, 502 и 504 безопасно повторить запрос через несколько секунд (лучше с экспоненциальной задержкой).

      


      


      

        
Типичный сценарий

        
    
          
  1. Найдите профиль через /api/lookup — сохраните userId и secUid из ответа.
    2. 
          
  2. Загрузите подписчиков через /api/followers с cursor=0.
    3. 
          
  3. Пока hasMore = true, повторяйте запрос с cursor = nextCursor.
    4. 
          
  4. Всё загруженное сохраняется в базу PostgreSQL на сервере — потом его можно получить без повторных запросов к TikTok через /api/db/edges.
    5.