YouTube Playlist Videos
Видео плейлиста YouTube — это элементы, сгруппированные в публичном плейлисте, с идентификаторами видео, названиями, контекстом канала, превью, длительностью и сведениями о плейлисте-источнике. Такие записи помогают каталогизировать плейлисты, индексировать серии, проверять контент и обогащать ссылки на видео.
Возможности YouTube Playlist Videos API
- URL и ID нескольких плейлистов на входеОбрабатывает в одной задаче один или несколько URL публичных плейлистов или ID плейлистов, применяя results_limit отдельно к каждому найденному плейлисту.
- Нормализованные строки каталога видеоВозвращает ID видео, названия, канонические URL, данные канала, одно превью, длительность в секундах и время сбора в единой структуре.
- Сведения о плейлисте и его владельцеСохраняет ID и название плейлиста, читаемую длительность и контекст владельца плейлиста, если в строке видео нет собственных полей канала.
Параметры YouTube Playlist Videos API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Один или несколько URL публичных плейлистов с параметром list или ID плейлистов, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число записей, сохраняемых из возвращенного массива видео каждого плейлиста; по умолчанию 100, допустимы целые числа от 10 до 2 000. |
Как использовать YouTube Playlist Videos API
Отправьте известные ссылки на публичные плейлисты как асинхронную задачу, затем после ее успешного завершения листайте сохраненные нормализованные строки видео.
- Подготовьте один или несколько URL публичных плейлистов с параметром list или ID плейлистов и удалите повторяющиеся ссылки.
- Отправьте urls и необязательный results_limit от 10 до 2 000 методом POST на /v1/youtube/playlist-videos, затем сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока статус задачи не станет succeeded или failed.
- Читайте data.results.items и продолжайте с results.next_cursor, пока results.has_more равно true; сверяйте ID плейлистов и ID видео со своим исходным набором.
curl -X POST "https://api.socq.ai/v1/youtube/playlist-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/playlist?list=PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования YouTube Playlist Videos API
- Каталоги публичных плейлистов: Составляйте структурированный каталог ID видео, названий, URL, данных канала, превью, длительности и сведений о плейлисте-источнике для выбранных публичных плейлистов.
- Индексация курсов и серий: Индексируйте названия плейлистов вместе с названиями видео, контекстом канала, длительностью и исходными ссылками, чтобы упорядочить публичные курсы, доклады или серийные подборки.
- Исходные списки для обогащения видео: Используйте возвращенные канонические URL и ID видео как очередь без дублей для отдельных процессов получения деталей, расшифровок, проверки или архивирования.
Практические советы по YouTube Playlist Videos API
- Используйте либо ID плейлиста, либо URL с заполненным параметром list; остальные части URL не используются для определения плейлиста, а URL без list пропускается.
- Считайте results_limit верхней границей для каждого плейлиста в пределах первого возвращенного массива видео, а не гарантией глубокого извлечения большого плейлиста.
- Приводите каждый плейлист к одному представлению перед формированием пакета: удаляются только полностью совпадающие строки, а разные варианты URL одного плейлиста могут вызвать повторную работу.
- Сравнивайте возвращенные extra.playlist_id и id видео со своим входным набором: приватные, удаленные, ограниченные, скрытые, некорректные или недоступные элементы могут отсутствовать.
- Используйте collected_at для отслеживания происхождения записей и запрашивайте подробные данные видео отдельно, если нужны даты публикации или вовлеченность: metrics пуст, а created_at равно null.
Связанные API
Помимо YouTube Playlist Videos API, используйте эти API, когда нужен другой тип публичных данных YouTube.
- YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
- YouTube Comments API — Собирайте публичные комментарии, авторов, вовлеченность, исходные видео и контекст обсуждения.
- YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
- YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
- YouTube Shorts API — Собирайте публичные Shorts, превью, длительность, данные о публикации и вовлеченность по каналу.
- YouTube Channel Live Videos API — Собирайте публичные записи трансляций из разделов прямых эфиров канала с контекстом источника и видимыми метриками.
- YouTube Channels API
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search 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
- YouTube Trending Videos API