linkedin/
company-posts

Находите публичные публикации LinkedIn по URL страниц компаний и получайте текст публикации, данные автора, медиа, хештеги, метки времени и видимую вовлеченность в виде нормализованных записей.

LinkedIn Company Posts API

Поиск по странице компании
Необязательные даты
Записи публичных публикаций
1 кредит за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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 страниц компаний с необязательными датами, затем опрашивайте асинхронную задачу и читайте каждую страницу по курсору.

  1. Подготовьте публичные URL LinkedIn, пути которых начинаются с /company/.
  2. Отправьте urls, необязательные строки start_date и end_date и results_limit методом POST на /v1/linkedin/company-posts; сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. Читайте 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, если пересекающиеся страницы или повторные запуски возвращают одну и ту же публикацию.
  • Храните ссылки на медиа с запасом на сбои: публичные файлы могут перенаправлять, истекать или становиться недоступными после сбора.

Помимо 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 публикаций, в которых эти видео размещены.

Другие платформы

Объединяйте данные LinkedIn с публичными данными других поддерживаемых соцсетей.

LinkedIn Company Posts API — FAQ

LinkedIn Company Posts API — это программный интерфейс для поиска публичных публикаций по URL страниц LinkedIn вида /company/. Он возвращает нормализованные текст, данные автора, медиа, хештеги, упоминания, время публикации и видимую вовлеченность.

Каждое значение должно быть полным URL со схемой http или https на linkedin.com или поддомене LinkedIn, путь которого начинается с /company/. Личные профили вида /in/ и URL отдельных публикаций не проходят проверку URL этого эндпоинта.

Непустые строки start_date и end_date передаются источнику поиска для каждого URL. Сервис не разбирает их формат, не проверяет порядок и не определяет включительность и часовой пояс, поэтому используйте единообразные значения YYYY-MM-DD и интерпретируйте результаты с осторожностью.

Нет. Результат связан с лентой переданной страницы компании, но нормализованный author может указывать на человека, компанию или другого автора; проверяйте author и url, прежде чем определять авторство.

results_limit применяется к каждому URL компании отдельно и принимает целые числа от 1 до 2 000. Поэтому три URL с лимитом 20 могут сохранить до 60 публикаций с учетом публичной доступности и поведения источника.

Это значит, что для этого URL и этих дат в ходе задачи не было возвращено ни одной поддерживаемой публичной публикации. Это не доказывает, что организация никогда ничего не публиковала, и такой результат следует отличать от некорректных входных данных или сбоя задачи.

Каждая возвращенная публикация стоит 1 кредит SocQ, базовой платы нет. За пустой набор результатов плата не взимается, а фактический расход может превысить оценку, если это допускается.