Инструкция по TikTok API

TikTok API: Профиль — Видео по user UID

Получайте подробные публичные данные по сущности «Профиль» из TikTok по известному идентификатору для карточек, проверки и обогащения.

Операция «Видео по user UID» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.

Метод GET
Сущность Профиль
Версии 2
Что делает этот эндпоинт

Что можно сделать с этим API-методом

Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.

Результат запроса

Ответ содержит доступные поля объекта «Профиль» в нормализованной V2 или исходной V1 структуре.

Когда использовать

Операция «Видео по user UID» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.

Типовые сценарии использования

Обогащение карточек

Добавляйте публичные поля TikTok к уже известным объектам продукта.

Проверка данных

Сверяйте идентификаторы и актуальный публичный контекст перед дальнейшей обработкой.

Подготовка аналитики

Используйте детали объекта как основу для отчётов, скоринга и связанных запросов.

Доступные версии

Версия ответа

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

Версия ответа V2

Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.

Что остается одинаковым

Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.

Что меняется между версиями

Главное отличие — envelope ответа. Для новых интеграций лучше использовать V2, а V1 оставлять только для совместимости с уже существующей клиентской интеграцией.

Как использовать

Как вызвать метод

Для обеих версий используется один заголовок API-ключа и одинаковые параметры строки запроса. Ниже сначала показаны общие параметры, затем путь и примеры кода для выбранной версии.

Входные параметры

Общие параметры
Параметр Обязателен Тип Пример Описание
user_uid Да str value TikTok secUid/user UID returned by the profile endpoint. Example: MS4wLjABAAAAexampleSecUid.
cursor Нет str | None QVFB... Курсор следующей страницы из предыдущего ответа. Не передавайте его для первой страницы.

Путь запроса для выбранной версии

V2

Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.

GET /api/v2/tiktok.com/profile/videos-by-user-uid

Нормализованный формат

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/tiktok.com/profile/videos-by-user-uid" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_uid=value' \
  # Optional parameters:
  # --data-urlencode 'cursor=QVFB...'
Пример ответа

Пример ответа по версиям

Пример сокращён до ключевых полей и первых элементов коллекций, чтобы структуру ответа можно было быстро оценить. Переключатель версии меняет формат JSON.

Пример ответа

V2 — JSON

Проверенный пример

Компактный JSON-пример сформирован из последней успешной проверки версии V2.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "1782831391000",
    "has_more": true
  },
  "search_context": {
    "user_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"
  },
  "data": {
    "videos": {
      "count": 16,
      "items": [
        {
          "url": "https://www.tiktok.com/@tiktok/video/7664308035648638238",
          "created_at": "2026-07-19T18:29:51Z",
          "media_id": "7664308035648638238",
          "description": "football history meets timeless fashion when you’re inside @Classic Football Shirts ⚽ who made the best case?",
          "hashtags": [],
          "emails": [],
          "duration_seconds": 62,
          "author": {
            "url": "https://www.tiktok.com/@tiktok",
            "user_id": "107955",
            "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
            "username": "tiktok",
            "display_name": "TikTok",
            "description": "One TikTok can make a big impact",
            "follower_count": 94900000,
            "following_count": 0,
            "friend_count": 0,
            "like_count": 461900000,
            "video_count": 1479,
            "digg_count": 4109,
            "is_verified": true,
            "is_private": false,
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "music": {
            "music_id": "7664308012118575903",
            "title": "original sound",
            "author": "TikTok",
            "duration_seconds": 62,
            "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=bfa0414a&x-expires=17846…",
            "play_url": "https://v77.tiktokcdn.com/350f866d0dddd59acc44b8b1349a99b8/6a5e9362/video/tos/maliva/tos-maliva-ve-27dcd7c799-us/o06OIniUsRqQSUvdiPBBMvLyEZ1AFAlKMoiRf5/?a=1180&bti=ODszNWYuMDE6&…",
            "is_original": true
          },
          "play_count": 11300,
          "like_count": 183,
          "comment_count": 69,
          "share_count": 10,
          "collect_count": 13,
          "is_ad": false,
          "is_private": false,
          "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oQEi5AaXW3xAA51NFHEARJvlBAd6inBBF3l0I~tplv-tiktokx-origin.image?dr=14575&x-expires=1784667600&x-signature=d6F5tEfMM%…",
          "dynamic_cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oQEi5AaXW3xAA51NFHEARJvlBAd6inBBF3l0I~tplv-tiktokx-origin.image?dr=14575&x-expires=1784667600&x-signature=d6F5tEfMM%…",
          "play_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oc7BiAxIoC98QhrdIQH7ifFNqFLn1EA38i6IAX/?a=1988&bti=ODszNWYuMDE6&&bt=1046&ft=-Csk_mH1PD12Np.o.n-Uxt1vGY…"
        },
        {
          "url": "https://www.tiktok.com/@tiktok/video/7664238499188591902",
          "created_at": "2026-07-19T14:00:21Z",
          "media_id": "7664238499188591902",
          "description": "🏆 Taste the game before it kicks off. 🌍 Discover the story behind every bite as @Mei brings Spain 🇪🇸 and Argentina 🇦🇷 together in one final Matchup Menu. 🍽️⚽",
          "hashtags": [],
          "emails": [],
          "duration_seconds": 65,
          "author": {
            "url": "https://www.tiktok.com/@tiktok",
            "user_id": "107955",
            "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
            "username": "tiktok",
            "display_name": "TikTok",
            "description": "One TikTok can make a big impact",
            "follower_count": 94900000,
            "following_count": 0,
            "friend_count": 0,
            "like_count": 461900000,
            "video_count": 1479,
            "digg_count": 4109,
            "is_verified": true,
            "is_private": false,
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "music": {
            "music_id": "7664238607221885726",
            "title": "original sound",
            "author": "TikTok",
            "duration_seconds": 65,
            "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=bfa0414a&x-expires=17846…",
            "play_url": "https://v77.tiktokcdn.com/77a7785f5d74f9353ea1f618a88397bd/6a5e9365/video/tos/maliva/tos-maliva-ve-27dcd7c799-us/ogycEm0s1Iq8KCi22ALim1wiMkBP8uB57AfAHx/?a=1180&bti=ODszNWYuMDE6&…",
            "is_original": true
          },
          "play_count": 27800,
          "like_count": 909,
          "comment_count": 143,
          "share_count": 37,
          "collect_count": 199,
          "is_ad": false,
          "is_private": false,
          "cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oc5lWcIodiBRYHApBDA2SzSlE3iBDZNAAaAPE~tplv-tiktokx-origin.image?dr=14575&x-expires=1784667600&x-signature=GUPSGH%2FN…",
          "dynamic_cover_url": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oc5lWcIodiBRYHApBDA2SzSlE3iBDZNAAaAPE~tplv-tiktokx-origin.image?dr=14575&x-expires=1784667600&x-signature=GUPSGH%2FN…",
          "play_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oIAlIJB2LhmfvLO3c5nrqrHiQKxiIC1aiEAAJr/?a=1988&bti=ODszNWYuMDE6&&bt=1400&ft=-Csk_mH1PD12Np.o.n-Uxt1vGY…"
        },
        {
          "_more_items": 14
        }
      ]
    }
  }
}
Что делать дальше

Продолжить оценку API-метода

Используйте инструкцию как первую точку принятия решения, а затем переходите к покрытию, стоимости и общим правилам интеграции перед запуском API-метода.

Открыть страницу TikTok API

Сравните соседние сущности, группы API-методов и связанные инструкции перед внедрением.

Открыть страницу платформы

Сравнить стоимость API-методов

Посмотрите, где этот API-метод находится в публичной таблице цен, прежде чем масштабировать использование.

Открыть тарифы

Проверить правила интеграции

Откройте стартовую документацию, чтобы быстро проверить аутентификацию, версионирование, повторы запросов и различия между тестовым и рабочим API.

Открыть документацию
FAQ

Вопросы, которые команды задают до внедрения

Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.

Какие данные возвращает этот метод TikTok API?

Метод выполняет операцию «Видео по user UID» для сущности «Профиль». Точный набор полей показан в компактном примере ответа ниже.

Какую версию ответа выбрать: V1 или V2?

Для новой интеграции выбирайте V2 с нормализованной структурой. V1 нужен только для совместимости с клиентами, которые уже используют исходный формат платформы.

Что нужно для первого запроса?

Создайте API-ключ, передайте его в заголовке и заполните обязательные параметры из таблицы. Готовые примеры кода уже содержат правильный путь и структуру запроса.