Skip to content
Permalink
master
Switch branches/tags
Go to file
 
 
Cannot retrieve contributors at this time

Поиск резюме

employer with paid access : Методы доступны только для работодателей и требуют наличия платного доступа для работодателя

Смотрите также:

Запрос

GET /resumes вернёт результаты поиска резюме.

Некоторые параметры принимают множественные значения: key=value&key=value.

Внимание! Неизвестные параметры и параметры с ошибкой в названии игнорируются.

  • text — поисковая фраза. Найдет резюме, в которых встречаются все слова заданной фразы. Возможно указание нескольких значений. Каждый дополнительный text уточняет поиск. В качестве поисковой фразы можно использовать язык поисковых запросов. Специально для этого поля есть автодополнение. Для тонкой настройки по фразе можно использовать параметры text.logic, text.field, text.period. При использовании дополнительных text.* полей, необходимо указывать весь набор (триаду) параметров.

  • text.logic – описывает, как производится поиск. Справочник с возможными значениями: resume_search_logic в /dictionaries.

  • text.field – описывает, где должны встречаться слова из поисковой фразы text. В параметре text.field можно укзать несколько значений через запятую, например – ?text.field=education,keywords. Справочник с возможными значениями: resume_search_fields в /dictionaries.

  • text.period – период для поиска в опыте работы. Параметр имеет смысл только для text.field равного одному из: experience, experience_company, experience_position, experience_description, но указывать его необходимо всегда при указании других text.*. В этом случае он может быть пустым.

  • age_from, age_to — возраст соискателя в годах, диапазон от и до. Обратите внимание, по умолчанию в выдачу добавляются так же резюме с неуказанным возрастом, для выдачи резюме только с указанным возрастом используйте специальный label "only_with_age"

  • area — регион. Справочник с возможными значениями: /areas. Можно указать несколько значений. По умолчанию выбираются резюме, в которых соискатели живут в указанных регионах или готовы в них переехать, поменять это поведение можно указанием поля relocation.

  • relocation — готовность к переезду. Справочник с возможными значениями: resume_search_relocation в /dictionaries. Необходимо указывать вместе с параметром area.

  • period — в днях, ищет резюме опубликованные за указанный период. Если не указан, поиск ведется без ограничений по дате публикации.

  • date_from – дата, от которой нужно начать поиск. Значение указывается в формате ISO 8601 - YYYY-MM-DD или с точность до секунды YYYY-MM-DDThh:mm:ss±hhmm. Нельзя передавать вместе с параметром period.

  • date_to – дата, до которой нужно искать. Значение указывается в формате ISO 8601 - YYYY-MM-DD или с точность до секунды YYYY-MM-DDThh:mm:ss±hhmm. Можно передавать только в паре с параметром date_from. Нельзя передавать вместе с параметром period.

  • education_level — уровень образования. Справочник с возможными значениями: education_level в /dictionaries. Если не указан, поиск ведется без ограничений на уровень образования.

  • employment — тип занятости. Справочник с возможными значениями: employment в /dictionaries. Можно указать несколько значений.

  • experience — опыт работы. Справочник с возможными значениями: experience в /dictionaries.

  • skill - ключевые навыки. Указывается один или несколько идентификаторов ключевых навыков. Значения можно получить из поля id в подсказке по ключевым навыкам.

  • gender — пол. Справочник с возможными значениями: gender в /dictionaries. По умолчанию вне зависимости от значения параметра будут найдены резюме, в которых пол не указан, убрать такие резюме можно с помощью label=only_with_gender.

  • label — дополнительный фильтр. Справочник с возможными значениями: resume_search_label в /dictionaries. Можно указать несколько значений.

  • language — знание языка. Можно указать несколько значений. Задается в формате language.level, где:

    • language — значение из справочника /languages,
    • level — значение из справочника language_level /dictionaries.
  • metro — линия, либо станция метро. Справочник с возможными значениями: /metro.

  • currency — код валюты. Справочник с возможными значениями: currency (ключ code) в /dictionaries.

  • salary_from, salary_to — диапазон желаемой заработной платы (ЗП), от и до. Обратите внимание, по умолчанию в выдачу добавляются так же резюме с неуказанной ЗП, для выдачи резюме только с указанной ЗП используйте специальный label "only_with_salary"

  • schedule — график работы. Справочник с возможными значениями: schedule в /dictionaries. Можно указать несколько значений.

  • specialization — профобласть или специализация. Справочник с возможными значениями: /specializations. Можно указать несколько значений. Будет заменен профессиональными ролями (параметр professional_role), в настоящее время работает в режиме обратной совместимости.

  • order_by — сортировка списка резюме. Справочник с возможными значениями: resume_search_order в /dictionaries.

  • citizenship — страна желаемого гражданства. Возможные значения можно посмотреть в справочнике стран. Возможно указание нескольких значений.

  • work_ticket — страна, в которой есть разрешение на работу. Возможные значения можно посмотреть в справочнике стран. Возможно указание нескольких значений.

  • educational_institution – учебные заведения соискателя. В качестве параметров используются подсказки по названиям университетов /suggests/educational_institutions. Возможно указание нескольких значений.

  • search_in_responsestrue: искать только по резюме, которыми соискатели откликались на вакансии компании текущего пользователя, false: искать по всем резюме. Если параметр не указан, по умолчанию используется поиск по всем резюме.

  • by_text_prefixtrue: включает поиск по префиксу. Для каждого параметра text будут находиться не только полные совпадения слов, но еще и слова, начинающиеся с text. По умолчанию стоит значение false.

  • driver_license_types — категории водительских прав. Справочник с возможными значениями: driver_license_types в /dictionaries.

  • vacancy_id — идентификатор вакансии для поиска похожих резюме. Необходимо передавать идентификатор активной или архивной вакансии работодателя.

  • per_page — количество результатов на страницу (не может превышать 50).

  • page — номер страницы.

  • professional_role — профессиональная роль. Элемент справочника professional_roles. Можно указать несколько значений. Замена специализациям (параметр specialization)

  • folder — один или несколько идентификаторов папок с отобранными резюме. Если данный параметр передан, поиск будет ограничен содержимым указанных папок. Можно передавать идентификаторы нескольких папок, например: folder=111&folder=222&folder=333

  • include_all_folders — признак, указывающий, нужно ли вести поиск по всем папкам с отобранными резюме. Если у менеджера есть доступ к избранным папкам, то поиск проходит по умолчанию в избранных папках. Если передать параметр include_all_folders=false, то поиск не будет ограничен папками. Если будут переданы параметры folder и include_all_folders в одном запросе, вернется ошибка 400 Bad Request.

При указании параметров пагинации (page, per_page) работает ограничение: глубина возвращаемых результатов не может быть больше 2000. Например, возможен запрос per_page=10&page=199 (выдача с 1991 по 2000 резюме), но запрос с per_page=10&page=200 вернёт ошибку (выдача с 2001 до 2010 резюме).

Примеры запросов:

  • GET /resumes?text=программист – найдет все резюме, в любом месте которого встречается заданное слово 'программист'.

  • GET /resumes?text=программист&text=java – найдет резюме, в любом месте которого встречаются слова 'программист' и 'java'.

  • GET /resumes?text=программист%20java&text.logic=any&text.field=everywhere&text.period=all_time – найдет резюме, в любом месте которого встречается любое из слов заданной фразы в параметре text ('программист' или 'java'). При использовании дополнительных полей, они должны быть указаны все.

  • GET /resumes?text=Headhunter&text.logic=all&text.field=experience&text.period=last_three_years – найдет все резюме, в опыте работы которых за последние 3 года встречается 'Headhunter'.

  • GET /resumes?text=менеджер%20проекта&text.logic=all&text.field=experience%2Cskills&text.period=last_year&text=ответственный&text.logic=all&text.field=everywhere&text.period=all_time – найдет все резюме, в опыте работы за последний год и ключевых навыках которых встречаются слова 'менеджер' и 'проекта', а также слово 'ответственный' в любом месте резюме. Отметим, что дополнительные параметры text.logic=all&text.field=experience%2Cskills&text.period=last_year указаны для text=менеджер%20проекта, а text.logic=all&text.field=everywhere&text.period=all_time для параметра text=ответственный.

Ответ

Успешный ответ приходит с кодом 200 OK и содержит тело:

{
    "found": 2099341,
    "per_page": 20,
    "page": 0,
    "pages": 250,
    "items": [
        {
            "id": "0123456789abcdef",
            "title": "Начинающий специалист",
            "url": "https://api.hh.ru/resumes/0123456789abcdef",
            "first_name": "Иван",
            "last_name": "Иванов",
            "middle_name": "Иванович",
            "can_view_full_info": true,
            "age": 19,
            "alternate_url": "http://hh.ru/resume/0123456789abcdef",
            "created_at": "2015-02-06T12:00:00+0300",
            "updated_at": "2015-04-20T16:24:15+0300",
            "area": {
                "id": "1",
                "name": "Москва",
                "url": "https://api.hh.ru/areas/1"
            },
            "certificate": [
                {
                    "achieved_at": "2015-01-01",
                    "owner": null,
                    "title": "тест",
                    "type": "custom",
                    "url": "http://example.com/"
                }
            ],
            "education": {
                "primary": [
                    {
                        "name": "Российский государственный социальный университет, Москва",
                        "name_id": "39420",
                        "organization": "Факультет информационных технологий",
                        "organization_id": null,
                        "result": "Информатика",
                        "result_id": null,
                        "year": 2012
                    }
                ]
            },
            "total_experience": {
                "months": 118
            },
            "experience": [
                {
                    "position": "пастух",
                    "start": "2010-01-01",
                    "end": null,
                    "company": "Рога и копыта",
                    "industries": [
                        {
                            "id": "51.643",
                            "name": "Благоустройство и уборка территорий и зданий"
                        },
                        {
                            "id": "29.503",
                            "name": "Земледелие, растениеводство, животноводство"
                        }
                    ],
                    "company_url": "http://example.com/",
                    "area": {
                        "id": "1",
                        "name": "Москва",
                        "url": "https://api.hh.ru/areas/1"
                    },
                    "company_id": null,
                    "employer": null
                },
                {
                    "start": "2005-01-01",
                    "end": "2009-03-01",
                    "company": "HeadHunter",
                    "area": {
                        "id": "1",
                        "name": "Москва",
                        "url": "https://api.hh.ru/areas/1"
                    },
                    "industries": [
                        {
                            "id": "7.513",
                            "name": "Интернет-компания (поисковики, платежные системы, соц.сети, информационно-познавательные и развлекательные ресурсы, продвижение сайтов и прочее)"
                        }
                    ],
                    "company_url": "http://hh.ru",
                    "company_id": "1455",
                    "employer": {
                        "alternate_url": "http://hh.ru/employer/1455",
                        "id": "1455",
                        "logo_urls": {
                            "90": "http://hh.ru/employer/logo/1455"
                        },
                        "name": "HeadHunter",
                        "url": "https://api.hh.ru/employers/1455"
                    }
                }
            ],
            "gender": {
                "id": "male",
                "name": "Мужской"
            },
            "salary": {
                "amount": 1000000,
                "currency": "RUR"
            },
            "photo": {
                "medium": "http://hh.ru/...",
                "small": "http://hh.ru/...",
                "id": "1337"
            },
            "owner": {
                "comments": {
                    "url": "https://api.hh.ru/applicant_comments/123456",
                    "counters": {
                        "total": 7
                    }
                }
            },
            "negotiations_history": {
                "url": "https://api.hh.ru/resumes/0123456789abcdef/negotiations_history"
            },
            "last_negotiation": {
                "employer_state": {
                    "id": "offer",
                    "name": "Предложение о работе"
                },
                "created_at": "2017-08-10T13:09:28+0300"
            },
            "job_search_status": {
                "id": "active_search",
                "name": "В активном поиске работы"
            }
        }
    ]
}

Поля резюме аналогичны полям при редактировании резюме.

Контактная информация (ФИО) будет присутствовать только после открытия контактой информации в резюме

Для получения полной информации необходимо запросить полное резюме. У соискателя запрос резюме будет отражён в истории просмотров.

Настройки вывода полей в поиске резюме на сайте не влияют на выдачу в API.

Возвращаемые результаты группируются по соискателю: один и тот же соискатель не может вернуться в выборке несколько раз. Если у соискателя есть несколько резюме, которые подходят под запрос, то только одно из его резюме вернется в качестве элемента в массиве items. Поле found содержит количество найденных соискателей. per_page работает по этому полю.

Резюме выводится не целиком. В объекте опыта отсутствует описание (поле description), а также должность (поле position) доступна только в последнем опыте. Образование выводится только основное.

Поле job_search_status статус поиска работы можно получить, используя параметр with_job_search_status=true.

Дополнительно работодателю выдаются следующие поля:

Ошибки

  • 400 Bad Request — в случае ошибки в переданных полях.
  • 403 Forbidden — ошибка авторизации или отсутствие доступа у работодателя. Дополнительно к коду могут вернуться причины ошибки.