{ "openapi": "3.0.1", "info": { "title": "hh.kz Вакансии и зарплаты Казахстана | Jobs & Salary Scraper", "description": "Вакансии hh.kz (HeadHunter Казахстан) на 3 уровнях: обзор, подробности, анализ зарплат с рынком stats.hh.kz. Scrape hh.kz jobs with salaries and market benchmarks.", "version": "0.0", "x-build-id": "y737hpqAf3MewAC36" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/berkify~hh-kz-vakansii-zarplaty/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-berkify-hh-kz-vakansii-zarplaty", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/berkify~hh-kz-vakansii-zarplaty/runs": { "post": { "operationId": "runs-sync-berkify-hh-kz-vakansii-zarplaty", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/berkify~hh-kz-vakansii-zarplaty/run-sync": { "post": { "operationId": "run-sync-berkify-hh-kz-vakansii-zarplaty", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keyword": { "title": "Ключевое слово / Keyword", "type": "string", "description": "Должность, навык или компания — как в поиске hh.kz (любой язык: русский, казахский, английский). Пусто = все вакансии. / Free-text search as on hh.kz, any language. Empty = all jobs." }, "cities": { "title": "Города и области / Cities and regions", "type": "array", "description": "Где искать (код региона hh). «Казахстан» = вся страна. Можно выбрать несколько. / Where to search (hh area id). \"Казахстан\" = whole country. Multiple allowed.", "items": { "type": "string", "enum": [ "40", "160", "159", "205", "177", "154", "187", "181", "194", "185", "153", "172", "174", "193", "180", "152", "190", "192", "188", "198", "176", "166", "17951", "17952", "17953", "17954", "17955", "17956", "17957", "17958", "17959", "17960", "17961", "17962", "17963", "17964", "17965", "17966", "17967" ], "enumTitles": [ "Казахстан (вся страна)", "Алматы", "Астана", "Шымкент", "Караганда", "Актобе", "Тараз", "Павлодар", "Усть-Каменогорск", "Семей", "Атырау", "Костанай", "Кызылорда", "Уральск", "Петропавловск", "Актау", "Темиртау", "Туркестан", "Талдыкорган", "Экибастуз", "Кокшетау", "Жезказган", "Абайская область", "Акмолинская область", "Актюбинская область", "Алматинская область", "Атырауская область", "Восточно-Казахстанская область", "Жамбылская область", "Жетысуская область", "Западно-Казахстанская область", "Карагандинская область", "Костанайская область", "Кызылординская область", "Мангистауская область", "Павлодарская область", "Северо-Казахстанская область", "Туркестанская область", "Улытауская область" ] }, "default": [ "160" ] }, "detailLevel": { "title": "Уровень данных / Data level", "enum": [ "list", "details", "full" ], "type": "string", "description": "Краткий обзор = данные из выдачи поиска (самый дешёвый). Подробности = + страница вакансии и компании. Анализ зарплат = + сравнение с рынком (stats.hh.kz). / list = search results only; details = + job and employer pages; full = + market salary benchmark.", "default": "details" }, "maxItems": { "title": "Максимум вакансий / Max jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Сколько вакансий сохранить. Оплата — за каждую сохранённую вакансию. / How many jobs to save (you pay per saved job).", "default": 100 }, "sort": { "title": "Сортировка / Sort", "enum": [ "relevance", "newest" ], "type": "string", "description": "По соответствию — как hh.kz по умолчанию: первые вакансии самые подходящие (лучше для небольшого maxItems). Сначала новые — по дате публикации; так листается без потерь. Если maxItems ≥ числу найденных, actor сам листает по дате, чтобы собрать всё. / relevance = hh default ranking (best for small maxItems); newest = by publication date (lossless paging; used automatically when maxItems ≥ total).", "default": "relevance" }, "excludePersonEmployers": { "title": "Без работодателей — частных лиц / Exclude person-name employers", "type": "boolean", "description": "Не сохранять (и не оплачивать) вакансии, где работодатель — частное лицо или в названии компании ФИО человека (ИП и т. п.). / Skip (and do not charge) jobs whose employer is a private person or whose company name is a person's full name.", "default": false }, "experience": { "title": "Опыт работы / Experience", "type": "array", "description": "Фильтр hh «Опыт работы» (experience). Пусто = любой. / hh experience filter. Empty = any.", "items": { "type": "string", "enum": [ "noExperience", "between1And3", "between3And6", "moreThan6" ], "enumTitles": [ "Нет опыта", "От 1 года до 3 лет", "От 3 до 6 лет", "Более 6 лет" ] } }, "workFormat": { "title": "Формат работы / Work format", "type": "array", "description": "Фильтр hh «Формат работы» (work_format). / hh work format filter (on-site, remote, hybrid, field work).", "items": { "type": "string", "enum": [ "ON_SITE", "REMOTE", "HYBRID", "FIELD_WORK" ], "enumTitles": [ "На месте работодателя", "Удалённо", "Гибрид", "Разъездной" ] } }, "workSchedule": { "title": "График / Schedule", "type": "array", "description": "Фильтр hh «График» (work_schedule_by_days). / hh working-days schedule filter.", "items": { "type": "string", "enum": [ "FIVE_ON_TWO_OFF", "SIX_ON_ONE_OFF", "TWO_ON_TWO_OFF", "THREE_ON_THREE_OFF", "FOUR_ON_FOUR_OFF", "FOUR_ON_THREE_OFF", "FOUR_ON_TWO_OFF", "THREE_ON_TWO_OFF", "TWO_ON_ONE_OFF", "ONE_ON_THREE_OFF", "ONE_ON_TWO_OFF", "WEEKEND", "FLEXIBLE", "OTHER" ], "enumTitles": [ "5/2", "6/1", "2/2", "3/3", "4/4", "4/3", "4/2", "3/2", "2/1", "1/3", "1/2", "По выходным", "Свободный", "Другое" ] } }, "employment": { "title": "Тип занятости / Employment", "type": "array", "description": "Фильтр hh «Тип занятости» (employment_form). / hh employment type filter.", "items": { "type": "string", "enum": [ "FULL", "PART", "PROJECT", "FLY_IN_FLY_OUT", "SIDE_JOB" ], "enumTitles": [ "Полная занятость", "Частичная занятость", "Проект или разовое задание", "Вахта", "Подработка" ] } }, "onlyWithSalary": { "title": "Только с указанной зарплатой / Only with salary", "type": "boolean", "description": "Только вакансии, где указан доход (hh: only_with_salary=true). / Only jobs that show a salary.", "default": false }, "salaryFrom": { "title": "Зарплата от, ₸ / Salary from, KZT", "minimum": 0, "type": "integer", "description": "Уровень дохода от (hh: salary + currency=KZT). Как на сайте, без галочки «только с зарплатой» hh показывает и вакансии без зарплаты. / Minimum salary in KZT (hh salary filter)." }, "period": { "title": "Опубликовано за / Posted within", "enum": [ "1", "3", "7", "30" ], "type": "string", "description": "Только вакансии за последние N дней (hh: search_period). Пусто = за всё время. / Only jobs posted in the last N days." }, "professionalRoles": { "title": "Профессиональные роли / Professional roles", "type": "array", "description": "Фильтр hh «Профессиональная роль» (professional_role). Необязательно. / Optional hh professional role filter.", "items": { "type": "string", "enum": [ "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "175", "150", "17", "159", "176", "154", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "165", "32", "33", "34", "35", "36", "37", "38", "166", "39", "40", "41", "42", "43", "177", "174", "44", "45", "46", "47", "178", "179", "48", "169", "144", "50", "51", "180", "52", "53", "158", "149", "54", "55", "56", "57", "181", "58", "168", "59", "163", "60", "61", "162", "62", "63", "64", "65", "182", "66", "183", "153", "67", "68", "69", "70", "71", "72", "73", "74", "75", "76", "77", "167", "155", "152", "173", "184", "78", "185", "79", "80", "81", "82", "186", "84", "187", "85", "86", "83", "87", "88", "89", "90", "91", "92", "93", "94", "95", "96", "97", "164", "98", "99", "100", "101", "102", "103", "104", "157", "105", "172", "170", "171", "106", "188", "107", "189", "108", "161", "194", "109", "110", "111", "112", "113", "148", "114", "115", "190", "191", "147", "116", "117", "118", "151", "119", "120", "121", "193", "122", "192", "123", "124", "125", "126", "49", "127", "128", "129", "130", "131", "132", "133", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "145", "146", "156", "160", "1", "2", "3" ], "enumTitles": [ "Автомойщик", "Автослесарь, автомеханик", "Агент по недвижимости", "Агроном", "Администратор", "Администратор магазина, администратор торгового зала", "Аналитик", "Андеррайтер", "Арт-директор, креативный директор", "Артист, актер, аниматор", "Архитектор", "Ассистент врача", "Аудитор", "Бетонщик, арматурщик, каменщик", "Бизнес-аналитик", "Бизнес-тренер", "Бортпроводник", "Бренд-менеджер", "Брокер", "Бухгалтер", "Ветеринарный врач", "Видеооператор, видеомонтажер", "Водитель, экспедитор", "Военнослужащий", "Воспитатель, няня", "Врач", "Гейм-дизайнер", "Генеральный директор, исполнительный директор (CEO)", "Геодезист", "Геолог", "Главный врач, заведующий отделением", "Главный инженер проекта", "Грузчик", "Дата-сайентист", "Дворник", "Делопроизводитель, архивариус", "Дизайнер, художник", "Директор магазина, директор сети магазинов", "Директор по информационным технологиям (CIO)", "Директор по маркетингу и PR (CMO)", "Директор по персоналу (HRD)", "Директор юридического департамента (CLO)", "Диспетчер", "Другое", "Журналист, корреспондент", "Заведующий аптекой", "Зоотехник", "Инженер КИПиА", "Инженер ПНР", "Инженер по качеству", "Инженер по охране труда и технике безопасности, инженер-эколог", "Инженер по эксплуатации", "Инженер ПТО, инженер-сметчик", "Инженер слаботочных систем/Инженер связи", "Инженер строительного контроля", "Инженер-конструктор, инженер-проектировщик", "Инженер-электроник, инженер-электронщик", "Инженер-энергетик, инженер-электрик", "Казначей", "Кассир-операционист", "Категорийный менеджер", "Кладовщик, Приемщик товаров", "Коммерческий директор (CCO)", "Комплаенс-менеджер", "Контролёр ОТК", "Координатор отдела продаж", "Копирайтер, редактор, корректор", "Косметолог", "Кредитный специалист", "Куратор/тьютор обучения", "Курьер, Почтальон", "Лаборант", "Маляр, штукатур, отделочник", "Маркетолог-аналитик", "Массажист", "Мастер ногтевого сервиса", "Мастер по ремонту оборудования, техники", "Мастер-приемщик", "Машинист", "Медицинская сестра, медицинский брат", "Медицинский представитель", "Менеджер маркетплейсов", "Менеджер по закупкам", "Менеджер по качеству", "Менеджер по компенсациям и льготам", "Менеджер по логистике, менеджер по ВЭД, начальник транспортного отдела", "Менеджер по маркетингу, интернет-маркетолог", "Менеджер по персоналу", "Менеджер по продажам, менеджер по работе с клиентами", "Менеджер по работе с партнерами", "Менеджер по туризму", "Менеджер продукта", "Менеджер ресторана", "Менеджер/консультант по стратегии", "Менеджер/руководитель АХО", "Мерчандайзер", "Методист", "Методолог", "Метролог", "Механик", "Мойщик посуды, Помощник повара", "Монтажник", "Монтер пути", "Научный специалист, исследователь", "Начальник производства, Главный инженер производства", "Начальник склада", "Начальник смены, мастер участка", "Обвальщик/Мясник", "Оператор ПК, оператор базы данных", "Оператор почтовой связи", "Оператор производственной линии, Кочегар/Оператор котельной", "Оператор станков с ЧПУ", "Оператор call-центра, специалист контактного центра", "Операционный директор (COO)", "Офис-менеджер", "Официант, бармен, бариста", "Охранник", "Оценщик", "Парикмахер", "Переводчик", "Повар, пекарь, кондитер", "Полицейский", "Программист, разработчик", "Продавец-консультант, продавец-кассир", "Продуктовый аналитик", "Продюсер", "Промоутер", "Прораб, мастер СМР", "Психолог", "Разнорабочий", "Режиссер, сценарист", "Руководитель группы разработки", "Руководитель отдела аналитики", "Руководитель отдела клиентского обслуживания", "Руководитель отдела логистики", "Руководитель отдела маркетинга и рекламы", "Руководитель отдела персонала", "Руководитель отдела продаж", "Руководитель отдела страхования и кредитования", "Руководитель проектов", "Руководитель службы эксплуатации", "Руководитель строительного проекта", "Руководитель филиала", "Санитарка/санитар", "Сварщик", "Секретарь, помощник руководителя, ассистент", "Сервисный инженер, инженер-механик", "Сетевой инженер", "Системный администратор", "Системный аналитик", "Системный инженер", "Слесарь, сантехник", "Сотрудник пункта выдачи заказов", "Сотрудник ресторана быстрого питания", "Специалист по взысканию задолженности", "Специалист по информационной безопасности", "Специалист по кадрам", "Специалист по подбору персонала", "Специалист по сертификации", "Специалист по тендерам", "Специалист службы безопасности", "Специалист технической поддержки", "Столяр, плотник", "Страховой агент", "Стропальщик, Такелажник", "Супервайзер", "Тестировщик", "Технический директор (CTO)", "Технический писатель", "Технолог", "Товаровед", "Токарь, фрезеровщик, шлифовщик", "Торговый представитель", "Уборщица, уборщик", "Упаковщик, комплектовщик, маркировщик", "Учитель, преподаватель, педагог", "Фармацевт-провизор", "Финансовый аналитик, инвестиционный аналитик", "Финансовый директор (CFO)", "Финансовый контролер", "Финансовый менеджер", "Фитнес-тренер, инструктор тренажерного зала", "Фотограф, ретушер", "Хостес", "Швея, портной, закройщик", "Экономист", "Электромонтажник, электромонтер, техник-электрик", "Юрисконсульт", "Юрист", "BI-аналитик, аналитик данных", "DevOps-инженер", "Event-менеджер", "PR-менеджер", "SMM-менеджер, контент-менеджер" ] } }, "startUrls": { "title": "Ссылки hh.kz / hh.kz URLs", "type": "array", "description": "Вместо полей выше: ссылки на поиск hh.kz (/search/vacancy?…), каталог (/vacancies/…) или вакансию (/vacancy/…). / Instead of the fields above: hh.kz search, catalog or vacancy URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxConcurrency": { "title": "Параллельные запросы / Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Не больше 10 (бережно к сайту). / At most 10 parallel requests (polite crawling).", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }