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
Отправьте уже известные вам страницы компаний, дождитесь завершения задачи сбора и постранично читайте полученные фирмографические записи.
- Подготовьте публичные ссылки на компании вида /company/{slug}.
- Отправьте список urls методом POST на /v1/linkedin/companies и сохраните task_id.
- Отслеживайте задачу через /v1/tasks/{task_id}, пока обработка компаний не завершится успешно или с ошибкой.
- Читайте 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 с каждой записью при сравнении атрибутов компании или видимых счетчиков во времени.
Связанные API
Помимо 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 связей и видимое число лайков и ответов.