Skip to main content
POST
Поиск вакансий

Авторизации

pubrio-api-key
string
header
обязательно

Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе Settings.

Тело

application/json
locations
string[]

ISO 3166-1 alpha-2 (cca2) используется для фильтрации местоположений. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
exclude_locations
string[]

Коды местоположений ISO 3166-1 alpha-2 (cca2), которые нужно исключить из результатов по вакансиям. Актуальные коды можно найти в эндпоинтах location на вкладке Filters.

Пример:
location_ids
integer[]

Страна публикации по Pubrio location_id (эндпоинт Locations; также присутствует в каждой строке). Альтернатива locations.

Пример:
company_locations
string[]

Местоположение штаб-квартиры компании. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
companies
string<uuid>[]

Список уникальных идентификаторов (domain_search_id), используемых для операций поиска компаний и людей.

domains
string[]

Список доменов компаний, используемых для операций поиска компаний и людей. Если получен URL вида www.pubrio.com или https://docs.pubrio.com/, система преобразует его в pubrio.com для обработки.

Пример:
linkedin_urls
string[]

Полностью сформированный URL профиля компании в LinkedIn. URL начинается с http и содержит linkedin.com/company/

Пример:
search_term
string

Строка слов, по которой мы фильтруем результаты.

Пример:

"pubrio"

search_terms
string[]

Массив ключевых слов для фильтрации вакансий. Каждый термин сопоставляется с содержимым вакансии. Используйте search_term для одной строки или search_terms для нескольких ключевых слов.

Пример:
titles
string[]

Должности, связанные с людьми, которых вы хотите найти.

Результаты также будут включать должности, содержащие схожую терминологию, даже если они не совпадают точно. Например, поиск по software engineer может вернуть результаты с должностью senior software engineer.

Пример:
functions
string[]

Слаги функций, определённые по названию должности, например engineering, sales, marketing, finance, product_management — те же значения строки возвращают в functions. Неизвестные слаги ничего не находят. Полный список: Enums & Constants.

Пример:
seniority_ranks
enum<integer>[]

Уровень должности по названию: 1 junior, 2 senior, 3 manager, 4 director, 5 executive. Значения вне диапазона 1–5 игнорируются, и фильтр отбрасывается. Строки возвращают свой уровень в seniority_rank (0 = не классифицировано).

Доступные опции:
1,
2,
3,
4,
5
Пример:
posted_dates
string[]

Диапазон дат публикации вакансии. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области.

Пример:
launch_dates
string<date>[]

Включающий диапазон [from, to] (UTC) по дате публикации: posting_date, либо день загрузки при отсутствии первого. Соответствует тому, как считает Job Insights. Одна дата соответствует этому дню.

Required array length: 1 - 2 elements
Пример:
created_at
string<date-time>

Загружено в этот момент времени (UTC) или позже. Дата или временная метка ISO. Для инкрементальной синхронизации передайте created_at вашей самой новой сохранённой строки.

Пример:

"2026-09-02T12:00:00Z"

is_realtime_enrichment
boolean
по умолчанию:false

Включить обогащение в реальном времени для одного запроса в рамках конкретной компании (отфильтрованного по domain_search_id, domains или linkedin_urls). Если первоначальный поиск не возвращает результатов, эндпоинт извлекает данные из источника, сохраняет записи и повторно выполняет поиск перед формированием ответа. Действует ограничение по времени для каждого маршрута.

Пример:

true

is_ascending_order
boolean
по умолчанию:false

Направление сортировки. По умолчанию результаты возвращаются от самых новых; установите true для сортировки от самых старых. У этого эндпоинта нет sort_by — ключ сортировки фиксирован и указан в описании эндпоинта.

Пример:

false

per_page
integer
по умолчанию:25

Количество записей на странице. По умолчанию — 25, что также является пределом на большинстве тарифов — лимит определяется параметром max_search_per_page вашей подписки, который возвращает Profile. Превышение возвращает HTTP 416 с кодом 41676 (или 41613 для поиска компаний и людей), а не усечённый набор результатов.

Требуемый диапазон: x <= 25
Пример:

25

page
integer
по умолчанию:1

Номер страницы, начиная с 1. Предел определяется параметром max_search_page вашей подписки (max_company_search_page для поиска компаний), который возвращает Profile. Превышение возвращает HTTP 416.

Пример:

1

Ответ

Успешный ответ с данными поиска вакансий компании.

metadata
object

Контекст запроса.

data
object
Последнее изменение 4 сентября 2026 г.