{ "openapi": "3.0.1", "info": { "title": "hh.ru (HeadHunter) Job Scraper", "description": "Scrape job vacancies from hh.ru (HeadHunter) — title, salary with gross/net flag, employer rating, key skills, metro and GPS coordinates, full description. Works with any search URL, catalog page, or keywords. Built-in residential proxy, monitoring mode for new-only feeds. JSON/CSV.", "version": "0.0", "x-build-id": "EZJlr1uGsexL5mE3J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~hh-ru-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-hh-ru-scraper", "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/memo23~hh-ru-scraper/runs": { "post": { "operationId": "runs-sync-memo23-hh-ru-scraper", "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/memo23~hh-ru-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-hh-ru-scraper", "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": { "startUrls": { "title": "hh.ru URLs", "type": "array", "description": "Full hh.ru URLs to crawl. Search URLs (e.g. `https://hh.ru/search/vacancy?text=python&area=1`), catalog pages (e.g. `https://hh.ru/vacancies/programmist`), and direct vacancy URLs (`https://hh.ru/vacancy/123456789`) can be mixed in the same list.", "items": { "type": "string" } }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "One search per keyword — each entry becomes `https://hh.ru/search/vacancy?text={keyword}`. Ignored when hh.ru URLs are provided above.", "items": { "type": "string" } }, "area": { "title": "Area ID (region filter for keyword searches)", "type": "string", "description": "hh.ru numeric area ID applied to every keyword search. Common values: `1` Moscow, `2` Saint Petersburg, `113` all Russia, `3` Yekaterinburg, `4` Novosibirsk, `40` Kazakhstan, `97` Uzbekistan. Leave empty to search everywhere. Ignored when hh.ru URLs are provided above." }, "enrichEmails": { "title": "Enrich with employer contact emails (experimental, billed per email)", "type": "boolean", "description": "If enabled, tries to find a contact email for each employer by reading its own website (the vacancy page often links it) or discovering it by name. Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Best-effort, billed per contact email found; only charged when an email is returned, never for misses.", "default": false }, "monitoringMode": { "title": "Monitoring mode (only return vacancies not seen on previous runs)", "type": "boolean", "description": "When enabled, vacancies whose ID has already been delivered to you are silently skipped (no detail page is fetched and no charge applies for them). The first run after enabling monitoring returns every match — that builds your baseline. Every subsequent run returns only new postings. Combine with Apify's scheduler for a 'jobs posted since last run' feed.", "default": false }, "resetMonitoringState": { "title": "Reset monitoring state (one-shot)", "type": "boolean", "description": "One-shot toggle: clear the saved 'vacancies already seen' record at the start of this run. Use this when you change search URL, want to rebuild the baseline, or recover from a missed delivery. Has no effect when monitoring mode is off.", "default": false }, "maxItems": { "title": "Maximum items to scrape", "minimum": 1, "type": "integer", "description": "Hard cap on the number of vacancies collected. Note: hh.ru serves at most 2,000 results per search query (40 pages × 50) — narrow by region or keyword to reach deeper inventory.", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of vacancy pages processed in parallel.", "default": 10 }, "minConcurrency": { "title": "Min concurrency", "minimum": 1, "type": "integer", "description": "Minimum number of vacancy pages processed in parallel.", "default": 1 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "Number of retries before a failed request is given up.", "default": 5 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you (hh.ru blocks datacenter IPs). Only set this if you want to use your own proxies." } } }, "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 } } }, "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 } } } } } } } } } }