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
Отправьте одну ссылку на публикацию и получите запись этой публикации.
- Скопируйте ссылку на публикацию в сообществе, например из результатов YouTube Community Posts или из ссылки для отправки.
- Отправьте {"url": "https://www.youtube.com/post/Ugkx..."} методом POST на /v1/youtube/community-post.
- Опрашивайте 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 с той же ссылкой, чтобы сопоставить публикацию с ответами аудитории.
Связанные API
Помимо 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 Comments API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts 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