linkedin/
profiles

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

LinkedIn Profiles API

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

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

README

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

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

Начните с известных ссылок на профили, дождитесь завершения задачи и постранично читайте карьерные записи.

  1. Оставьте только публичные ссылки LinkedIn, путь которых соответствует /in/{slug}.
  2. Отправьте эти ссылки в urls на /v1/linkedin/profiles и сохраните 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/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 с каждым сохраненным снимком при сравнении изменений должности или аудитории во времени.

Помимо 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: контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.

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

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

LinkedIn Profiles API — FAQ

LinkedIn Profiles API получает публичные профессиональные данные по одному или нескольким допустимым URL вида /in/{slug}. Он возвращает нормализованные личные данные, текущую должность, местоположение, опыт работы, образование, навыки и доступное число подписчиков и контактов.

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

Нет. Результаты ограничены полями, видимыми в публичном профиле на момент обработки, и ответ не добавляет закрытых данных участника.

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

Оплата начисляется за возвращенные профили — 2,5 кредита SocQ за результат. Если завершенная задача не вернула ни одного профиля, плата за результаты не взимается.