LinkedIn Profiles
Публичный профиль LinkedIn показывает данные специалиста, текущую должность, местоположение, опыт работы, образование, навыки и видимый размер аудитории. Эти сведения помогают обогащать контакты, исследовать карьерные траектории, проверять личность и сравнивать изменения публичного профиля во времени.
Возможности LinkedIn Profiles API
- URL публичного профиля на входеОбрабатывает один или несколько URL LinkedIn вида /in/{slug}, не смешивая их со страницами компаний, публикациями или вакансиями.
- Текущий профессиональный контекстВозвращает публичное имя, текст раздела «О себе», аватар, местоположение, должность и текущую компанию в одной нормализованной записи.
- Структурированная карьерная историяСохраняет опыт работы, образование и навыки как отдельные разделы для фильтрации, индексации и обогащения записей.
- Видимые метрики аудиторииВозвращает доступное число подписчиков и контактов как отдельные метрики вместе с полями профессионального профиля.
Параметры LinkedIn Profiles API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных профилей LinkedIn. Каждый URL должен использовать путь /in/{slug} на linkedin.com или поддомене LinkedIn. |
Как использовать LinkedIn Profiles API
Начните с известных ссылок на профили, дождитесь завершения задачи и постранично читайте карьерные записи.
- Оставьте только публичные ссылки LinkedIn, путь которых соответствует /in/{slug}.
- Отправьте эти ссылки в urls на /v1/linkedin/profiles и сохраните 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/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования LinkedIn Profiles API
- Обогащение контактов и кандидатов: Добавляйте текущую должность, компанию, местоположение, опыт работы, образование и навыки в записи, связанные с известными URL профилей.
- Исследование карьерных траекторий: Используйте структурированные разделы опыта работы и образования, чтобы изучать карьерный рост и профессиональный бэкграунд.
- Мониторинг публичных профилей: Сравнивайте сохраненные снимки профилей, чтобы выявлять изменения должности, текущей компании, навыков или видимого размера аудитории.
Практические советы по LinkedIn Profiles API
- Нормализуйте URL /in/ и убирайте дубли перед отправкой, чтобы разные формы URL не создавали повторных записей профилей.
- Используйте возвращенный id как ключ профиля, если он есть, а url — как резервный вариант для записей без идентификатора.
- Считайте опыт работы, образование, навыки и размер аудитории необязательными: в публичном профиле любой из этих разделов может отсутствовать.
- Храните collected_at с каждым сохраненным снимком при сравнении изменений должности или аудитории во времени.
Связанные API
Помимо LinkedIn Profiles API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.
- LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
- LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
- LinkedIn Jobs API — Нормализуйте публичные вакансии: должность, компания, описание, местоположение, требования, условия занятости, ссылки для отклика и доступные поля зарплаты.
- LinkedIn Company Jobs API — Находите публичные вакансии по подготовленным URL LinkedIn /jobs/ с нормализованными полями должности, компании, местоположения, занятости, опыта, удаленной работы, зарплаты и сроков.
- LinkedIn Company Posts API — Находите публичные публикации по URL страниц компаний LinkedIn: текст, контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.
- LinkedIn Profile Posts API — Находите публичные публикации, связанные с URL профилей LinkedIn: контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.