LinkedIn Posts
Публичная публикация в LinkedIn объединяет сообщение автора с медиа, данными о публикации, хештегами, типом контента и видимым числом лайков, комментариев и репостов. Эти сигналы помогают архивировать контент, исследовать темы и форматы и сравнивать публичную вовлеченность выбранных публикаций.
Возможности LinkedIn Posts API
- Поддерживаемые URL публикаций LinkedInОбрабатывает публичные ссылки /posts/ и /pulse/, а также URL /feed/update/ с идентификатором activity или share.
- Текст публикации и данные автораСвязывает публичный текст публикации, исходный URL и нормализованные данные автора в одной записи контента.
- Медиа и данные о публикацииВозвращает доступные ссылки на медиа, время публикации, заголовок, подзаголовок, тип публикации и хештеги, не сливая их с текстом публикации.
- Видимые метрики вовлеченностиВозвращает доступное число лайков, комментариев и репостов как отдельные метрики в каждой записи публикации.
Параметры LinkedIn Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных публикаций LinkedIn с путем /posts/, /pulse/ или поддерживаемым путем /feed/update/urn:li:activity либо /feed/update/urn:li:share. |
Как использовать LinkedIn Posts API
Передайте конкретные публикации, которые нужно сохранить, отслеживайте задачу их обработки и читайте структурированные результаты.
- Убедитесь, что каждая публичная ссылка использует /posts/, /pulse/ или поддерживаемый URN /feed/update/.
- Отправьте ссылки как urls на /v1/linkedin/posts и сохраните task_id.
- Следите за /v1/tasks/{task_id}, пока обработка публикаций не завершится успешно или не вернет ошибку.
- Прочитайте первый набор data.results.items, затем продвигайтесь с next_cursor, пока has_more остается true.
curl -X POST "https://api.socq.ai/v1/linkedin/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/posts/microsoft_were-more-than-a-single-story-at-microsoft-activity-7401349457478569985-pp34"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования LinkedIn Posts API
- Архивирование контента кампаний: Сохраняйте текст публикации, автора, медиа, время публикации и исходный URL для заданного набора публикаций кампании.
- Исследование тем и посылов: Анализируйте текст публикаций, заголовки и хештеги, чтобы сравнивать темы в выбранном контенте LinkedIn.
- Анализ форматов контента: Используйте post_type и поля медиа, чтобы сравнивать форматы в выбранном контенте.
- Сравнение публичной вовлеченности: Сравнивайте видимое число лайков, комментариев и репостов в выбранном наборе сохраненных публикаций.
Практические советы по LinkedIn Posts API
- Храните отправленный URL рядом с возвращенным url, если последующие записи должны оставаться привязанными к исходным входным данным.
- Перед обработкой набора ссылок убирайте дубли по идентификаторам activity или share, а не только по полным строкам URL.
- Считайте медиа, хештеги, заголовок, подзаголовок и тип публикации необязательными: не каждая публичная публикация их раскрывает.
- Храните collected_at вместе с видимыми метриками вовлеченности, потому что у той же публикации в последующих запусках могут быть другие значения.
- Экранируйте или очищайте возвращенный текст публикации, прежде чем выводить его как HTML в последующем приложении.
Связанные API
Помимо LinkedIn Posts API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.
- LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
- LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
- LinkedIn Company Posts API — Находите публичные публикации по URL страниц компаний LinkedIn: текст, контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.
- LinkedIn Post Comments API — Собирайте публичные комментарии к известной публикации LinkedIn: текст, контекст автора, метки времени, ID связей и видимое число лайков и ответов.
- LinkedIn Profile Posts API — Находите публичные публикации, связанные с URL профилей LinkedIn: контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.
- LinkedIn Video Transcript API — Превращайте субтитры видео LinkedIn в простой текст по URL публикаций, в которых эти видео размещены.