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
Отправьте один или несколько известных публичных каналов как асинхронную задачу, затем после завершения читайте сохраненные записи публикаций в сообществе.
- Подготовьте полные URL публичных каналов YouTube с путем @handle, /channel/, /c/ или /user/.
- Отправьте urls и results_limit от 20 до 2000 методом POST на /v1/youtube/community-posts.
- Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying.
- После успешного завершения читайте 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 перед дальнейшим использованием; текущие нормализованные записи не сохраняют варианты опросов и метаданные встроенных видео.
Связанные API
Помимо 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 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