Доступность платформы
- Состояние за 24 ч
- 100%
За последние 30 дней
Доступные возможности
Все действия YouTube: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите видео YouTube по ключевому слову, до 50 за вызов. | $0.56 за 1 000 запросов | Работает стабильно · состояние 100% |
Данные каналаprofile | Получите канал YouTube по его URL. | $0.56 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получите видео канала YouTube по URL канала, до 50 за вызов. | $0.56 за 1 000 запросов | Норма |
Сведения о видеоvideo | Получите название, описание, канал, просмотры, лайки, число комментариев, длительность и дату публикации одного видео YouTube по ссылке на просмотр или ссылке «Поделиться». | $0.56 за 1 000 запросов | Норма |
Комментарииcomments | Читайте комментарии к видео YouTube, до 100 за вызов. | $0.56 за 1 000 запросов | Норма |
Подписчикиfollowers | Проверьте число подписчиков канала YouTube по его хендлу. | $0.56 за 1 000 запросов | Норма |
Расшифровкаtranscript | Получите субтитры видео YouTube в виде полного текста и сегментов с метками времени, с языком дорожки, доступными языками и данными канала. | $0.56 за 1 000 запросов | Норма |
Shortsshorts | Просматривайте Shorts канала YouTube по хендлу, до 100 за вызов. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API YouTube?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите видео YouTube по ключевому слову, до 50 за вызов. Получите канал, описание, просмотры, лайки, комментарии, длительность и дату публикации. | keyword | sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
profileДанные канала Получите канал YouTube по его URL. Вы получите описание, число подписчиков, видео и просмотров, статус верификации, местоположение, аватар, баннер и дату создания. Данные YouTube Analytics и список подписчиков не предоставляются. | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | channel_id · name · url · bio · subscriber_count · video_count · view_count · is_verified · location · avatar_url · banner_url · created_at · platform |
user_postsПосты пользователя Получите видео канала YouTube по URL канала, до 50 за вызов. Вы получите название, описание, просмотры, лайки, комментарии, длительность и дату публикации. Начальная дата задаётся через | url | since, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
videoСведения о видео Получите название, описание, канал, просмотры, лайки, число комментариев, длительность и дату публикации одного видео YouTube по ссылке на просмотр или ссылке «Поделиться». Комментарии и расшифровка доступны через отдельные действия | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
commentsКомментарии Читайте комментарии к видео YouTube, до 100 за вызов. Для каждого комментария возвращаются текст, автор, лайки, число ответов, дата и признак ответа. Сортируйте по новизне или популярности, а начальную дату задавайте через | url | since, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · text · author_name · like_count · reply_count · posted_at · is_reply · reply_to_id · platform |
followersПодписчики Проверьте число подписчиков канала YouTube по его хендлу. Получите число подписок, публикаций, лайков и связей, а также признак точности для округлённых значений. Передайте @handle в | username | channel | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
transcriptРасшифровка Получите субтитры видео YouTube в виде полного текста и сегментов с метками времени, с языком дорожки, доступными языками и данными канала. | url | language | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · url · title · text · segments · language · available_languages · channel_id · channel_name · channel_username · view_count · like_count · comment_count · posted_at · platform |
shortsShorts Просматривайте Shorts канала YouTube по хендлу, до 100 за вызов. Получите название, миниатюру, просмотры, лайки, длительность и дату публикации. Передайте хендл в | username | channel, since, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · title · thumbnail_url · view_count · like_count · duration · posted_at · author_name · author_id · author_url · platform |
Что означают параметры действия search в API YouTube?
Ищите видео YouTube по ключевому слову, до 50 за вызов. Получите канал, описание, просмотры, лайки, комментарии, длительность и дату публикации. sort сортирует по релевантности, новизне, числу просмотров или рейтингу. Результаты неполные, а ранжирование не объясняется.
keywordОбязательный- Поисковый запрос для действия search на YouTube. Если передать его во входные параметры совместимости действия shorts, он трактуется как название канала и не запускает поиск Shorts по всему сайту.
sortНеобязательный- Порядок сортировки в действиях YouTube. Для search допустимы relevance, newest, most_viewed и top_rated. Для видео и Shorts канала допустимы newest, oldest и popular. Для комментариев допустимы newest и popular. В запросе по одному видео этот параметр не фильтрует его содержимое.Допустимые значения:
most_viewednewestrelevancetop_rated
Что означают параметры действия profile в API YouTube?
Получите канал YouTube по его URL. Вы получите описание, число подписчиков, видео и просмотров, статус верификации, местоположение, аватар, баннер и дату создания. Данные YouTube Analytics и список подписчиков не предоставляются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Целевой URL, обязательный для действий YouTube. Для profile и user_posts используйте полные URL каналов, а для video, comments и transcript — конкретные ссылки с watch?v= или ссылки «Поделиться». Метаданные канала формируются на основе опубликованного контента, а действие comments не возвращает публикации из раздела «Сообщество» канала.
Что означают параметры действия user_posts в API YouTube?
Получите видео канала YouTube по URL канала, до 50 за вызов. Вы получите название, описание, просмотры, лайки, комментарии, длительность и дату публикации. Начальная дата задаётся через since, а порядок (новые, старые или популярные) — через sort. Одна выборка может не охватывать весь архив канала.
urlОбязательный- Целевой URL, обязательный для действий YouTube. Для profile и user_posts используйте полные URL каналов, а для video, comments и transcript — конкретные ссылки с watch?v= или ссылки «Поделиться». Метаданные канала формируются на основе опубликованного контента, а действие comments не возвращает публикации из раздела «Сообщество» канала.
sinceНеобязательный- Нижняя граница даты для фильтрации видео и Shorts канала или комментариев. Применяется только к этим спискам.
sortНеобязательный- Порядок сортировки в действиях YouTube. Для search допустимы relevance, newest, most_viewed и top_rated. Для видео и Shorts канала допустимы newest, oldest и popular. Для комментариев допустимы newest и popular. В запросе по одному видео этот параметр не фильтрует его содержимое.Допустимые значения:
newestoldestpopular
Что означают параметры действия video в API YouTube?
Получите название, описание, канал, просмотры, лайки, число комментариев, длительность и дату публикации одного видео YouTube по ссылке на просмотр или ссылке «Поделиться». Комментарии и расшифровка доступны через отдельные действия comments и transcript.
urlОбязательный- Целевой URL, обязательный для действий YouTube. Для profile и user_posts используйте полные URL каналов, а для video, comments и transcript — конкретные ссылки с watch?v= или ссылки «Поделиться». Метаданные канала формируются на основе опубликованного контента, а действие comments не возвращает публикации из раздела «Сообщество» канала.
Что означают параметры действия comments в API YouTube?
Читайте комментарии к видео YouTube, до 100 за вызов. Для каждого комментария возвращаются текст, автор, лайки, число ответов, дата и признак ответа. Сортируйте по новизне или популярности, а начальную дату задавайте через since. Чтобы связать ответы, используйте reply_to_id. Полная ветка не гарантируется.
urlОбязательный- Целевой URL, обязательный для действий YouTube. Для profile и user_posts используйте полные URL каналов, а для video, comments и transcript — конкретные ссылки с watch?v= или ссылки «Поделиться». Метаданные канала формируются на основе опубликованного контента, а действие comments не возвращает публикации из раздела «Сообщество» канала.
sinceНеобязательный- Нижняя граница даты для фильтрации видео и Shorts канала или комментариев. Применяется только к этим спискам.
sortНеобязательный- Порядок сортировки в действиях YouTube. Для search допустимы relevance, newest, most_viewed и top_rated. Для видео и Shorts канала допустимы newest, oldest и popular. Для комментариев допустимы newest и popular. В запросе по одному видео этот параметр не фильтрует его содержимое.Допустимые значения:
newestpopular
Что означают параметры действия followers в API YouTube?
Проверьте число подписчиков канала YouTube по его хендлу. Получите число подписок, публикаций, лайков и связей, а также признак точности для округлённых значений. Передайте @handle в username. Возвращаются суммарные счётчики, а не список подписчиков.
usernameОбязательный- Обязательный для действий followers и shorts псевдоним канала (handle; можно с @ в начале). Действие followers возвращает общее число подписчиков, а не списки пользователей. Действие shorts отдаёт приоритет псевдонимам и не считает ID каналов вида UC... равнозначными им.YouTube: что такое псевдоним канала — YouTube определяет псевдоним как уникальный идентификатор канала, начинающийся с @; он отличается от отображаемого названия канала. · Проверено
channelНеобязательный- Параметр-синоним для совместимости, задающий псевдоним канала. Полные URL вида /channel/UC... могут не разбираться вспомогательными утилитами, поэтому лучше передавайте псевдоним или используйте параметр URL, явно предусмотренный действием.
Что означают параметры действия transcript в API YouTube?
Получите субтитры видео YouTube в виде полного текста и сегментов с метками времени, с языком дорожки, доступными языками и данными канала. language запрашивает дорожку, но субтитры есть не у каждого видео, а автоматический перевод не гарантируется.
urlОбязательный- Целевой URL, обязательный для действий YouTube. Для profile и user_posts используйте полные URL каналов, а для video, comments и transcript — конкретные ссылки с watch?v= или ссылки «Поделиться». Метаданные канала формируются на основе опубликованного контента, а действие comments не возвращает публикации из раздела «Сообщество» канала.
languageНеобязательный- Код языка для текста транскрипта. Субтитры возвращаются в зависимости от доступных дорожек; автоматический перевод не гарантируется.
Что означают параметры действия shorts в API YouTube?
Просматривайте Shorts канала YouTube по хендлу, до 100 за вызов. Получите название, миниатюру, просмотры, лайки, длительность и дату публикации. Передайте хендл в username, а не ID канала вида UC. Одна выборка может включать не все Shorts канала.
usernameОбязательный- Обязательный для действий followers и shorts псевдоним канала (handle; можно с @ в начале). Действие followers возвращает общее число подписчиков, а не списки пользователей. Действие shorts отдаёт приоритет псевдонимам и не считает ID каналов вида UC... равнозначными им.YouTube: что такое псевдоним канала — YouTube определяет псевдоним как уникальный идентификатор канала, начинающийся с @; он отличается от отображаемого названия канала. · Проверено
channelНеобязательный- Параметр-синоним для совместимости, задающий псевдоним канала. Полные URL вида /channel/UC... могут не разбираться вспомогательными утилитами, поэтому лучше передавайте псевдоним или используйте параметр URL, явно предусмотренный действием.
sinceНеобязательный- Нижняя граница даты для фильтрации видео и Shorts канала или комментариев. Применяется только к этим спискам.
sortНеобязательный- Порядок сортировки в действиях YouTube. Для search допустимы relevance, newest, most_viewed и top_rated. Для видео и Shorts канала допустимы newest, oldest и popular. Для комментариев допустимы newest и popular. В запросе по одному видео этот параметр не фильтрует его содержимое.Допустимые значения:
newestoldestpopular
Как использовать API YouTube
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"youtube","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API YouTube
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Почему при парсинге комментариев YouTube теряются ответы: двухуровневая пагинация и проверка полноты
commentThreads в YouTube не всегда содержат все ответы. На основе официальной документации разбираем comments.list, parentId, двухуровневую пагинацию, дедупликацию и расхождения в числе комментариев и предлагаем воспроизводимый метод приёмки загруженных данных.
Читать статьюКак структурировать данные об авторах для проверки перед кампанией: почему число подписчиков не доказывает наличие аудитории
Продукты на данных об авторах не должны выдавать непрозрачные оценки подлинности. В статье разбираем, как публичные метрики, авторизованная аналитика, соответствие контента бренду, требования к раскрытию сотрудничества, небольшие тесты и обратная связь после кампании позволяют проводить проверку перед запуском с опорой на проверяемые данные.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API YouTube
Какие данные можно получить через API YouTube?
Укажите в platform значение youtube. В текущем каталоге: поиск, данные канала, посты пользователя, сведения о видео, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям YouTube; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе YouTube?
Поисковый запрос для действия search на YouTube. Если передать его во входные параметры совместимости действия shorts, он трактуется как название канала и не запускает поиск Shorts по всему сайту. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе YouTube?
Объявленная схема включает title, text, author_name и author_username. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия YouTube возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.