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

YouTube API: Профиль — Описание по идентификатору пользователя

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Общие параметры
Параметр Обязателен Тип Пример Описание
user_identifier Нет str mkbhd YouTube channel handle, username, or channel identifier. Example: mkbhd.

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

V2

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

GET /api/v2/youtube.com/profile/about-by-user-identifier

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

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/profile/about-by-user-identifier" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  # Optional parameters:
  # --data-urlencode 'user_identifier=mkbhd'
Пример ответа

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

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

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

V2 — JSON

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

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

{
  "success": true,
  "status": "ok",
  "search_context": {
    "user_identifier": "mkbhd"
  },
  "data": {
    "channel": {
      "url": "http://www.youtube.com/@mkbhd",
      "created_at": "2008-03-21",
      "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
      "username": "mkbhd",
      "display_name": "Marques Brownlee",
      "rss_url": "https://www.youtube.com/feeds/videos.xml?channel_id=UCBJycsmduvYEL83R_U4JriQ",
      "verified": true,
      "is_family_safe": true,
      "description": "MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n\[email protected]\n\nNYC",
      "keywords": [
        "MKBHD",
        "MarquesBrownlee",
        {
          "_more_items": 1
        }
      ],
      "emails": [
        "[email protected]"
      ],
      "country": "United States",
      "subscriber_count": 21100000,
      "video_count": 1836,
      "view_count": 5486122843,
      "external_links": [
        {
          "url": "http://twitter.com/MKBHD",
          "label": "Twitter",
          "link_type": "twitter"
        },
        {
          "url": "http://instagram.com/MKBHD",
          "label": "Instagram",
          "link_type": "instagram"
        },
        {
          "_more_items": 3
        }
      ],
      "featured_video": {
        "author": {
          "url": "http://www.youtube.com/@mkbhd",
          "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
          "username": "mkbhd",
          "display_name": "Marques Brownlee",
          "verified": true,
          "badges": null,
          "avatar_url": "https://example.com/image.jpg",
          "avatar_urls": "https://example.com/image.jpg"
        },
        "url": "https://www.youtube.com/watch?v=_oRgdlJUD18",
        "video_id": "_oRgdlJUD18",
        "title": "iOS 27 Hands-On: Top 5 New Features!",
        "snippet": "First look at iOS 27 - coming soon to an iPhone near you. It's about time.\n\nMKBHD Merch: http://shop.MKBHD.com\n\nPlaylist of MKBHD Intro music: https://goo.gl/B3AWV5\n\n~\nhttp://tw…",
        "published_time": "5 days ago",
        "duration_seconds": 900,
        "duration_text": "15:00",
        "view_count": 4658820
      },
      "badges": null,
      "avatar_url": "https://example.com/image.jpg",
      "avatar_urls": "https://example.com/image.jpg",
      "banner_url": "https://yt3.googleusercontent.com/zi_48HwHU4s0Hnb6tZuvRzTfCPHrLEnrtIMDLzMauDEyDmURh9JZ4wrNd3lKr7m9uVnT4YjYKw=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
      "banner_images": [
        {
          "url": "https://yt3.googleusercontent.com/zi_48HwHU4s0Hnb6tZuvRzTfCPHrLEnrtIMDLzMauDEyDmURh9JZ4wrNd3lKr7m9uVnT4YjYKw=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 1060,
          "height": 175
        },
        {
          "url": "https://yt3.googleusercontent.com/zi_48HwHU4s0Hnb6tZuvRzTfCPHrLEnrtIMDLzMauDEyDmURh9JZ4wrNd3lKr7m9uVnT4YjYKw=w1138-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
          "width": 1138,
          "height": 188
        },
        {
          "_more_items": 4
        }
      ]
    },
    "featured_channels": [
      {
        "url": "https://www.youtube.com/@TheStudio",
        "channel_id": "UCG7J20LhUeLl6y_Emi7OJrA",
        "username": "TheStudio",
        "display_name": "The Studio",
        "verified": true,
        "subscriber_count": 1120000,
        "video_count": 207,
        "badges": [
          "Verified"
        ],
        "avatar_url": "https://example.com/image.jpg",
        "avatar_urls": "https://example.com/image.jpg"
      },
      {
        "url": "https://www.youtube.com/@AutoFocus",
        "channel_id": "UC2J-0g_nxlwcD9JBK1eTleQ",
        "username": "AutoFocus",
        "display_name": "Auto Focus",
        "verified": true,
        "subscriber_count": 1260000,
        "video_count": 140,
        "badges": [
          "Verified"
        ],
        "avatar_url": "https://example.com/image.jpg",
        "avatar_urls": "https://example.com/image.jpg"
      },
      {
        "_more_items": 4
      }
    ]
  }
}
Что делать дальше

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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