linkedin/
company-jobs

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

LinkedIn Company Jobs API

Страница вакансий на входе
Лимит на каждый URL
Канонические записи вакансий
0,5 кредита за результат
Готово
Готово

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

README

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

LinkedIn Company Jobs

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

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

  • Поиск по страницам вакансийОтправьте один или несколько публичных URL LinkedIn, пути которых начинаются с /jobs/, и соберите вакансии, показанные на каждой подготовленной странице.
  • Лимит на каждый входной URLЗадайте results_limit от 1 до 2 000; выбранный лимит применяется к каждому URL в запросе отдельно.
  • Канонические записи вакансийПолучайте стабильные поля вакансии, компании, местоположения, зарплаты, публикации, окончания срока и сбора вместо специфичной для источника вложенной структуры.
  • Точность источника с полями nullПоля остаются null, если вакансия не раскрывает публично такие значения, как зарплата, формат удаленной работы, уровень опыта или точное местоположение.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список публичных URL LinkedIn со схемой http или https. Хост каждого URL должен быть linkedin.com или поддоменом LinkedIn, а путь — начинаться с /jobs/.
results_limitНеобязательныйНеобязательный целочисленный лимит результатов, применяемый к каждому входному URL. По умолчанию 100, минимум 1, максимум 2 000.

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

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

  1. Подготовьте публичные URL LinkedIn, путь которых начинается с /jobs/, сохранив полезные параметры запроса.
  2. Отправьте urls и results_limit методом POST на /v1/linkedin/company-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/company-jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/jobs/microsoft-jobs/"],"results_limit":20}'

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

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

  • Мониторинг выбранных работодателей: Повторно обращайтесь к подготовленным URL вакансий компаний и сравнивайте публичные вакансии, полученные в разное время сбора.
  • Обогащение каталога должностей: Добавляйте нормализованные поля компании, местоположения, типа занятости, опыта, удаленной работы, зарплаты и дат в публичный каталог вакансий.
  • Исследование страниц найма: Сравнивайте состав должностей на выбранных страницах вакансий, сохраняя каждый исходный URL и метку времени сбора.
  • Передача в рабочие процессы: Передавайте найденные публичные записи вакансий в сценарии проверки, дедупликации, оповещений или последующего анализа.

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

  • Сохраняйте значимые параметры запроса в подготовленных URL: они могут влиять на то, какие вакансии показывает страница.
  • Убирайте дубли по стабильному id вакансии или URL объявления, если пересекающиеся страницы вакансий возвращают одну и ту же позицию.
  • Считайте пустой результат для одного URL итогом сбора, а не доказательством того, что у работодателя нет открытых вакансий.
  • Используйте структурированный поиск вакансий, если нужны явные параметры ключевого слова или местоположения вместо подготовленных URL страниц.
  • Разделяйте published_at, expires_at и collected_at, чтобы не путать время публикации вакансии со временем ее получения.

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

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

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

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

LinkedIn Company Jobs API — FAQ

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

Каждое значение должно быть полным URL со схемой http или https на linkedin.com или поддомене LinkedIn, путь которого начинается с /jobs/. Обычные URL профилей компаний вида /company/ проверку не проходят.

Целочисленный лимит применяется к каждому URL отдельно. Например, лимит 20 позволяет получить до 20 вакансий на каждую переданную страницу вакансий.

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

Нет. Эндпоинт возвращает публичные данные вакансий: он не откликается на вакансии, не связывается с рекрутерами и не раскрывает закрытую аналитику найма.

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