LinkedIn Post Comments
Комментарий к публикации LinkedIn — это публичный отклик, привязанный к одной известной публикации; этот эндпоинт превращает показанные с ней комментарии в отдельные записи с доступным текстом, публичными полями автора, временем публикации и сбора, связями с источником, лайками и числом ответов. Порядок результатов зависит от источника, а видимое число ответов не означает, что тексты ответов включены.
Возможности LinkedIn Post Comments API
- Одна известная публикация как границаПринимает один поддерживаемый URL вида /posts/, /pulse/ или /feed/update/ и обрабатывает публичные комментарии, показанные именно с этой публикацией.
- Нормализованные записи комментариевВозвращает текст комментария с доступными ID, публичным URL, временем публикации, временем сбора и публичными полями автора в стабильной схеме комментария.
- Доступный контекст связейСохраняет parent_id и post_id, если источник их предоставляет, а если нет — оставляет эти объявленные поля null.
- Видимые счетчики откликовХранит likes_count и replies_count как измерения, допускающие null, а не превращает недоступный счетчик в ноль.
Параметры LinkedIn Post Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный URL публичной публикации LinkedIn с путем /posts/, /pulse/ или /feed/update/urn:li:activity либо /feed/update/urn:li:share. |
Как использовать LinkedIn Post Comments API
Отправьте поддерживаемый URL публичной публикации, отслеживайте асинхронную задачу и постранично читайте комментарии, сохраненные для завершенной задачи.
- Выберите один публичный URL LinkedIn, путь которого использует /posts/, /pulse/ или /feed/update/ с URN типа activity или share.
- Отправьте его как url на /v1/linkedin/post-comments и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
- Читайте data.results.items и переходите по next_cursor, пока has_more равно true; этот курсор листает сохраненные результаты SocQ, а не исходную ленту комментариев LinkedIn.
curl -X POST "https://api.socq.ai/v1/linkedin/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/posts/aagupta_what-you-need-to-know-ai-agents-activity-7354600338621906944-RvXR"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования LinkedIn Post Comments API
- Разбор откликов на известную публикацию: Читайте публичный текст комментариев к выбранному анонсу, статье или публикации кампании без широкого поиска по аккаунтам.
- Сортировка вопросов и отзывов: Передавайте полученный текст на ручную проверку вопросов, возражений или отзывов о продукте, сохраняя ссылки на источник и данные автора.
- Снимки публичной вовлеченности: Сравнивайте доступное число лайков и ответов у возвращенных комментариев и привязывайте наблюдение к collected_at.
- Архивы комментариев с привязкой к источнику: Храните нормализованные записи комментариев вместе с переданным URL публикации и доступными post_id или parent_id для последующего аудита и поиска.
Практические советы по LinkedIn Post Comments API
- Убирайте дубли по идентификатору activity или share, прежде чем отправлять повторяющиеся варианты URL одной публикации.
- Не передавайте results_limit, сортировку или поля раскрытия ответов: url — единственное допустимое свойство запроса.
- Считайте порядок результатов зависящим от источника, а не хронологическим или ранжированным по релевантности.
- Отличайте null от нуля для likes_count и replies_count: недоступный счетчик не доказывает отсутствие вовлеченности.
- Не делайте выводов о тональности, намерениях, уровне должности, качестве лидов или автоматизированном поведении только по нормализованным полям.
- Переходите по next_cursor только для чтения всех комментариев, уже сохраненных для завершенной задачи: он не запрашивает у LinkedIn следующую страницу комментариев.
Связанные API
Помимо LinkedIn Post Comments API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.
- LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
- LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
- LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
- LinkedIn Jobs API — Нормализуйте публичные вакансии: должность, компания, описание, местоположение, требования, условия занятости, ссылки для отклика и доступные поля зарплаты.
- LinkedIn Company Jobs API — Находите публичные вакансии по подготовленным URL LinkedIn /jobs/ с нормализованными полями должности, компании, местоположения, занятости, опыта, удаленной работы, зарплаты и сроков.
- LinkedIn Company Posts API — Находите публичные публикации по URL страниц компаний LinkedIn: текст, контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.