LinkedIn Company Posts
LinkedIn Company Posts — это публичные обновления, связанные со страницами организаций, с текстом, данными автора публикации, медиа, временем публикации, темами и видимой вовлеченностью. Такие записи помогают отслеживать коммуникации, проверять контент, анализировать медиа и сравнивать выбранные организации и периоды времени.
Возможности LinkedIn Company Posts API
- Страница компании как отправная точкаИспользуйте один или несколько публичных URL LinkedIn вида /company/, чтобы находить публикации, связанные с каждой выбранной страницей организации.
- Контекст автора публикацииВозвращает нормализованный объект author, чтобы связь с компанией не смешивалась с человеком или автором, указанным в отдельной публикации.
- Сигналы контента и медиаКаждая запись объединяет текст публикации, прикрепленные медиа, хештеги, упоминания, время публикации и исходный URL публикации.
- Снимок видимой вовлеченностиПредоставляет доступные лайки, комментарии, репосты и просмотры как счетчики на момент сбора, а не как расчетный охват или бизнес-результаты.
- Необязательные даты для источникаПередает непустые строки start_date и end_date вместе с каждым входным URL, не навязывая собственный формат, порядок, включительность или интерпретацию часового пояса.
Параметры LinkedIn Company Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список публичных URL страниц компаний LinkedIn со схемой http или https. Хост каждого URL должен быть linkedin.com или поддоменом LinkedIn, а путь — начинаться с /company/. |
start_date | Необязательный | Необязательное непустое значение даты для источника, передаваемое с каждым URL. В документации приведен пример YYYY-MM-DD, но сервис не разбирает его формат, включительность или часовой пояс. |
end_date | Необязательный | Необязательное непустое значение даты для источника, передаваемое с каждым URL. Сервис не проверяет его формат и не требует, чтобы оно шло после start_date. |
results_limit | Необязательный | Необязательный целочисленный лимит, применяемый к каждому входному URL отдельно. По умолчанию 100, минимум 1, максимум 2 000. |
Как использовать LinkedIn Company Posts API
Отправьте URL страниц компаний с необязательными датами, затем опрашивайте асинхронную задачу и читайте каждую страницу по курсору.
- Подготовьте публичные URL LinkedIn, пути которых начинаются с /company/.
- Отправьте urls, необязательные строки start_date и end_date и results_limit методом POST на /v1/linkedin/company-posts; сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- Читайте data.results.items и продолжайте с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/linkedin/company-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"],"start_date":"2026-01-01","end_date":"2026-06-30","results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования LinkedIn Company Posts API
- Хронология публичных коммуникаций: Сводите текст публикаций, время публикации, исходные URL и данные авторов в удобные для проверки хронологии выбранных страниц компаний.
- Анализ тем и медиа: Используйте хештеги, упоминания, текст и ссылки на медиа, чтобы изучать повторяющиеся публичные темы и форматы контента в полученной выборке.
- Сопоставимые снимки вовлеченности: Сравнивайте видимые лайки, комментарии, репосты и просмотры возвращенных публикаций при одинаковых датах, лимитах и времени сбора.
- Отбор контента для дальнейшего анализа: Используйте ID публикаций, URL, авторов, текст и счетчики, чтобы отобрать отдельные записи для последующего анализа комментариев или креативов.
Практические советы по LinkedIn Company Posts API
- Проверяйте, что каждое входное значение — полный URL LinkedIn вида /company/, прежде чем отправлять задачу по нескольким страницам.
- Рассматривайте start_date и end_date как строки, определяемые источником; используйте YYYY-MM-DD единообразно, но не рассчитывайте на локальную проверку, включительность или порядок.
- Сохраняйте одинаковые даты, results_limit и время сбора при сравнении нескольких страниц компаний.
- Проверяйте author и URL публикации в каждой записи: связь со страницей компании не гарантирует, что автор публикации — сама компания.
- Убирайте дубли по стабильному id публикации или URL, если пересекающиеся страницы или повторные запуски возвращают одну и ту же публикацию.
- Храните ссылки на медиа с запасом на сбои: публичные файлы могут перенаправлять, истекать или становиться недоступными после сбора.
Связанные API
Помимо LinkedIn Company Posts API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.
- LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
- LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
- LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
- LinkedIn Post Comments API — Собирайте публичные комментарии к известной публикации LinkedIn: текст, контекст автора, метки времени, ID связей и видимое число лайков и ответов.
- LinkedIn Profile Posts API — Находите публичные публикации, связанные с URL профилей LinkedIn: контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.
- LinkedIn Video Transcript API — Превращайте субтитры видео LinkedIn в простой текст по URL публикаций, в которых эти видео размещены.