{"name":"SuperJob API","vendor":"SuperJob","industry":"hr","summary":"API сервиса поиска работы SuperJob (версия 2.0): поиск вакансий и компаний, просмотр вакансии, подписки на вакансии, блокировка компаний в поиске, данные пользователя и его резюме. Вакансии и компании доступны по ключу приложения, контакты и пользовательские данные — после OAuth-авторизации.","docsUrl":"https://api.superjob.ru/","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"nayti-vakansii-po-zaprosu","title":"Найти вакансии по запросу","summary":"Поиск вакансий SuperJob для своего сайта, бота или агрегатора.","steps":["Зарегистрируй приложение на api.superjob.ru и передавай секретный ключ в заголовке X-Api-App-Id в каждом запросе.","Ищи: GET /2.0/vacancies/ с keyword, town (название или ID города), payment_from, no_agreement = 1 (скрыть «по договорённости»), period, count (до 100) и page.","В ответе objects, total и more — признак следующей страницы. При опечатке в запросе придёт corrected_keyword.","Всего через API доступно не больше 500 записей выдачи (page × count) — сужай фильтры, если нужно больше. Лимит — 120 запросов в минуту с одного IP.","Контакты работодателя в вакансиях приходят только с авторизацией пользователя."],"code":"curl -G https://api.superjob.ru/2.0/vacancies/ \\\n  -H \"X-Api-App-Id: $SJ_APP_KEY\" \\\n  --data-urlencode 'keyword=бухгалтер' \\\n  --data-urlencode 'town=Москва' \\\n  -d payment_from=80000 -d no_agreement=1 -d count=50 -d page=0","language":"bash","methods":["GET /2.0/vacancies/"]},{"id":"nayti-kompaniyu-rabotodatelya","title":"Найти компанию работодателя","summary":"Карточка компании: описание, отрасль, число вакансий и сотрудников.","steps":["Найди компанию: GET /2.0/clients/ с keyword — названием, частью названия или адресом сайта. Чтобы видеть и компании без открытых вакансий, передай all = 1.","Получи подробности: GET /2.0/clients/{id}/ — description, industry, vacancy_count, staff_count, логотип.","Вакансии компании ищи через GET /2.0/vacancies/ с нужными фильтрами."],"code":"curl -G https://api.superjob.ru/2.0/clients/ -H \"X-Api-App-Id: $SJ_APP_KEY\" --data-urlencode 'keyword=Яндекс'\ncurl https://api.superjob.ru/2.0/clients/<id>/ -H \"X-Api-App-Id: $SJ_APP_KEY\"","language":"bash","methods":["GET /2.0/vacancies/","GET /2.0/clients/","GET /2.0/clients/{id}/"]},{"id":"avtorizovat-polzovatelya-i-pokazat","title":"Авторизовать пользователя и показать контакты вакансии","summary":"Для сервисов соискателя: вход через SuperJob и доступ к контактам работодателя.","steps":["Отправь пользователя на https://www.superjob.ru/authorize/ с client_id, redirect_uri и state.","Обменяй код на токен: GET /2.0/oauth2/access_token/ с code, client_id, client_secret и redirect_uri. Для приложений без браузера есть вход по паролю — POST /2.0/oauth2/password/ (не больше 10 ошибок входа в час).","Передавай токен в заголовке Authorization: Bearer <access_token> вместе с X-Api-App-Id. Проверь вход: GET /2.0/user/current/.","Запроси вакансию с контактами: GET /2.0/vacancies/{id}/. Истёкший токен вернёт 401 с error = invalid_token — обнови его через /2.0/oauth2/refresh_token/."],"code":"curl https://api.superjob.ru/2.0/vacancies/<id>/ \\\n  -H \"X-Api-App-Id: $SJ_APP_KEY\" \\\n  -H \"Authorization: Bearer $SJ_ACCESS_TOKEN\"","language":"bash","methods":["GET /2.0/oauth2/access_token/","POST /2.0/oauth2/password/","GET /2.0/vacancies/{id}/","GET /2.0/user/current/"]}],"baseUrls":[{"label":"Боевой","url":"https://api.superjob.ru"},{"label":"Формат","url":"https://api.superjob.ru/:version/method_name/:params"}],"auth":{"type":"oauth2","description":"- Секретный ключ приложения передаётся в каждом запросе в заголовке `X-Api-App-Id`.\n- Для методов с авторизацией — `Authorization: Bearer <access_token>`.\n- Авторизация пользователя: `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`).\n- Обновление: `GET https://api.superjob.ru/2.0/oauth2/refresh_token/` (`refresh_token`, `client_id`, `client_secret`).\n- Для desktop-приложений — вход по паролю `POST /2.0/oauth2/password/`.","example":""},"methods":[{"id":"GET /2.0/oauth2/access_token/","title":"Получение access token","httpMethod":"GET","path":"/2.0/oauth2/access_token/","description":"Также поддерживается POST; PUT по этому адресу инвалидирует токен, DELETE — удаляет.","params":[{"name":"code","in":"query","type":"string","required":true,"description":"Код из редиректа авторизации"},{"name":"client_id","in":"query","type":"string","required":true,"description":"ID приложения"},{"name":"client_secret","in":"query","type":"string","required":true,"description":"Секрет приложения"},{"name":"redirect_uri","in":"query","type":"string","required":true,"description":"Адрес возврата"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /2.0/oauth2/password/","title":"Авторизация по паролю","httpMethod":"POST","path":"/2.0/oauth2/password/","description":"","params":[{"name":"login","in":"body","type":"string","required":true,"description":"Логин"},{"name":"password","in":"body","type":"string","required":true,"description":"Пароль"},{"name":"client_id","in":"body","type":"string","required":true,"description":"ID приложения"},{"name":"client_secret","in":"body","type":"string","required":true,"description":"Секрет приложения"},{"name":"hr","in":"body","type":"integer","required":false,"description":"Вход работодателя"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /2.0/vacancies/","title":"Поиск вакансий","httpMethod":"GET","path":"/2.0/vacancies/","description":"Также поддерживается POST. Контакты в вакансиях — только с авторизацией. В ответе: `objects`, `total`, `more`, при опечатке — `corrected_keyword`.","params":[{"name":"X-Api-App-Id","in":"header","type":"string","required":true,"description":"Секретный ключ приложения"},{"name":"keyword","in":"query","type":"string","required":false,"description":"Поиск по всему тексту вакансии"},{"name":"keywords","in":"query","type":"array","required":false,"description":"Расширенный поиск: блок, тип совпадения, исключаемые слова"},{"name":"town","in":"query","type":"string","required":false,"description":"Город (название или ID)"},{"name":"t","in":"query","type":"array","required":false,"description":"ID городов"},{"name":"o","in":"query","type":"array","required":false,"description":"ID областей"},{"name":"c","in":"query","type":"array","required":false,"description":"ID стран"},{"name":"m","in":"query","type":"array","required":false,"description":"ID станций метро"},{"name":"catalogues","in":"query","type":"string","required":false,"description":"Отрасли (ключи из справочника каталогов)"},{"name":"payment_from","in":"query","type":"integer","required":false,"description":"Зарплата от"},{"name":"payment_to","in":"query","type":"integer","required":false,"description":"Зарплата до"},{"name":"no_agreement","in":"query","type":"integer","required":false,"description":"1 — скрыть вакансии «по договорённости»"},{"name":"experience","in":"query","type":"integer","required":false,"description":"Опыт работы"},{"name":"type_of_work","in":"query","type":"integer","required":false,"description":"Тип занятости"},{"name":"place_of_work","in":"query","type":"integer","required":false,"description":"Место работы"},{"name":"education","in":"query","type":"integer","required":false,"description":"Образование"},{"name":"period","in":"query","type":"integer","required":false,"description":"Период публикации: 24 часа, 3 дня, неделя или всё время"},{"name":"order_field","in":"query","type":"string","required":false,"description":"date или payment"},{"name":"order_direction","in":"query","type":"string","required":false,"description":"asc или desc (по умолчанию)"},{"name":"page","in":"query","type":"integer","required":false,"description":"0–500, по умолчанию 0"},{"name":"count","in":"query","type":"integer","required":false,"description":"1–100, по умолчанию 20"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /2.0/vacancies/{id}/","title":"Вакансия по ID","httpMethod":"GET","path":"/2.0/vacancies/{id}/","description":"Авторизация нужна только для контактов.","params":[{"name":"id","in":"path","type":"integer","required":true,"description":"ID вакансии"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /2.0/clients/","title":"Поиск компаний","httpMethod":"GET","path":"/2.0/clients/","description":"В ответе `objects` (`id`, `title`, `link`, `description`, `vacancy_count`, `staff_count`, `industry`, `client_logo`, `is_blocked`), `total`, `more`.","params":[{"name":"id_client","in":"query","type":"integer","required":false,"description":"ID компании"},{"name":"keyword","in":"query","type":"string","required":false,"description":"Название, часть названия или URL компании"},{"name":"town","in":"query","type":"string","required":false,"description":"Город"},{"name":"all","in":"query","type":"integer","required":false,"description":"1 — включая компании без вакансий"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /2.0/clients/{id}/","title":"Компания по ID","httpMethod":"GET","path":"/2.0/clients/{id}/","description":"","params":[{"name":"id","in":"path","type":"integer","required":true,"description":"ID компании"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /2.0/subscriptions/","title":"Создание подписки на вакансии","httpMethod":"POST","path":"/2.0/subscriptions/","description":"Список подписок — `GET /2.0/subscriptions/`; просмотр, изменение и удаление — `GET`/`PUT`/`DELETE /2.0/subscriptions/{id}` (с авторизацией).","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /2.0/user/current/","title":"Текущий пользователь","httpMethod":"GET","path":"/2.0/user/current/","description":"Требует авторизации.","params":[],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"400","description":"Некорректный запрос"},{"code":"401","description":"Нет авторизации"},{"code":"403","description":"Доступ запрещён"},{"code":"404","description":"Не найдено"},{"code":"410","description":"Ресурс удалён"},{"code":"422","description":"Ошибка валидации"},{"code":"429","description":"Слишком много запросов (в т. ч. больше 10 ошибок входа в час)"},{"code":"504","description":"Таймаут"}],"limits":"- 120 запросов в минуту с одного IP (в тексте документации при превышении указан код 503, в таблице ошибок — 429).\n- `count` — до 100, `page` — до 500, всего не больше 500 сущностей.\n- Вход по паролю — не больше 10 ошибок в час на логин.","gotchas":["Через 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/`."],"slug":"superjob","version":2,"updatedAt":"2026-10-24T17:05:37.321Z","sources":[{"title":"SuperJob API","url":"https://api.superjob.ru/","kind":"research","addedAt":"2026-10-17T07:20:55.782Z"},{"title":"Актуальная документация","url":"https://api.superjob.ru/doc/","kind":"research","addedAt":"2026-10-17T07:20:55.782Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-17T07:20:55.782Z"},{"title":"scenarios-superjob.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:27.385Z"}],"logoUrl":null}