linkedin/
search-people

Находите публичные профили LinkedIn — кандидатов на совпадение — по URL поиска людей и получайте нормализованные данные об идентичности, описание, изображения, местоположение, сайт, признаки аккаунта и доступные метрики.

LinkedIn Search People API

URL поиска на входе
Поиск по имени
Канонические аккаунты
1 кредит за результат
Готово
Готово

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

README

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

LinkedIn Search People

LinkedIn Search People превращает значение keywords в каждом переданном URL поиска людей в запрос к провайдеру по имени. Результаты — это публичные профили-кандидаты для проверки идентичности, а не доказательство того, что профиль принадлежит нужному человеку, и эндпоинт не применяет закодированные в URL фильтры по компании, учебному заведению, местоположению, отрасли или контактам.

Возможности LinkedIn Search People API

  • URL поиска людей на входеПередавайте один или несколько публичных URL LinkedIn, путь которых начинается с /search/results/people.
  • Явное сопоставление имениДекодирует keywords, сопоставляет первый токен до пробела с first_name, а остальные токены объединяет в last_name.
  • Поиск профилей-кандидатовПолучайте URL публичных профилей и данные об идентичности, которые помогают при ручном сопоставлении или последующем сборе по конкретному профилю.
  • Канонические записи аккаунтовВозвращает стабильные поля идентичности, описания, изображения, сайта, состояния аккаунта, местоположения, метрик и сбора.
  • Точность источника с nullНедоступные поля остаются null; эндпоинт не выводит приватные контакты, историю работы, образование, навыки или степень уверенности в личности.

Параметры LinkedIn Search People API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список публичных URL LinkedIn с http или https. Хост должен быть linkedin.com или поддоменом LinkedIn, а путь должен начинаться с /search/results/people. Указывайте keywords, чтобы поиск по имени работал надежно.

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

Подготовьте URL поиска людей по имени, отправьте асинхронную задачу и проверьте каждого возвращенного кандидата.

  1. Создайте URL поиска людей LinkedIn со значением keywords, содержащим имя человека.
  2. Отправьте urls методом POST на /v1/linkedin/search-people и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в конечный статус.
  4. После успешного завершения обработайте data.results.items и переходите по next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'

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

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

  • Поиск URL профилей: Находите URL публичных профилей LinkedIn — кандидатов на совпадение, прежде чем использовать эндпоинт сбора по конкретному профилю.
  • Ручное установление личности: Сравнивайте имена, описания, местоположения, изображения и URL кандидатов, сохраняя неопределенность.
  • Загрузка в публичный каталог: Передавайте нормализованные аккаунты-кандидаты в очередь проверки, не обещая обогащения контактами или приватных атрибутов.
  • Исследование вариантов имени: Запускайте тщательно выбранные варианты написания имени по отдельности и сравнивайте публичных кандидатов, полученных в каждый момент сбора.

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

  • Всегда указывайте осмысленное значение keywords: корректный URL без него создает пустую строку имени, и поведение провайдера в этом случае ненадежно.
  • Помните, что Mary Jane Smith сопоставляется с first_name Mary и last_name Jane Smith, а не обрабатывается как общее выражение с ключевыми словами.
  • Не рассчитывайте, что фильтры по местоположению, компании, учебному заведению, отрасли или контактам в URL будут учтены: текущий адаптер их отбрасывает.
  • Прежде чем установить личность человека, используйте URL публичного профиля вместе с несколькими подтверждающими атрибутами.
  • Убирайте повторяющихся кандидатов по стабильному URL профиля, если несколько переданных поисков пересекаются.
  • Лимита результатов, которым управляет вызывающая сторона, нет, поэтому стройте процессы оплаты и проверки исходя из фактически сохраненных результатов.

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

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

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

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

LinkedIn Search People API — FAQ

LinkedIn Search People API — это программный интерфейс для поиска публичных профилей LinkedIn — кандидатов на совпадение — по URL поиска людей. Он преобразует значение keywords из URL в запрос к провайдеру по имени и возвращает нормализованные записи публичных аккаунтов для проверки.

Каждое значение должно быть полным URL с http или https на linkedin.com или поддомене LinkedIn, а путь должен начинаться с /search/results/people.

После декодирования значение разбивается по пробелам. Первый токен становится first_name, а все остальные токены объединяются в last_name.

Нет. Текущий адаптер не сопоставляет закодированные фильтры по местоположению, компании, учебному заведению, степени контакта и другие фильтры поиска.

Нет. У этого эндпоинта нет лимита результатов, которым управляет вызывающая сторона; он сохраняет записи, полученные от источника поиска для каждого переданного URL.

Нет. Имена не уникальны. Считайте каждый результат кандидатом и подтверждайте публичный URL, имя, описание, местоположение и другие видимые атрибуты.

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