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

YouTube API: Видео — Связанные видео по ID

Получайте данные по сущности «Видео» из YouTube через точечную операцию «Связанные видео по ID» и подключайте результат к продуктовым процессам.

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

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

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

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

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

Ответ содержит публичные данные «Видео» и служебный контекст, необходимый для последующих API-запросов.

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

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

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

Точечное получение данных

Запрашивайте только нужный объект без загрузки более тяжёлых коллекций.

Обогащение продукта

Добавляйте результат YouTube API в карточки, процессы и внутренние инструменты.

Оркестрация запросов

Используйте ответ как вход для соседних методов и многошаговых сценариев.

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

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

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

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

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

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

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

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

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

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

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

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

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

Общие параметры
Параметр Обязателен Тип Пример Описание
cursor Нет str | None QVFB... Курсор следующей страницы из предыдущего ответа. Не передавайте его для первой страницы.
video_id Нет str 5aS-8QCRdGE ID видео на выбранной платформе.

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

V2

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

GET /api/v2/youtube.com/videos/related-by-video-id

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

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/videos/related-by-video-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  # Optional parameters:
  # --data-urlencode 'cursor=QVFB...'
  # --data-urlencode 'video_id=5aS-8QCRdGE'
Пример ответа

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

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

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

V2 — JSON

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

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

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "video_id": "5aS-8QCRdGE"
  },
  "data": {
    "videos": {
      "count": 20,
      "items": [
        {
          "author": {
            "url": "https://www.youtube.com/@Mrwhosetheboss",
            "channel_id": "UCMiJRAwDNSNzuYeN2uWa0pA",
            "username": "Mrwhosetheboss",
            "display_name": "Mrwhosetheboss"
          },
          "url": "https://www.youtube.com/watch?v=vlEOOtiaUu8",
          "video_id": "vlEOOtiaUu8",
          "title": "I tested phones that shouldn’t EXIST",
          "published_time": "8 days ago",
          "duration_seconds": 1347,
          "duration_text": "22:27",
          "view_count": 4200000,
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/vlEOOtiaUu8/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDzeROxp42rb0xFoS2ZNoGmDJq_dg",
              "width": 168,
              "height": 94
            },
            {
              "url": "https://i.ytimg.com/vi/vlEOOtiaUu8/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBKtNrr9rQhY8Qc8jzKpcu7NeaG9Q",
              "width": 336,
              "height": 188
            },
            {
              "_more_items": 1
            }
          ]
        },
        {
          "author": {
            "url": "https://www.youtube.com/@GamersNexus",
            "channel_id": "UChIs72whgZI9w6d6FhwGGHA",
            "username": "GamersNexus",
            "display_name": "Gamers Nexus"
          },
          "url": "https://www.youtube.com/watch?v=Q9uefFYe6bM",
          "video_id": "Q9uefFYe6bM",
          "title": "DO NOT BUY: LG’s Spyware TVs, Monitors, and Wiretapping Concerns",
          "published_time": "2 days ago",
          "duration_seconds": 1798,
          "duration_text": "29:58",
          "view_count": 769000,
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/Q9uefFYe6bM/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLAQRD78wan9kiT7cE8WnIpea_OrmA",
              "width": 168,
              "height": 94
            },
            {
              "url": "https://i.ytimg.com/vi/Q9uefFYe6bM/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAp3WFhRnSxAKkEuzxGG8vNyv9qyg",
              "width": 336,
              "height": 188
            },
            {
              "_more_items": 1
            }
          ]
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}
Что делать дальше

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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