По умолчанию ищутся вакансии в открытом доступе. В случае авторизации под работодателем так же ищутся вакансии в открытом доступе, включая архивные.

GET https://api.superjob.ru/2.0/vacancies/?keyword=%D0%91%D1%83%D1%85%D0%B3%D0%B0%D0%BB%D1%82%D0%B5%D1%80&order_field=payment&order_direction=asc&payment_from=10000&payment_to=300000&no_agreement=1&town=4&catalogues=33%2C151%2C11%2C438%2C327%2C306%2C478%2C86&place_of_work=1&moveable=1&agency=1&type_of_work=6&age=30&gender=2&education=2&experience=3&driving_licence%5B0%5D=B&driving_licence%5B1%5D=C&language=1&lang_level=3&languages_particular=1

С расширенным поиском по ключевым словам:

GET https://api.superjob.ru/2.0/vacancies/?keywords%5B0%5D%5Bkeys%5D=&keywords%5B1%5D%5Bsrws%5D=1&keywords%5B1%5D%5Bskwc%5D=and&keywords%5B1%5D%5Bkeys%5D=php&keywords%5B2%5D%5Bsrws%5D=3&keywords%5B2%5D%5Bskwc%5D=particular&keywords%5B2%5D%5Bkeys%5D=javascript

{
    "objects":[
    {
        "id": 25746005,
        "id_client": 544932,
        "payment_from": 0,
        "payment_to": 0,
        "date_pub_to": 1371640666,
        "date_archived": 1371640666,
        "date_published": 1371554266,
        "address": null,
        "payment": null,
        "profession": "Специалист по согласованиям",
        "work": "1. Подготовка, согласование с Комитетами и службами...",
        "metro": [
            {
                "id": 229,
                "title": "Сенная площадь",
                "id_metro_line": 2
            },
            {
                "id": 230,
                "title": "Невский Проспект",
                "id_metro_line": 2
            },
            {
                "id": 538,
                "title": "Адмиралтейская",
                "id_metro_line": 5
            }
        ],
        "currency": "rub",
        "moveable": true,
        "agreement": true,
        "anonymous": false,
        "type_of_work": {
            "id": 6,
            "title": "Полный рабочий день"
        },
        "place_of_work": {
            "id": 1,
            "title": "на территории работодателя"
        },
        "education": {
            "id": 2,
            "title": "Высшее"
        },
        "experience": {
            "id": 3,
            "title": "от 3 лет"
        },
        "maritalstatus": {
            "id": 0,
            "title": "не имеет значения"
        },
        "children": {
            "id": 0,
            "title": "не имеет значения"
        },
        "already_sent_on_vacancy": false,
        "languages": [],
        "driving_licence": [],
        "catalogues":[
            {
                "id":438,
                "title":"Продажи",
                "positions":[
                    {
                        "id":441,
                        "title":"Бытовая техника, электроника, фото, видео"
                    },
                    { // ... }
                ]
            }
        ],
        "agency": {
            "id": 1,
            "title": "Прямой работодатель"
        },
        "town": {
            "id": 14,
            "title": "Санкт-Петербург",
            "declension": "в Санкт-Петербурге",
            "genitive": "Санкт-Петербурга"
        },
        "client_logo": "https://public.superjob.ru/images/clients_logos.ru/544932.gif",
        "age_from": 35,
        "age_to": 45,
        "gender": {
            "id": 3,
            "title": "женский"
        },
        "firm_name": "Комплекс Галерная 5",
        "firm_activity": "ООО «Комплекс Галерная 5» – дочернее общество...",
        "link": "https://www.superjob.ru/vakansii/specialist-po-soglasovaniyam-25746005-130520.html"
    }
    ],
    "total": 1000000,
    "corrected_keyword": "учитель", // Ключ с исправленным словом возвращается
                                    // только в случае ошибки в исходном ключевом слове
    "more":false
}

Параметры объекта в массиве objects

[[{"id":1,"title": "Английский"},{"id":9,"title": "Cвободное владение"}]]

* — поля, доступные после авторизации

** — в случае анонимной вакансии id_client не выдаётся

*** — поля, доступные после авторизации как владельца вакансии или лица, обладающим правом просмотра вакансии или управлением вакансиями

Без авторизации или без явного указания published, показываются только вакансии в открытом доступе.

GET https://api.superjob.ru/2.0/vacancies/100000/

{
    "id":11568334,
    "id_client":14449,
    "date_pub_to":1372409338,
    "date_published":1369817338,
    "profession": "Старший специалист по тестированию",
    //...
}

Параметры объекта см. описание параметров метода /vacancies/

Обновление

PUT /2.0/subscriptions/555/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    keywords%5B0%5D%5Bkeys%5D=%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%B5%D1%80&exclude_words=%D0%B0%D0%BD%D0%B4%D1%80%D1%8E%D1%88%D0%B0&keywords%5B1%5D%5Bkeys%5D=%D0%B8&keywords%5B1%5D%5Bskwc%5D=or&keywords%5B1%5D%5Bsrws%5D=2&period=7&c%5B%5D=22&o%5B%5D=46&o%5B%5D=110&o%5B%5D=1&t%5B%5D=4&t%5B%5D=14&t%5B%5D=479&t%5B%5D=420&t%5B%5D=573&catalogues=12%2C425%2C438%2C600&payment_from=10000&no_agreement=1&experience=5&type_of_work=10&place_of_work=2&age_from=19&gender=2&education=3&language=1&lang_level=5&languages_particular=1&driving_licence%5B0%5D=A&driving_licence%5B1%5D=B&driving_licence%5B2%5D=D&agency=1&moveable=1&active=1&keywords%5B0%5D%5Bskwc%5D=and&keywords%5B0%5D%5Bsrws%5D=10&name=The+Name

{"result": true}

Удаление

DELETE /2.0/hr/subscriptions/555/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

Пустой ответ с кодом 204.

Создание

POST /2.0/hr/subscriptions/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer h.000000000000001.example.token

    keywords%5B0%5D%5Bkeys%5D=%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%B5%D1%80&exclude_words=%D0%B0%D0%BD%D0%B4%D1%80%D1%8E%D1%88%D0%B0&keywords%5B1%5D%5Bkeys%5D=%D0%B8&keywords%5B1%5D%5Bskwc%5D=or&keywords%5B1%5D%5Bsrws%5D=2&period=7&c%5B%5D=22&o%5B%5D=46&o%5B%5D=110&o%5B%5D=1&t%5B%5D=4&t%5B%5D=14&t%5B%5D=479&t%5B%5D=420&t%5B%5D=573&catalogues=12%2C425%2C438%2C600&payment_from=10000&no_agreement=1&experience=3&type_of_work=10&place_of_work=2&age_from=19&gender=2&education=3&language=1&lang_level=5&languages_particular=1&driving_licence%5B0%5D=A&driving_licence%5B1%5D=B&driving_licence%5B2%5D=D&agency=1&moveable=1&active=1&keywords%5B0%5D%5Bskwc%5D=and&keywords%5B0%5D%5Bsrws%5D=10&name=New+subscription

{"id": 100000000}

id созданной подписки

Параметры создания подписки см. здесь.

GET:

{
    "objects":[
            {
                "id": 25746005,
                "name": "Подписка без названия",
                // ...
            }
        ],
    "total": 29,
    "more":true
}

Параметры объекта

Ошибки выводятся в стандартном формате.

GET https://api.superjob.ru/2.0/clients/

{
        "objects":
        [{
        "id": 745208,
        "title": "Владхлеб",
        "link": "https://www.superjob.ru/clients/vladhleb-745208.html",
        "description": "ОАО «Владхлеб», в состав которого входят два хлебозавода...",
        "vacancy_count": 0,
        "staff_count": "> 50",
        "industry": [{"id": 18, "title": "Промышленность, производство, сельское хозяйство"}],
        "client_logo": "https://public.superjob.ru/images/clients_logos.ru/745208.jpg",
        "is_blocked": false
        }],
        "total": 563980,
        "more": true
}

Параметры объекта в массиве objects

GET https://api.superjob.ru/2.0/clients/745208/

{
        "id": 745208,
        "title": "Владхлеб",
        "link": "https://www.superjob.ru/clients/vladhleb-745208.html",
        "description": "ОАО «Владхлеб», в состав которого входят два хлебозавода...",
        "vacancy_count": 0,
        "industry": [{"id": 18, "title": "Промышленность, производство, сельское хозяйство"}],
        "client_logo": "https://public.superjob.ru/images/clients_logos.ru/745208.jpg"
}

Параметры объекта см. описание метода clients.

Блокировка:

POST /2.0/clients/1000000/block/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

{"result": true}

Снятие блокировки:

DELETE /2.0/clients/1000000/block/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token
    

Пустой ответ с кодом 204.

GET https://api.superjob.ru/2.0/clients/block/list/

{
        "objects":
        [{
            "id": 00000,
            "title": "Компания",
            "link": "https://www.superjob.ru/clients/00000.html",
            "description": "ОАО Вектор",
            "vacancy_count": 0,
            "staff_count": "> 50",
            "industry": [{"id": 18, "title": "Промышленность, производство, сельское хозяйство"}],
            "client_logo": "https://public.superjob.ru/images/clients_logos.ru/00000.jpg"
        }],
        "total": 1,
        "more": true
}

Параметры объекта в массиве objects см. описание метода clients.

POST /2.0/user_cvs/update_datepub/25903399/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

{"result": 1378285529}

Если result = unixtime_timestamp (новая дата публикации резюме) - дата публикации резюме обновлена, иначе возвращает ошибку в стандартном формате.

POST /2.0/forgot_password/?email=example@mail.ru HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded

POST /2.0/forgot_password/?phone=79252232311 HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded

{"result": true}

Если result = true - письмо (или СМС) отправлено, иначе возвращает ошибку в стандартном формате.

*Параметры email & phone взаимозаменяемы, т.е. оба поддерживают как email, так и номер телефона. Должен присутствовать хотя бы один из них.

GET https://api.superjob.ru/2.0/user/current

{
        "id":91001102,
        "email": "example@example.ru",
        "phone_number": "7958000000",
        "name": "Name",
        "date_reg":946735314,
        "date_lastlogin":1189074793,
        "id_cv":555,
        "email_confirmed":true,
        "hr": false,
        "autologin": "https://www.superjob.ru/user/autoLogin/ai/555/ak/3520fd71fc2faec024ddace",
        "photo": "https://public.superjob.ru/images/av.ru/555.jpg",
        "is_full_registration": true,
}

Параметры объекта

GET https://api.superjob.ru/1.0/user_cvs/

{
        "objects": [
            {
                "id":1000002,
                "profession": "PHP девелопер с мозгом",
                "payment": 0,
                "currency": "rub",
                "name": "Иван",
                "photo": null
            },
            {
                "id":1000003,
                "profession": "Директор",
                "payment": 30000,
                "currency": "rub",
                "name": "Ян",
                "photo": "https://public.superjob.ru/images/resume_fotos/01/1.jpg"
            }
        ],
        "total": 100,
        "more": false
}

Параметры объекта в массиве objects

Метод выдаёт резюме только в открытом, выборочном и закрытом доступах.

GET https://api.superjob.ru/2.0/user_cvs/

{
        "objects": [
            {
                "id":1111111,
                "id_user":11111110000,
                "last_profession":"Руководитель проекта",
                "payment":200000,
                "currency":"rub",
                "birthday":01,
                "birthmonth":01,
                "birthyear":1979,
                "age":34,
                "metro":[
                    {
                        "id":207,
                        "title":"Балтийская",
                        "id_metro_line":13
                    }
                ],
                "address":"Литейный",
                "citizenship":{
                    "id":1,
                    "title":"Россия"
                },
                "published":{
                    "id":0,
                    "title":"Закрытый доступ"
                },
                "moveable":true,
                "agreement":false,
                "is_archive":false,
                "moveable_towns":[
                    {
                        "id":793,
                        "title":"Таллинн"
                    },
                    {
                        "id":1354,
                        "title":"Город за рубежом"
                    }
                ],
                "type_of_work":{
                    "id":6,
                    "title":"полный рабочий день"
                },
                "place_of_work":{
                    "id":1,
                    "title":"на территории работодателя"
                },
                "education":{
                    "id":2,
                    "title":"Высшее"
                },
                "maritalstatus":{
                    "id":2,
                    "title":"cостоит в браке"
                },
                "children":{
                    "id":3,
                    "title":"есть"
                },
                "business_trip":{
                    "id":0,
                    "title":"не имеет значения"
                },
                "languages":[
                    [
                        {
                        "id":1,
                        "title":"Английский"
                        },
                        {
                        "id":7,
                        "title":"Разговорный"
                        }
                    ],
                    [
                        {
                        "id":2,
                        "title":"Немецкий"
                        },
                        {
                        "id":3,
                        "title":"Базовый"
                        }
                    ]
                ],
                "driving_licence":["B"],
                "catalogues":[
                    {
                        "id":438,
                        "title":"Продажи",
                        "positions":[
                            {
                                "id":441,
                                "title":"Бытовая техника, электроника, фото, видео"
                            },
                            { // ... }
                        ]
                    },
                    { // ... }
                ],
                    {
                        "id":438,
                        "title":"Продажи",
                        "positions":[
                            {
                                "id":445,
                                "title":"Канцелярские товары"
                            },
                            {
                                "id":449,
                                "title":"Мебель"
                            }
                        ]
                    }
                ],
                "town":{
                    "id":14,
                    "title":"Санкт-Петербург",
                    "declension":"в Санкт-Петербурге",
                    "genitive":"Санкт-Петербурга"
                },
                "region":{
                    "id":3,
                    "title":"Центральный округ"
                },
                "work_history":[
                    {
                        "town":null,
                        "name":"НИИ",
                        "profession":"Руководитель проекта",
                        "work":"Работа, подготовка каталога и контента сайта.",
                        "type":{
                            "id":2,
                            "title":"Полная занятость"
                        },
                        "monthbeg":3,
                        "monthend":7,
                        "yearbeg":2006,
                        "yearend":2008
                    },
                    {
                        "town":null,
                        "name":"ООО Вектор",
                        "profession":"Генеральный директор",
                        "work":"Обязанности: контроль и планирование бюджетов. Достижения: рост продаж на 145%",
                        "type":{
                            "id":2,
                            "title":"Полная занятость"
                        },
                        "monthbeg":2,
                        "monthend":6,
                        "yearbeg":2004,
                        "yearend":2006
                    }
                ],
                "base_education_history":[
                    {
                        "institute":{
                            "id":559,
                            "title":"Санкт-Петербургский государственный политехнический университет"
                        },
                        "town":{
                            "id":14,
                            "title":"Санкт-Петербург",
                            "declension":"в Санкт-Петербурге",
                            "genitive":"Санкт-Петербурга"
                        },
                        "faculty":"Физико-механический",
                        "profession":"Аэродинамика",
                        "education_type":{
                            "id":2,
                            "title":"Высшее"
                        },
                        "education_form":{
                            "id":10,
                            "title":"Дневная/Очная"
                        },
                        "yearend":1992
                    }
                ],
                "education_history":[
                    {
                        "institute":"Открытый Университет",
                        "town":{
                            "id":4,
                            "title":"Москва",
                            "declension":"в Москве",
                            "genitive":"Москвы"
                        },
                        "name":"Управление ресурсами",
                        "yearend":2000
                    }
                ],
                "firstname":"Матвей",
                "middlename":"Матвеевич",
                "lastname":"Травкин",
                "phone1":"+ 7 495 984-77-74",
                "timebeg1":08,
                "timeend1":20,
                "phone2":"7(900)000-00-00",
                "timebeg2":8,
                "timeend2":24,
                "email":"matvey@superjob.ru",
                "other_contacts":"skype:superjob.ru",
                "favorite":false,
                "contacts_bought": true,
                "link": "https://www.superjob.ru/resume/cv-12345678.html",
                "short_link": "https://s-j.su/5BwE",
                "social_links":[
                    {
                        "id":1,
                        "title":"Вконтакте",
                        "link":"https:\/\/vk.com\/superjob"
                    },
                    {
                        "id":8,
                        "title":"Github",
                        "link":"https:\/\/github.com\/mygithub"
                    }
                ],
                "gender":{
                    "id":2,
                    "title":"мужской"
                },
                "achievements":"За годы раздумий и тягостный открытий",
                "additional_info":"Человека описать - не поле перейти.",
                "date_published":1387395261,
                "date_last_modified":1387395262,
                "profession":"Руководитель отдела развития",
                "recommendations":"Иванов Иван Иванович, гл. бухгалтер ООО Вектор.",
                "photo": "https://public.superjob.ru/images/img.jpg",
                "photo_sizes":
                    {
                        "small" : "https://public.superjob.ru/images/img1.jpg",
                        "medium" : "https://public.superjob.ru/images/img.jpg",
                        "large" : "https://public.superjob.ru/images/large.jpg"
                    }
            }
        ],
        "more":false,
        "total":5
}

Параметры объекта в массиве objects

[[{"id":1,"title": "Английский"},{"id":9,"title": "Cвободное владение"}]]

Метод выдаёт резюме только в открытом, выборочном и закрытом доступах.

* — поля, доступные после авторизации

GET https://api.superjob.ru/2.0/resumes/555/views/

{
                "objects":
                [
                    {
                        "client":
                            {
                                "id":10000000,
                                "title":"ООО Лютик",
                                "link":"https://www.superjob.ru/clients/some-client-10000000.html",
                                "industry":
                                [
                                    {
                                        "id":17,
                                        "title":"Продажи"
                                    },
                                    {
                                        "id":22,
                                        "title":"Строительство, недвижимость, архитектура"
                                    }
                                ],
                                "description":"Описание компании Лютик",
                                "vacancy_count":2,
                                "client_logo":"https://public.superjob.ru/images/clients_logos.ru/10000000.jpg"
                            },
                        "time":1400056560,
                        "cnt":"1 раз"
                    },
                    {
                        "client":
                            {
                                "id":200000000,
                                "title":"ОАО Вектор",
                                "link":"https://www.0sjob.ru/clients/vectore-200000000.html",
                                "industry":[
                                    {
                                        "id":22,
                                        "title":"Строительство, недвижимость, архитектура"
                                    }
                                ],
                                "description":"Описание ОАО Вектор",
                                "vacancy_count":1,
                                "client_logo":null
                            },
                        "time":1400042160,
                        "cnt":"1 раз"
                    }
                ],
                "total":35,
                "more":true
}

Параметры объекта в массиве objects

GET https://api.superjob.ru/2.0/messages/555/

{
    "objects":[
            {
            "id": 4865603025899,
            "id_resume": 1,
            "id_client": 1474554569658,
            "firm_name": "Компания N",
            "date_sent": 1378110844,
            "subject": "Приглашение на собеседование",
            "body": "Здравствуйте! В настоящее время в нашей организации открыта вакансия.",
            "new": true,
            "status": "invited"
            },
            // ...
            ],
    "total":2,
    "more":false
}

Параметры объекта см. описание параметров метода messages

Для запроса числа новых откликов, используйте метод https://api.superjob.ru/2.0/messages/:id/new/

GET https://api.superjob.ru/2.0/favorites/

{
        "objects":[
            {
                "id": 25746005,
                "favorite": true,
                // ...
            },
            // ...
        ],
        "total":2,
        "more":false
}

Параметры объекта см. описание параметров метода vacancies

Вставка:

POST /2.0/favorites/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

    ids[0]=10000000&ids[1]=100000000001

Удаление:

DELETE /2.0/favorites/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

    ids[0]=10000000&ids[1]=100000000001

PUT и POST:

{"result": true }

Код ответа 201.

DELETE:

Пустой ответ с кодом 204.

Вставка:

POST  /2.0/favorites/10000000/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

Удаление:

DELETE /2.0/favorites/10000000/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

PUT и POST:

{"result": true }

Код ответа 201.

DELETE:

Пустой ответ с кодом 204.

GET https://api.superjob.ru/2.0/messages/list/

{
        "objects":[
            {
                "id_vacancy": 95860000,
                "vacancy":{},
                "id_resume": 1,
                "firm_name": "КЦ",
                "contact_face": "Юлия",
                "date_sent": 1371714282,
                "position_name": "Руководитель управления клиентских отношений и продаж",
                "title": "",
                "body": "",
                "archive":true,
                "storage":false,
                "resume_additional_info": "В архиве",
                "status_text": "просмотрено 01 июля в 10:42",
                "status":0
            },
            {
                "id_vacancy": 95850000,
                "vacancy":{},
                "id_resume": 1,
                "firm_name": "MOTORS",
                "contact_face": "Надежда",
                "date_sent": 1371630601,
                "position_name": "Офис-менеджер",
                "title":null,
                "body": "",
                "archive":true,
                "storage":false,
                "resume_additional_info": "В архиве",
                "status_text": "просмотрено 19 июня в 12:53, резюме отклонено 19 июня в 12:53",
                "status":30
            },
            {
                "id":44773659,
                "id_resume":1,
                "id_client":14449,
                "firm_name": "Портал Superjob.ru",
                "date_sent":1370582567,
                "message":true,
                "subject": "Ваша Кандидатура рассмотрена и отклонена",
                "body": "Здравствуйте, Аноним!",
                "new":false,
                "status":2,
                "status_text": "refused",
                "vacancy":null,
                "resume" : { // Здесь данные отправленного на вакансию резюме }
            }
        ]
        "total":3,
        "more":false
}

GET https://api.superjob.ru/2.0/messages/history/all/

{
        "objects":[
        {
            "id_vacancy":25980000,
            "vacancy":{ // ... },
            "id_resume":1,
            "firm_name": "ТД",
            "contact_face": "Анастасия",
            "date_sent":1378729475,
            "position_name": "Директор сети розничных магазинов",
            "title": "Здравствуйте, Анастасия!",
            "body": "Прошу Вас рассмотреть моё резюме на вакансию Директор сети розничных магазинов.",
            "archive":false,
            "storage":false,
            "resume_additional_info":null,
            "status_text": "ожидает рассмотрения",
            "status":0
            } // ...
        ],
        "total":2,
        "more":false
}

Параметры объекта по ключу vacancy см. описание параметров метода vacancies

GET https://api.superjob.ru/2.0/messages/history/all/555/

Формат ответа см. описание метода messages/history/all/

GET https://api.superjob.ru/2.0/catalogues/

[
        {
            "title_rus":"IT, Интернет, связь, телеком",
            "url_rus":"it-internet-svyaz-telekom",
            "title":"IT, Интернет, связь, телеком",
            "title_trimmed":"IT, Интернет, связь,...",
            "key":33,
            "positions":[
                {
                    "title_rus":"Call Center",
                    "url_rus":"call-center",
                    "title":"Call Center",
                    "id_parent":33,
                    "key":34
                }, // ...
            ]
        },
        {
            "title_rus":"Административная работа, секретариат, АХО",
            "url_rus":"administrativnaya-rabota-sekretariat-aho",
            "title":"Административная работа, секретариат, АХО",
            "title_trimmed":"Административная работа,...",
            "key":1,
            "positions":[
                {
                    "title_rus":"Архивное дело",
                    "url_rus":"arhiv",
                    "title":"Архивное дело",
                    "id_parent":1,
                    "key":3
                }, //...
            ]
        }, // ...
]

GET https://api.superjob.ru/2.0/catalogues/parent/33/

[
    {
        "title_rus":"Call Center",
        "url_rus":"call-center",
        "title":"Call Center",
        "id_parent":33,
        "key":34
    },
    {
        "title_rus":"Web, UI, UX дизайн",
        "url_rus":"web-ui-ux-dizajn",
        "title":"Web, UI, UX дизайн",
        "id_parent":33,
        "key":35
    }, // ...
]

GET https://api.superjob.ru/2.0/catalogues/34/

В случае категории

{
        "title_rus":"Call Center",
        "url_rus":"call-center",
        "title":"Call Center",
        "id_parent":33,
        "key":34
}

или в случае отрасли

{
        "title_rus":"IT, Интернет, связь, телеком",
        "url_rus":"it-internet-svyaz-telekom",
        "title":"IT, Интернет, связь, телеком",
        "title_trimmed":"IT, Интернет, связь,...",
        "key":33,
        "positions":[
            {
            "title_rus":"Call Center",
            "url_rus":"call-center",
            "title":"Call Center",
            "id_parent":33,
            "key":34
            }, // ..
        ]
}

Для обновления или удаления резюме, следует указывать id резюме следующим образом: https://api.superjob.ru/2.0/resumes/555/

На текущий момент API позволяет создавать резюме только уже зарегистрированным пользователям, т.е. тем, у которых есть access_token.

Для вставки и апдейта резюме используется POST-структура следующего вида:

array(
        forms => array(
        ResumeFirstBlockFormModel => array ( ... ),
        ResumeKnowledgeFormModel => array ( ... ),
        ResumeRequirementsFormModel => array ( ... ),
        ResumeExperienceFormModel => array ( ... ),
        ResumeAccessFormModel => array ( ... ),
        )
    )

Ниже будут описаны все возможные поля для каждого блока.

ResumeFirstBlockFormModel

ResumeKnowledgeFormModel

array(
        array('id_language' => 4, 'level' => 1),
        array( ... ),
        // ....
    )

ResumeRequirementsFormModel

ResumeExperienceFormModel

ResumeAccessFormModel

POST /2.0/resumes/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

    forms[ResumeFirstBlockFormModel][socialProfiles][0][link]=example.ru&forms[ResumeFirstBlockFormModel][socialProfiles][0][type_button]=7&forms[ResumeFirstBlockFormModel][firstname]=%D0%9C%D0%B0%D1%82%D0%B2%D0%B5%D0%B9&forms[ResumeFirstBlockFormModel][lastname]=%D0%A2%D1%80%D0%B0%D0%B2%D0%BA%D0%B8%D0%BD&forms[ResumeFirstBlockFormModel][middlename]=%D0%9C%D0%B0%D1%82%D0%B2%D0%B5%D0%B5%D0%B2%D0%B8%D1%87&forms[ResumeFirstBlockFormModel][town]=4&forms[ResumeFirstBlockFormModel][birthday]=2&forms[ResumeFirstBlockFormModel][birthmonth]=8&forms[ResumeFirstBlockFormModel][birthyear]=1986&forms[ResumeFirstBlockFormModel][gender]=3&forms[ResumeFirstBlockFormModel][phones][0][number]=7%28499%29568-56-77&forms[ResumeFirstBlockFormModel][phones][1][number]=7%28926%29000-00-00&forms[ResumeRequirementsFormModel][profession]=%D0%A0%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%87%D0%B8%D0%BA&forms[ResumeRequirementsFormModel][payment]=100000&forms[ResumeRequirementsFormModel][type_of_work]=6&forms[ResumeRequirementsFormModel][place_of_work]=1&forms[ResumeRequirementsFormModel][business_trip]=1&forms[ResumeRequirementsFormModel][catalogues][0]=36&forms[ResumeRequirementsFormModel][catalogues][1]=48&forms[ResumeExperienceFormModel][work_history][0][id_town]=&forms[ResumeExperienceFormModel][work_history][0][name]=%D0%9E%D0%9E%D0%9E+%D0%9B%D1%8E%D1%82%D0%B8%D0%BA&forms[ResumeExperienceFormModel][work_history][0][profession]=%D0%92%D0%B5%D0%B4%D1%83%D1%89%D0%B8%D0%B9+%D0%A0%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%87%D0%B8%D0%BA&forms[ResumeExperienceFormModel][work_history][0][work]=%D0%9A%D0%BE%D0%BD%D1%82%D1%80%D0%BE%D0%BB%D1%8C+%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B0+%D0%9F%D0%9E&forms[ResumeExperienceFormModel][work_history][0][type]=3&forms[ResumeExperienceFormModel][work_history][0][monthbeg]=3&forms[ResumeExperienceFormModel][work_history][0][monthend]=4&forms[ResumeExperienceFormModel][work_history][0][yearbeg]=2012&forms[ResumeExperienceFormModel][work_history][0][yearend]=2014&forms[ResumeExperienceFormModel][work_history][1][id_town]=4&forms[ResumeExperienceFormModel][work_history][1][name]=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&forms[ResumeExperienceFormModel][work_history][1][profession]=%D0%A0%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%87%D0%B8%D0%BA&forms[ResumeExperienceFormModel][work_history][1][work]=%D0%9F%D0%BE%D0%BB%D0%BD%D0%BE%D0%B5+%D1%81%D0%BE%D0%BF%D1%80%D0%BE%D0%B2%D0%BE%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5+%D0%9F%D0%9E&forms[ResumeExperienceFormModel][work_history][1][type]=2&forms[ResumeExperienceFormModel][work_history][1][monthbeg]=3&forms[ResumeExperienceFormModel][work_history][1][monthend]=2&forms[ResumeExperienceFormModel][work_history][1][yearbeg]=2011&forms[ResumeExperienceFormModel][work_history][1][yearend]=2012&forms[ResumeExperienceFormModel][recommendations]=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2+%D0%98.%D0%98.+%2B7%28343%29333-343-343-3&forms[ResumeKnowledgeFormModel][base_education_history][0][institute]=%D0%9C%D0%BE%D1%81%D0%BA%D0%BE%D0%B2%D1%81%D0%BA%D0%B8%D0%B9+%D0%B3%D0%BE%D1%81%D1%83%D0%B4%D0%B0%D1%80%D1%81%D1%82%D0%B2%D0%B5%D0%BD%D0%BD%D1%8B%D0%B9+%D1%83%D0%BD%D0%B8%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D1%82%D0%B5%D1%82+%D0%B8%D0%BC.+%D0%9C.%D0%92.%D0%9B%D0%BE%D0%BC%D0%BE%D0%BD%D0%BE%D1%81%D0%BE%D0%B2%D0%B0&forms[ResumeKnowledgeFormModel][base_education_history][0][id_institute]=3561&forms[ResumeKnowledgeFormModel][base_education_history][0][faculty]=%D0%98%D0%B8%D0%A3&forms[ResumeKnowledgeFormModel][base_education_history][0][profession]=%D0%92%D0%9C%D0%9A%D0%A1%D0%B8%D0%A1&forms[ResumeKnowledgeFormModel][base_education_history][0][education_form]=10&forms[ResumeKnowledgeFormModel][base_education_history][0][education_type]=2&forms[ResumeKnowledgeFormModel][base_education_history][0][yearend]=2008&forms[ResumeKnowledgeFormModel][education_history][0][institute]=%D0%92%D0%9A%D0%9E%D0%9C&forms[ResumeKnowledgeFormModel][education_history][0][town]=%D0%A1%D1%8B%D0%B7%D1%80%D0%B0%D0%BD%D1%8C&forms[ResumeKnowledgeFormModel][education_history][0][name]=%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B5+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5&forms[ResumeKnowledgeFormModel][education_history][0][yearend]=2007&forms[ResumeKnowledgeFormModel][langs][0][id_language]=1&forms[ResumeKnowledgeFormModel][langs][0][level]=5&forms[ResumeKnowledgeFormModel][langs][1][id_language]=61&forms[ResumeKnowledgeFormModel][langs][1][level]=9&forms[ResumeKnowledgeFormModel][driving_licence][0]=B&forms[ResumeKnowledgeFormModel][driving_licence][1]=C&forms[ResumeKnowledgeFormModel][achievements]=MySQL%2C+Python%2C+PHP%2C+CSS%2C+HTML%2C+JavaScript&forms[ResumeKnowledgeFormModel][additional_information]=%D0%A3%D1%87%D0%B0%D1%81%D1%82%D0%B2%D1%83%D1%8E+%D0%B2%D0%BE+%D0%BC%D0%BD%D0%BE%D0%B3%D0%B8%D1%85+%D0%BE%D0%BF%D0%B5%D0%BD%D1%81%D0%BE%D1%80%D1%81%D0%BD%D1%8B%D1%85+%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B0%D1%85+%D0%BD%D0%B0+Github&forms[ResumeAccessFormModel][published]=1

GET:

См. формат данных резюме.

POST:

201 со следующим содержимым:

{"id": 5646546464 }

Формат ошибок можно посмотреть здесь.

Разрешается создавать не более 6-ти резюме. Если при создании резюме в открытом доступе, у того же пользователя обнаружится похожее резюме (совпадает название должности и разделы каталога) так же в открытом доступе, будет выдана ошибка дублирования резюме:

{"error":{"code":422,"message":{"duplicate":true} },"id":"1000000000"}

POST https://api.superjob.ru/2.0/resumes/555/copy/

Ответ содержит id нового резюме

{"id" : 556}

POST /2.0/resumes/25903399/upload/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Authorization: Bearer r.000000000000001.example.token
    Content-Length: 668516
    Expect: 100-continue
    Content-Type: multipart/form-data; boundary=------ba831e1d1ac7

Удачный ответ содержит путь до изображения среднего размера.

{"image":"https:\/\/public.superjob.ru\/images\/resume_fotos\/586\/66\/25858666.medium.jpg"}

DELETE /2.0/resumes/25903399/delete_photo/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Authorization: Bearer r.000000000000001.example.token

Пустой ответ с кодом 204

GET https://api.superjob.ru/2.0/messages/

{
        "objects":[
            {
                "id":47400351,
                "id_resume":899690000,
                "id_client":14449,
                "firm_name": "Портал Superjob.ru",
                "date_sent":1375266678,
                "message":true,
                "subject": "Ваша Кандидатура рассмотрена и отклонена",
                "body": "Здравствуйте, Аноним! Большое спасибо за Ваш интерес к нашей вакансии.",
                "new":false,
                "status":2,
                "status_text": "refused",
                "vacancy":null
            } //, ....
        ],
        "total":12,
        "more":true
}

Параметры объекта в массиве objects

При запросе этого метода обновляется дата последнего просмотра откликов пользователем.

Для запроса числа новых откликов, используйте метод https://api.superjob.ru/2.0/messages/new/

POST /2.0/send_cv_on_vacancy/ HTTP/1.1
    Host: api.superjob.ru
    X-Api-App-Id: yourAppSecretKey
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer r.000000000000001.example.token

    id_cv=25903399&id_vacancy=26747390&comment=The+Test

{"result": true}

При неудаче возвращается стандартная ошибка с описанием:

{
        "error": {
            "code": 403,
            "message": "Вакансия переведена в архив"
        }
}

GET https://api.superjob.ru/2.0/institutes/?keyword=%D0%94%D0%B0%D0%BB%D1%8C&all=1

{
        "objects":[
            {
                "id": 146,
                "title":"(ДВГАИ) Дальневосточная государственная академия искусств"
            },
            {
                "id": 147,
                "title":"(ДВГМУ) Дальневосточный государственный медицинский университет"
            },
            {
                "id": 148,
                "title":"(ДВГТУ) Дальневосточный государственный технический университет имени В.В.Куйбышева"
            }
        ],
        "total":25,
        "more":true
}

Параметры объекта в массиве objects

GET https://api.superjob.ru/2.0/metro/4/lines/

[
    {
        "id":1,
        "title":"Сокольническая",
        "color":"red",
        "stations":[
            {"id":11,"title":"Библиотека им. Ленина"},
            {"id":16,"title":"Воробьёвы горы"}, //.... skipped
        ]
    },
    {
        "id":2,
        "title":"Замоскворецкая",
        "color":"green",
        "stations":[
            {"id":29,"title":"Автозаводская"},
            {"id":540,"title":"Алма-Атинская"}, //.... skipped
        ]
    }
]

GET https://api.superjob.ru/2.0/suggest/town/4/metro/all/?keyword=%D0%A1%D0%BE%D0%BA%D0%BE%D0%BB

{
    "objects":[
        {
            "id": 38,
            "title":"Сокол",
            "line":{
                "id": 2,
                "title":"Замоскворецкая"
            }
        },
        {
            "id": 4,
            "title":"Сокольники",
            "line":{
                "id": 1,
                "title":"Сокольническая"
            }
        }
    ],
    "total":2,
    "more":false
}

Параметры объекта в массиве objects

GET https://api.superjob.ru/2.0/towns/?keyword=%D0%92%D0%BB%D0%B0%D0%B4&all=1&genitive=1

{
    "objects":[
        {
            "id":70,
            "id_region":5,
            "title":"Владивосток",
            "title_eng":"Vladivostok",
            "name_genitive":"Владивостока",
            "name_declension":"во Владивостоке"
        },
        {
            "id":381,
            "id_region":90,
            "title":"Владикавказ",
            "title_eng":"Vladkavkaz",
            "name_genitive":"Владикавказа",
            "name_declension":"в Владикавказе"
        }, // ....
    ],
    "total":5,
    "more":false
}

Параметры объекта в массиве objects

GET https://api.superjob.ru/2.0/towns/geoip/?ip=91.207.146.38

{
    "id":426,
    "id_region":112,
    "id_country":1,
    "title":"Севастополь"
}

Параметры объекта аналогичны /towns/.

GET https://api.superjob.ru/2.0/regions/?keyword=%D0%90%D0%BB%D1%82%D0%B0%D0%B9%D1%81%D0%BA%D0%B8%D0%B9

{
    "objects": [
        {
            "id":1,
            "id_country":1,
            "title": "Алтайский край"
        }
    ],
    "total": 1,
    "more": false
}

Параметры объекта в массиве objects

GET https://api.superjob.ru/2.0/regions/combined/

[
        {
            "id":1,
            "title":"Россия",
            "towns":
            [
                {
                    "id":4,
                    "title":" Москва",
                    "id_country":1,
                    "id_region":0
                },
                {
                    "id":14,
                    "title":" Санкт-Петербург",
                    "id_country":1,
                    "id_region":0
                }
            ],
            "regions":
            [
                {
                    "id":46,
                    "title":"Московская область",
                    "id_country":1,
                    "towns":[
                        {
                            "id":2176,
                            "title":"Алабино",
                            "id_country":1,
                            "id_region":46
                        }, //...
                    ]
                }, //...
            ],
        }, //...

Описание структуры

Структура есть массив, каждый элемент которого есть объект страны, в котором так же могут быть ещё два объекта:
regions — список областей
towns — список городов
Кроме того, объект regions так же содержит свой собственный объект towns.

GET https://api.superjob.ru/2.0/countries/

{
        "objects": [
            {
                "id":1,
                "title": "Россия"
            },
            {
                "id":9,
                "title": "Украина"
            }, //....
        ],
        "total": 18,
        "more": true
}

Параметры объекта в массиве objects

GET https://api.superjob.ru/2.0/references/

{
        "place_of_work":{
            "0":"не имеет значения",
            "1":"на территории работодателя",
            "2":"на дому",
            "3":"разъездного характера"
        },
        "type_of_work":{
            "0":"не имеет значения",
            "6":"полный рабочий день",
            "7":"временная работа / freelance",
            "9":"работа вахтовым методом",
            "10":"неполный рабочий день",
            "12":"сменный график работы",
            "13":"частичная занятость"
        },
        "education":{
            "0":"Не имеет значения",
            "2":"Высшее",
            "3":"Неполное высшее",
            "4":"Среднее специальное",
            "5":"Среднее",
            "6":"Учащийся школы"
        },
        "experience":{
            "1":"без опыта",
            "2":"от 1 года",
            "3":"от 3 лет",
            "4":"от 6 лет"
        },
        "language":{
            "0":"Не имеет значения",
            "1":"Английский",
            "2":"Немецкий",
            "3":"Французский"  // ...
        },
        "lang_level":{
            "0":"Не имеет значения",
            "3":"Базовый",
            "5":"Технический",
            "7":"Разговорный",
            "9":"Свободно владею"
        },
        "language_resume":{
            "1":"Английский",
            "2":"Немецкий",
            "3":"Французский" // ....
        },
        "lang_level_resume":{
            "3":"Базовый",
            "5":"Технический",
            "7":"Разговорный",
            "9":"Свободно владею"
        },
        "maritalstatus":{
            "0":"не имеет значения",
            "2":"cостоит в браке",
            "3":"не состоит в браке"
        },
        "maritalstatus_resume":{
            "2":"состою в браке",
            "3":"не состою в браке"
        },
        "maritalstatus_resume_gender":{
            "2":{
                "2":"Женат",
                "3":"Замужем"
            },
            "3":{
                "2":"Не женат",
                "3":"Не замужем"
            }
        },
        "children":{
            "0":"не имеет значения",
            "2":"нет",
            "3":"есть"
        },
        "children_resume":{
            "2":"детей нет",
            "3":"дети есть"
        },
        "agency":{
            "1":"Прямой работодатель",
            "2":"Кадровое агентство",
            "3":"Аутсорсинг/аутстаффинг"
        },
        "gender":{
            "0":"Не имеет значения",
            "2":"Мужской",
            "3":"Женский"
        },
        "gender_resume":{
            "2":"мужской",
            "3":"женский"
        },
        "currency":{
            "0":"rub",
            "1":"uah",
            "2":"uzs"
        },
        "education_form_resume":{
            "10":"Дневная/Очная",
            "20":"Вечерняя",
            "30":"Очно-заочная",
            "40":"Заочная",
            "50":"Экстернат",
            "60":"Дистанционная"
        },
        "education_type_resume":{
            "2":"Высшее",
            "3":"Неполное высшее",
            "4":"Среднее специальное",
            "5":"Среднее",
            "6":"Учащийся школы",
            "7":"  Бакалавр",
            "8":"  Магистр",
            "9":"  Кандидат наук",
            "10":"  Доктор наук"
        },
        "work_type":{
            "2":"Полная занятость",
            "3":"Частичная занятость",
            "4":"Временная"
        },
        "citizenship":{
            "1":"Россия",
            "9":"Украина",
            "10":"Беларусь",
            "11":"Молдова",
            "12":"Грузия",
            "13":"Армения",
            "14":"Азербайджан",
            "15":"Казахстан",
            "16":"Узбекистан",
            "17":"Таджикистан",
            "18":"Кыргызстан",
            "19":"Туркменистан",
            "20":"Латвия",
            "21":"Литва",
            "22":"Эстония",
            "23":"Абхазия",
            "24":"Южная Осетия",
            "1000":"Дальнее зарубежье"
        },
        "moveable":{
            "1": "живет в регионе или готов к переезду куда-либо",
            "2": "живет в регионе или готов к переезду в него",
            "3": "не живет в регионе, но готов к переезду в него",
            "4": "живет в регионе"
        },
        "business_trip":{
            "0":"не имеет значения",
            "1":"не готов",
            "2":"готов"
        },
        "published_resume":{
            "0":"Закрытый доступ",
            "1":"Открытый доступ",
            "4":"Отказано в публикации",
            "10":"Выборочный доступ",
            "100":"Черновик"
        },
        "social_links_resume":{
            "1":"Вконтакте",
            "2":"Твиттер",
            "3":"Фейсбук",
            "4":"Линкедин",
            "6":"Гугл",
            "7":"Личный сайт",
            "8":"Github",
            "9":"Яндекс",
            "10":"Mail.RU",
            "14":"Apple ID",
            "15":"Telegram",
            "16":"Яндекс Дзен",
            "17":"YouTube",
            "18":"Alfa id",
            "19":"Vk id",
            "20":"Viber",
            "21":"Whatsapp",
        },
        "period": {
            "0":"все время",
            "1":"24 часа",
            "3":"3 дня",
            "7":"неделю",
            "14":"2 недели",
            "30":"1 месяц",
            "60":"2 месяца"
        }
}

Значения справочников