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