youtube/
playlist-videos

Собирайте нормализованные видео по URL или ID публичных плейлистов YouTube: названия, контекст канала, превью, длительность и происхождение из плейлиста для каждой записи.

YouTube Playlist Videos API

Состав плейлистов
URL или ID
Происхождение из плейлиста
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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

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

  1. Подготовьте один или несколько URL публичных плейлистов с параметром list или ID плейлистов и удалите повторяющиеся ссылки.
  2. Отправьте urls и необязательный results_limit от 10 до 2 000 методом POST на /v1/youtube/playlist-videos, затем сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока статус задачи не станет succeeded или failed.
  4. Читайте 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.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

YouTube Playlist Videos API — FAQ

YouTube Playlist Videos API — это программный интерфейс для сбора нормализованных строк видео по URL публичных плейлистов YouTube или ID плейлистов. Он возвращает идентификаторы видео, названия, канонические URL, контекст канала, превью, длительность, сведения о плейлисте-источнике и время сбора.

Передайте непустой массив urls с URL плейлистов, содержащими параметр list, или ID плейлистов. results_limit необязателен, по умолчанию равен 100, принимает значения от 10 до 2 000 и применяется отдельно к каждому плейлисту.

Каждая запись может содержать ID видео, название, канонический URL, ID, handle, имя и URL канала, одно превью, длительность в секундах, время сбора, ID и название плейлиста, а также читаемую длительность. Нормализованный объект metrics пуст, а created_at равно null.

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

Нет. Лимит ограничивает число видео, сохраняемых из одного возвращенного массива видео на плейлист; текущий сборщик не запрашивает страницы продолжения у источника.

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

Каждая возвращенная нормализованная запись видео стоит 0,5 кредита, базовой платы нет. По текущей политике пустых результатов за пустые результаты плата за результат не взимается.