linkedin/
companies

Получайте публичные страницы компаний LinkedIn по URL вида /company/{slug}: нормализованные данные о компании и ее присутствии в сети, фирмографические данные, местоположения и видимый масштаб.

LinkedIn Companies API

URL компании на входе
Фирмографический контекст
Публичный снимок
2 кредита за результат
Готово
Готово

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

README

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

LinkedIn Companies

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

Возможности LinkedIn Companies API

  • Публичные страницы компаний на входеОбрабатывает один или несколько URL LinkedIn вида /company/{slug}, не смешивая их с личными профилями, публикациями или вакансиями.
  • Данные компании и присутствие в сетиВозвращает публичное название компании, описание, сайт, логотип и URL страницы LinkedIn в одной нормализованной записи.
  • Структурированные атрибуты компанииПредоставляет отрасль, размер компании, штаб-квартиру, год основания, местоположения и специализации в виде полей, готовых к фильтрации и сравнению.
  • Видимое число подписчиков и сотрудниковВозвращает доступное число подписчиков и сотрудников как отдельные метрики вместе с атрибутами компании.

Параметры LinkedIn Companies API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список URL публичных страниц компаний LinkedIn. Каждый URL должен использовать путь /company/{slug} на linkedin.com или поддомене LinkedIn.

Как использовать LinkedIn Companies API

Отправьте уже известные вам страницы компаний, дождитесь завершения задачи сбора и постранично читайте полученные фирмографические записи.

  1. Подготовьте публичные ссылки на компании вида /company/{slug}.
  2. Отправьте список urls методом POST на /v1/linkedin/companies и сохраните task_id.
  3. Отслеживайте задачу через /v1/tasks/{task_id}, пока обработка компаний не завершится успешно или с ошибкой.
  4. Читайте data.results.items и используйте next_cursor для получения следующих страниц результатов.
curl -X POST "https://api.socq.ai/v1/linkedin/companies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/company/microsoft/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования LinkedIn Companies API

  • Обогащение аккаунтов и CRM: Добавляйте описания компаний, сайты, логотипы, отрасли, размер и штаб-квартиру в записи, связанные с известными страницами компаний.
  • Сегментация компаний: Группируйте организации по отрасли, размеру, местоположениям и специализациям для исследований или планирования работы с аккаунтами.
  • Карта рынков и местоположений: Используйте штаб-квартиру и массивы местоположений, чтобы сравнивать, где работают выбранные компании.
  • Мониторинг публичных данных компаний: Сравнивайте сохраненные записи компаний, чтобы выявлять изменения в описаниях, местоположениях, специализациях или видимых показателях масштаба.

Практические советы по LinkedIn Companies API

  • Нормализуйте slug компании и убирайте дубли перед отправкой, чтобы разные формы URL /company/ не создавали повторных записей.
  • Храните отрасли, местоположения и специализации как массивы, чтобы многозначные атрибуты компании оставались целыми.
  • Сохраняйте collected_at с каждой записью при сравнении атрибутов компании или видимых счетчиков во времени.

Помимо LinkedIn Companies API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.

  • LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
  • LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
  • LinkedIn Jobs API — Нормализуйте публичные вакансии: должность, компания, описание, местоположение, требования, условия занятости, ссылки для отклика и доступные поля зарплаты.
  • LinkedIn Company Jobs API — Находите публичные вакансии по подготовленным URL LinkedIn /jobs/ с нормализованными полями должности, компании, местоположения, занятости, опыта, удаленной работы, зарплаты и сроков.
  • LinkedIn Company Posts API — Находите публичные публикации по URL страниц компаний LinkedIn: текст, контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.
  • LinkedIn Post Comments API — Собирайте публичные комментарии к известной публикации LinkedIn: текст, контекст автора, метки времени, ID связей и видимое число лайков и ответов.

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

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

LinkedIn Companies API — FAQ

LinkedIn Companies API получает публичные данные компаний по одному или нескольким допустимым URL вида /company/{slug}. Он возвращает нормализованные название и данные компании, сайт, логотип, отрасль, размер, местоположения, специализации и доступное число подписчиков и сотрудников.

Передавайте полные URL LinkedIn со схемой http или https, путь которых соответствует /company/{slug}. Личные профили, публикации и ссылки на вакансии не являются входными данными страниц компаний.

Нет. employees_count — это видимый показатель числа сотрудников на странице компании в LinkedIn на момент обработки записи, а не гарантированная официальная численность персонала.

Каждый результат — это снимок публичных полей, видимых на момент collected_at. Чтобы получить историю, сохраняйте и сравнивайте снимки из отдельных запусков.

Местоположения, специализации, счетчики и другие необязательные поля могут быть null или пустыми, если публичная страница компании не раскрывает пригодного значения.

Одна возвращенная запись компании расходует 2 кредита SocQ. За завершенные задачи с пустым набором результатов плата за результаты не взимается.