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