YouTube Trending Videos
Страницы трендов YouTube для каждой страны выстраивают видео, которые сильнее всего привлекают внимание в категории вроде новостей, игр или спорта, и показывают у каждого место в списке, канал, число просмотров, длительность и сколько времени прошло с публикации. Следя за этими списками, можно понять, какие сюжеты, игры и авторы набирают популярность на рынке и как быстро видео попадает в список или уходит из него.
Возможности YouTube Trending Videos API
- Страницы трендов семи категорийcategory выбирает страницу трендов news, gaming, sports, learning, courses, fashion или shopping, так что каждая задача следит за тем списком, который видят зрители этой категории.
- Любая страна по двухбуквенному кодуregion принимает код вроде US, GB, JP или BR и возвращает версию страницы для этой страны, где в той же категории часто стоят другие видео.
- Место в списке у каждого видеоrank хранит позицию каждого видео начиная с 1 вместе с category и region, поэтому строка остается понятной, даже если свести несколько списков в одну таблицу.
- Канал за каждым трендовым видеоauthor содержит ID канала, название, @handle, ссылку, аватар и значок подтверждения, так что трендовые видео можно сгруппировать по каналам без второго запроса.
- Просмотры, длительность и превьюmetrics.views_count, duration_seconds, thumbnail_url и фрагмент описания в text описывают каждое видео так, как оно выглядит на странице трендов.
Параметры YouTube Trending Videos API
| Параметры | Обязательный | Описание |
|---|---|---|
category | Обязательный | Страница трендов, которую нужно прочитать: news, gaming, sports, learning, courses, fashion или shopping. |
region | Необязательный | Двухбуквенный код страны для страницы трендов, например US, GB или JP. По умолчанию US. |
results_limit | Необязательный | Сколько видео вернуть с начала списка, от 1 до 50. По умолчанию 50. |
Как использовать YouTube Trending Videos API
Выберите категорию и страну, отправьте их в YouTube Trending Videos API и прочитайте список по местам из завершенной задачи.
- Передайте {"category": "news", "region": "US", "results_limit": 50} методом POST на /v1/youtube/trending-videos и запомните task_id.
- Раз в несколько секунд запрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Прочитайте видео в results.items в порядке rank; если results.has_more равно true, передайте results.next_cursor, чтобы загрузить следующую страницу.
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"gaming","region":"GB","results_limit":10}'
# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the ranked videos once status is succeeded.Сценарии использования YouTube Trending Videos API
- Ежедневная сводка трендов по рынку: Каждое утро получайте страницы новостей и спорта для одной страны и передавайте редакции названия, каналы и число просмотров видео, которые набирают популярность, в порядке мест.
- Отслеживание трендов в играх: Следите за страницей gaming в странах, где вы публикуетесь, чтобы замечать набирающие популярность игры, форматы и авторов до того, как планировать видео или кампании.
- Сравнение одной категории по странам: Запустите одну и ту же категорию для нескольких кодов region и сопоставьте списки по ID видео, чтобы увидеть, какие видео выходят за пределы страны, а какие остаются локальными.
- Список каналов для сотрудничества: Собирайте каналы, которые раз за разом попадают на страницу трендов категории, вместе с их @handle и значками подтверждения как стартовый список для партнерств.
Практические советы по YouTube Trending Videos API
- Запускайте одну и ту же категорию и страну в фиксированное время и объединяйте запуски по id; изменение rank показывает, какие видео поднимаются, а какие теряют позиции.
- Читайте published_time_text вместе с collected_at: страница показывает возраст видео текстом, например «15 min ago», поэтому, если нужно примерное время загрузки, вычтите это значение из времени сбора.
- Задайте results_limit равным 10 или 20, если нужна только верхняя часть списка; YouTube Trending Videos API берет плату за каждое возвращенное видео.
- Передайте собранные ID в YouTube Videos API, чтобы получить лайки, комментарии и полное описание, или в YouTube Transcripts API, чтобы прочитать, о чем говорится в каждом трендовом видео.
Связанные API
Помимо YouTube Trending Videos API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
- YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
- YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
- YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
- YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
- YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API