youtube/
community-post

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

YouTube Community Post API

URL публикации на входе
Полный текст и изображения
Число лайков
0,5 кредита за запрос
Готово
Готово

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

README

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

YouTube Community Post

Публикация в сообществе — это обновление, которое автор размещает на вкладке канала «Публикации»: анонс, вопрос, подборка изображений или ссылка со своим текстом, прикрепленными картинками и числом лайков. Полная запись публикации позволяет архивировать сказанное автором, оценивать, как поклонники восприняли отдельное обновление, и давать контекст комментариям, которые оно собрало.

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

  • Оба формата ссылки на публикациюВставьте ссылку вида youtube.com/post/{post_id} или ссылку с вкладки «Публикации» канала, которая заканчивается на ?lb={post_id}; обе ведут к одной и той же публикации.
  • Полный текст и все изображенияtext содержит весь текст публикации с переносами строк, а media перечисляет каждое прикрепленное изображение, а не только первое.
  • Лайки и канал-авторmetrics.likes_count содержит общее число лайков, а author — ID канала, handle, название и URL.

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

ПараметрыОбязательныйОписание
urlОбязательныйСсылка на публикацию в сообществе: https://www.youtube.com/post/{post_id} или ссылка с вкладки «Публикации» канала с параметром ?lb={post_id}.

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

Отправьте одну ссылку на публикацию и получите запись этой публикации.

  1. Скопируйте ссылку на публикацию в сообществе, например из результатов YouTube Community Posts или из ссылки для отправки.
  2. Отправьте {"url": "https://www.youtube.com/post/Ugkx..."} методом POST на /v1/youtube/community-post.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте единственную публикацию в results.items.
curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

# The result is one post with text, media and metrics.likes_count.

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

  • Архив анонсов авторов: Сохраняйте полный текст и изображения публикаций о запусках, розыгрышах или расписании, чтобы запись осталась даже после последующих правок или удаления.
  • Оценка отдельного обновления: Получайте likes_count для конкретных публикаций, чтобы сравнивать между собой анонсы, опросы и подборки изображений автора.

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

  • Сначала используйте YouTube Community Posts, чтобы получить список недавних публикаций канала, а затем вызывайте этот эндпоинт только для тех, которые нужны полностью.
  • Запустите YouTube Community Post Comments с той же ссылкой, чтобы сопоставить публикацию с ответами аудитории.

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

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

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

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

YouTube Community Post API — FAQ

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

Принимаются ссылки https://www.youtube.com/post/{post_id} и ссылки с вкладки «Публикации» канала с ?lb={post_id}, например https://www.youtube.com/@channel/community?lb=Ugkx...

Отправьте ту же ссылку в YouTube Community Post Comments: этот эндпоинт возвращает каждый комментарий с автором, лайками и числом ответов.

Этот эндпоинт только читает публичные публикации. В официальном YouTube Data API тоже нет ресурса для публикаций в сообществе — ни для чтения, ни для создания.

Каждый запрос стоит фиксированные 0,5 кредита за одну возвращаемую публикацию.