linkedin/
search-jobs

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

LinkedIn Search Jobs API

Местоположение обязательно
Структурированный поиск
Канонические записи вакансий
0,5 кредита за результат
Готово
Готово

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

README

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

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

Отправьте один запрос по местоположению, опрашивайте асинхронную задачу и обработайте каждую возвращенную страницу результатов.

  1. Выберите обязательное местоположение и добавляйте только те значения фильтров провайдера, интерпретацию которых вы проверили.
  2. Отправьте запрос методом POST на /v1/linkedin/search-jobs и сохраните возвращенный 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-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, чтобы не путать время публикации вакансии со временем ее получения.
  • Считайте пустой результат итогом одного сбора, а не доказательством того, что подходящих публичных вакансий нет.

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

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

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

LinkedIn Search Jobs API — FAQ

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

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

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

Нет. Это целочисленный лимит от 1 до 2 000, по умолчанию 100. Публичная доступность, сочетания фильтров, пагинация, дубли и поведение провайдера могут дать меньше записей.

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

Нет. Эндпоинт не откликается на вакансии, не сохраняет их, не создает оповещения, не получает данные кандидатов, не дает доступ к Recruiter и не рассчитывает персональные оценки соответствия.

Каждая возвращенная запись вакансии стоит 0,5 кредита SocQ, базовой платы нет. Оценка по умолчанию — 100 результатов, пустой набор результатов не оплачивается, а фактический расход может превысить оценку, если это допускается.