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