LinkedIn Search Jobs
LinkedIn Search Jobs строит один публичный поисковый запрос из обязательного местоположения и необязательных фильтров. Эндпоинт возвращает записи вакансий на момент сбора для исследований и загрузки в рабочие процессы; возвращенная вакансия не доказывает, что прием откликов еще открыт, а число результатов не является прямой мерой найма или численности персонала.
Возможности LinkedIn Search Jobs API
- Поиск от местоположенияНачинайте каждый запрос с непустого местоположения и при необходимости сужайте выборку публичных вакансий ключевым словом, страной, компанией или другим фильтром провайдера.
- Гибкие фильтры источникаПередает значения time_range, job_type, experience_level, remote, company, location_radius, selective_search и исключения, не придумывая собственных перечислений SocQ.
- Настраиваемый лимит результатовЗадайте results_limit от 1 до 2 000 для единственного поискового запроса; по умолчанию 100, и провайдер может вернуть меньше записей.
- Канонические записи вакансийПолучайте стабильные поля вакансии, компании, местоположения, зарплаты, публикации, истечения срока и сбора вместо вложенных структур конкретного провайдера.
- Точность источника с nullНедоступные значения зарплаты, удаленной работы, компании, опыта, местоположения, даты публикации и истечения срока остаются null, а не выводятся догадкой.
Параметры LinkedIn Search Jobs API
| Параметры | Обязательный | Описание |
|---|---|---|
location | Обязательный | Обязательная непустая строка местоположения, из которой строится поисковый запрос к провайдеру. |
keyword | Необязательный | Необязательная непустая строка с должностью, навыком или темой, которая передается провайдеру. |
country | Необязательный | Необязательная непустая строка фильтра по стране, которая передается без преобразования на стороне SocQ. |
time_range | Необязательный | Необязательная непустая строка давности или временного диапазона в формате провайдера. |
job_type | Необязательный | Необязательная непустая строка фильтра по типу занятости или вакансии в формате провайдера. |
experience_level | Необязательный | Необязательная непустая строка фильтра по опыту или уровню должности в формате провайдера. |
remote | Необязательный | Необязательная непустая строка фильтра по формату работы или удаленке в формате провайдера. |
company | Необязательный | Необязательная непустая строка фильтра по компании, которая передается провайдеру. |
selective_search | Необязательный | Необязательное логическое значение, которое передается провайдеру и управляет его режимом выборочного поиска. |
jobs_to_not_include | Необязательный | Необязательный список непустых строк-исключений, который передается провайдеру. |
location_radius | Необязательный | Необязательная непустая строка радиуса в формате провайдера, связанная с запросом по местоположению. |
results_limit | Необязательный | Необязательный целочисленный лимит для этого запроса. По умолчанию 100, минимум 1, максимум 2 000. |
Как использовать LinkedIn Search Jobs API
Отправьте один запрос по местоположению, опрашивайте асинхронную задачу и обработайте каждую возвращенную страницу результатов.
- Выберите обязательное местоположение и добавляйте только те значения фильтров провайдера, интерпретацию которых вы проверили.
- Отправьте запрос методом POST на /v1/linkedin/search-jobs и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в конечный статус.
- После успешного завершения обработайте data.results.items и переходите по next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/linkedin/search-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location":"Seattle","keyword":"Python","country":"US","results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования LinkedIn Search Jobs API
- Поиск вакансий по региону: Собирайте публичные вакансии по постоянному запросу «должность + местоположение» и сохраняйте время сбора для последующего сравнения.
- Анализ работодателей и должностей: Изучайте, какие работодатели, должности, места, форматы работы, уровни опыта и типы занятости встречаются в полученной выборке.
- Наличие данных о зарплате: Находите вакансии с указанной зарплатой, сохраняя отсутствие данных о вознаграждении как явный null.
- Загрузка вакансий в рабочие процессы: Передавайте нормализованные URL публичных вакансий и их поля в процессы проверки, дедупликации, оповещений или последующего анализа.
Практические советы по LinkedIn Search Jobs API
- Проверяйте написание фильтров провайдера на небольшом запросе, прежде чем использовать их в регулярном рабочем процессе.
- Используйте одинаковые фильтры и расписание сбора, когда сравниваете местоположения или даты.
- Убирайте дубли по стабильному ID вакансии или URL объявления: обновленные и пересекающиеся поиски могут показывать одну и ту же вакансию.
- Считайте метки удаленной работы сигналами источника и читайте описание, чтобы узнать ограничения по географии, резидентству или часовому поясу.
- Различайте published_at, expires_at и collected_at, чтобы не путать время публикации вакансии со временем ее получения.
- Считайте пустой результат итогом одного сбора, а не доказательством того, что подходящих публичных вакансий нет.
Связанные API
Помимо LinkedIn Search Jobs API, используйте эти API, когда нужен другой тип публичных данных LinkedIn.
- LinkedIn Profiles API — Нормализуйте по URL профилей публичные данные: личность, должности, местоположение, видимое число аудитории, опыт, образование и навыки.
- LinkedIn Companies API — Нормализуйте публичные описания компаний, сайты, логотипы, видимое число подписчиков и сотрудников, отрасли, местоположения и специализации.
- LinkedIn Posts API — Собирайте по поддерживаемым URL текст публичных публикаций, авторов, видимую вовлеченность, медиа, время публикации, тип и хештеги.
- LinkedIn Jobs API — Нормализуйте публичные вакансии: должность, компания, описание, местоположение, требования, условия занятости, ссылки для отклика и доступные поля зарплаты.
- LinkedIn Company Jobs API — Находите публичные вакансии по подготовленным URL LinkedIn /jobs/ с нормализованными полями должности, компании, местоположения, занятости, опыта, удаленной работы, зарплаты и сроков.
- LinkedIn Company Posts API — Находите публичные публикации по URL страниц компаний LinkedIn: текст, контекст автора, медиа, хештеги, метки времени и видимая вовлеченность.