youtube/
community-posts

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

YouTube Community Posts API

Вкладка «Сообщество»
URL канала на входе
Ссылки на изображения
0,5 кредита за результат
Готово
Готово

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

README

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

YouTube Community Posts

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

Возможности YouTube Community Posts API

  • Сбор по URL нескольких каналовПринимает полные URL публичных каналов с путями @handle, /channel/, /c/ или /user/ и применяет выбранный лимит результатов к каждому каналу независимо.
  • Нормализованные записи публикацийВозвращает ID публичных публикаций, URL в сообществе, текст, время публикации и время сбора в единой структуре.
  • Связь публикации с каналомСвязывает каждую публикацию с ID канала, handle, отображаемым именем, публичным URL канала и переданным исходным URL.
  • Ссылки на прикрепленные изображенияПереносит доступные изображения публикаций в нормализованные записи медиа, чтобы обновления с изображениями оставались связаны со своими публикациями.
  • Ограниченный обход лентыПроходит по страницам продолжения источника для каждого канала, удаляет дубли публикаций по ID или URL и останавливается на выбранном лимите, в конце ленты или на пределе в 100 страниц.

Параметры YouTube Community Posts API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательные URL публичных каналов YouTube, разделенные запятыми или переводами строки. Поддерживаются пути, начинающиеся с @handle, /channel/, /c/ или /user/.
results_limitНеобязательныйМаксимальное число публикаций в сообществе, собираемых для каждого входного канала. По умолчанию 100, допустимы целые числа от 20 до 2000.

Как использовать YouTube Community Posts API

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

  1. Подготовьте полные URL публичных каналов YouTube с путем @handle, /channel/, /c/ или /user/.
  2. Отправьте urls и results_limit от 20 до 2000 методом POST на /v1/youtube/community-posts.
  3. Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying.
  4. После успешного завершения читайте data.results.items и передавайте data.results.next_cursor как cursor в запросе задачи, пока data.results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/youtube/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

Сценарии использования YouTube Community Posts API

  • Каталог ленты сообщества канала: Используйте ID публикаций, URL, текст, временные метки и контекст исходного канала, чтобы собрать удобную для проверки ленту выбранных публичных каналов.
  • Проверка анонсов и креативов: Изучайте публичный текст публикаций вместе с сохраненными ссылками на изображения, чтобы сравнить, как каналы подают обновления вне своих видеолент.
  • Сравнение публикаций разных каналов: Группируйте нормализованные публикации по данным канала и времени публикации, чтобы сравнить активность в сообществе внутри известного набора каналов.

Практические советы по YouTube Community Posts API

  • Передавайте полный URL канала на поддерживаемом хосте YouTube; видео, публикации, плейлисты и значения, не являющиеся URL, не проходят проверку входных данных канала.
  • Продумывайте размер запросов с несколькими каналами: results_limit применяется к каждому URL, поэтому три канала с лимитом 20 могут запросить до 60 сохраненных публикаций.
  • Считайте results_limit верхней границей: канал без публичной вкладки «Сообщество» или с более короткой видимой лентой может вернуть меньше записей.
  • Используйте cursor только с GET /v1/tasks/{task_id}; продолжение у источника обрабатывается внутри и не является публичным параметром запроса этого эндпоинта.
  • Удаляйте дубли сохраненных записей по ID публикации, а при его отсутствии — по URL, и сохраняйте extra.input_url, если объединяете несколько переданных каналов.
  • Проверяйте text, media и created_at перед дальнейшим использованием; текущие нормализованные записи не сохраняют варианты опросов и метаданные встроенных видео.

Помимо YouTube Community Posts API, используйте эти API, когда нужен другой тип публичных данных YouTube.

  • YouTube Channel Videos API — Собирайте обычные публичные видео по URL каналов без Shorts и прямых трансляций.
  • YouTube Transcripts API — Получайте доступные текстовые расшифровки с необязательным выбором языка.
  • YouTube Channels API — Получайте публичные данные канала, изображения, верификацию и видимую статистику аудитории.
  • YouTube Videos API — Получайте метаданные, превью, длительность и вовлеченность по известным URL видео или Shorts.
  • YouTube Community Post API — Получайте по ссылке одну публикацию в сообществе: полный текст, прикрепленные изображения, лайки и канал автора.
  • YouTube Community Post Comments API — Собирайте комментарии к публикации в сообществе по ее ссылке: каналы комментаторов, число лайков и ответов.

Другие платформы

Объединяйте данные YouTube с публичными данными других поддерживаемых соцсетей.

YouTube Community Posts API — FAQ

YouTube Community Posts API — это программный интерфейс для сбора публичных публикаций с вкладки «Сообщество» по поддерживаемым URL каналов YouTube. Он возвращает ID публикаций, URL, текст, данные канала, временные метки, ссылки на изображения и контекст исходного канала.

Используйте полные URL каналов youtube.com, первый сегмент пути которых — @handle, /channel/, /c/ или /user/. URL видео, публикаций, плейлистов и посторонних хостов не принимаются как входные данные канала.

По умолчанию results_limit равен 100, принимает целые числа от 20 до 2000 и применяется отдельно к каждому переданному URL канала. Поэтому два канала с лимитом 100 могут запросить до 200 сохраненных записей публикаций.

Запись может содержать ID и URL публикации, публичный текст, ID канала, handle, имя и URL канала, нормализованные поля счетчиков, сохраненные ссылки на изображения, время публикации и сбора, а также extra.input_url.

Доступные изображения могут сохраняться как нормализованные ссылки на медиа. Текущая схема ответа не сохраняет варианты опросов, процент голосов и сведения о встроенных видео.

Нет. Он возвращает сами публичные записи публикаций в сообществе и не раскрывает ветки комментариев под ними.

У канала может не быть публичной вкладки «Сообщество», видимая лента может закончиться раньше results_limit, а публикации могут быть удалены, доступны только участникам, приватны или требовать входа.

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

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