SuperJob API: GET /2.0/clients/ — Поиск компаний

В ответе objects (id, title, link, description, vacancy_count, staff_count, industry, client_logo, is_blocked), total, more.

Параметр	Где	Тип	Обяз.	Описание
`id_client`	query	integer	нет	ID компании
`keyword`	query	string	нет	Название, часть названия или URL компании
`town`	query	string	нет	Город
`all`	query	integer	нет	1 — включая компании без вакансий

Базовые URL

Тип: OAuth 2.0

Секретный ключ приложения передаётся в каждом запросе в заголовке X-Api-App-Id.
Для методов с авторизацией — Authorization: Bearer <access_token>.
Авторизация пользователя: GET https://www.superjob.ru/authorize/ (client_id, redirect_uri, state) → код → https://api.superjob.ru/2.0/oauth2/access_token/ (code, client_id, client_secret, redirect_uri).
Обновление: GET https://api.superjob.ru/2.0/oauth2/refresh_token/ (refresh_token, client_id, client_secret).
Для desktop-приложений — вход по паролю POST /2.0/oauth2/password/.

Через API можно получить не больше 500 записей выдачи (page × count).
В поиске вакансий массив ids — не больше 500 ID.
Параметры published, published_all, archive, not_archive работают только при авторизации работодателя при поиске своих вакансий.
Ошибки авторизации дополнительно возвращают машиночитаемый error (например, invalid_token) и заголовок X-Oauth-Error.
Документация помечена как актуальная для версии 2.20; свежая версия — https://api.superjob.ru/doc/.

Если этого недостаточно — официальная документация: https://api.superjob.ru/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/superjob.md