linkedin/
jobs

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

LinkedIn Jobs API

URL вакансии на входе
Контекст должности
Поля отклика
0,8 кредита за результат
Готово
Готово

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

README

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

LinkedIn Jobs

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

Возможности LinkedIn Jobs API

  • URL страницы вакансии на входеОбрабатывает одну или несколько публичных страниц LinkedIn вида /jobs/view/{slug} и отклоняет результаты поиска и URL подборок вакансий.
  • Должность и работодатель в одной записиВозвращает вместе название должности, полное описание, URL вакансии и нормализованные публичные данные нанимающей компании.
  • Структурированные условия занятостиПредоставляет местоположение, уровень должности, тип занятости и отрасли как отдельные поля, а не оставляет их внутри описания.
  • Поля отклика и зарплатыВозвращает apply_link, признак Easy Apply, зарплату, время публикации и время сбора как отдельные поля вакансии.

Параметры LinkedIn Jobs API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список URL публичных страниц вакансий LinkedIn. Каждый URL должен использовать путь /jobs/view/{slug} на linkedin.com или поддомене LinkedIn.

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

Отправьте известные ссылки на страницы вакансий, дождитесь подготовки записей и получите все доступные страницы результатов.

  1. Оставьте во входном списке только публичные ссылки на страницы вакансий вида /jobs/view/{slug}.
  2. Отправьте эти ссылки в urls методом POST на /v1/linkedin/jobs и сохраните task_id.
  3. Запрашивайте /v1/tasks/{task_id}, пока задача по вакансиям не перейдет в конечный статус.
  4. После успешного завершения обработайте data.results.items и используйте next_cursor для каждой страницы, помеченной has_more.
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/jobs/view/software-engineer-at-microsoft-4429527118"]}'

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

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

  • Отслеживание вакансий: Используйте должность, работодателя, местоположение, время публикации и исходный URL, чтобы вести структурированный список известных вакансий.
  • Сравнение должностей и требований: Сравнивайте описания, уровень, тип занятости, отрасль, местоположение и доступную зарплату в выбранных вакансиях.
  • Исследование рынка найма: Группируйте выбранные вакансии по работодателю, местоположению, отрасли или типу занятости, чтобы изучать видимые закономерности найма.
  • Управление способами отклика: Используйте apply_link и признак Easy Apply, чтобы направлять каждую сохраненную вакансию по доступному способу отклика.

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

  • Извлекайте идентификатор вакансии из ссылок /jobs/view/ и убирайте дубли, чтобы разные формы URL не создавали повторных записей.
  • Считайте зарплату необязательными данными источника: во многих вакансиях ее нет, а указанные значения могут быть в разных форматах.
  • Проверяйте apply_link, прежде чем показывать его как внешнее действие в последующем интерфейсе.
  • Разделяйте created_at и collected_at, чтобы не путать время публикации со временем получения вакансии.

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

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

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

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

LinkedIn Jobs API — FAQ

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

Нет. Каждое входное значение должно быть полным URL LinkedIn со схемой http или https для одной страницы вакансии вида /jobs/view/{slug}; маршруты поиска и подборок проверку не проходят.

Нет. Этот продукт обрабатывает только переданные в urls публичные URL страниц вакансий и не выполняет поиск вакансий в LinkedIn.

Запись вакансии может содержать внешний apply_link и признак is_easy_apply, если публичная вакансия их раскрывает. Эндпоинт возвращает сведения об отклике, но не отправляет отклики.

В публичной вакансии может не быть опубликованной зарплаты, внешней ссылки для отклика или признака Easy Apply, поэтому эти необязательные поля могут быть null или пустыми.

Каждая возвращенная запись вакансии оплачивается по 0,8 кредита SocQ. Если задача дает пустой набор результатов, плата за результаты не взимается.