{ "openapi": "3.0.1", "info": { "title": "Profession.hu Scraper — Hungarian Jobs & Salaries, No Phones", "description": "Profession.hu jobs API: title, company, place, home office, salary as numbers, category and full ad text for $1.50 per 1,000 jobs. Hungarian job ads by link, keyword or place, contract type, posting date. No phones. Unofficial Profession.hu API.", "version": "0.1", "x-build-id": "rS9KwMBvmPF8iHOEu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~profession-hu-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-profession-hu-jobs", "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/highbrow_fame~profession-hu-jobs/runs": { "post": { "operationId": "runs-sync-highbrow_fame-profession-hu-jobs", "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/highbrow_fame~profession-hu-jobs/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-profession-hu-jobs", "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": { "searchUrls": { "title": "Search links", "type": "array", "description": "Set up a search on profession.hu with all the filters you want and paste the address of the results page (https://www.profession.hu/allasok/…). One per line.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Or search here without a link: job titles, skills or company names (programozó, ápoló, raktáros, OTP Bank). Every keyword is searched in every place below; without places, all of Hungary.", "items": { "type": "string" } }, "locations": { "title": "Places", "type": "array", "description": "Towns (Debrecen, Szeged, Érd), Budapest districts (Budapest XIII), counties (Pest megye, Hajdú-Bihar) or countries abroad (Németország, Ausztria). The filters below apply.", "items": { "type": "string" } }, "maxListingsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stops each search after this many jobs.", "default": 200 }, "category": { "title": "Job category", "enum": [ "", "admin-office", "banking-insurance", "logistics-purchasing", "healthcare-pharma", "sales-trade", "manufacturing", "hr-labour", "it-development", "legal", "marketing-media-pr", "education-science-sport", "manual-unskilled", "finance-accounting", "customer-service", "hospitality-tourism", "construction-real-estate", "agriculture-environment", "skilled-trades", "it-operations-telecom", "shared-service-centres", "engineering", "public-administration", "management" ], "type": "string", "description": "For the keywords and places above.", "default": "" }, "contractTypes": { "title": "Type of employment", "uniqueItems": true, "type": "array", "description": "Optional: any of these.", "items": { "type": "string", "enum": [ "employee", "student", "casual", "contractor", "internship", "pensioners", "parents", "reduced-work-capacity" ], "enumTitles": [ "Employee (alkalmazotti)", "Student work (diákmunka)", "Casual work (alkalmi)", "Contractor (vállalkozói)", "Internship (szakmai gyakorlat)", "Suitable for pensioners", "For parents of small children", "For people with reduced work capacity" ] } }, "schedule": { "title": "Full-time or part-time", "enum": [ "any", "full-time", "part-time" ], "type": "string", "description": "Optional.", "default": "any" }, "workplace": { "title": "Home office", "enum": [ "any", "home-office", "remote" ], "type": "string", "description": "Optional: jobs with home office (hybrid) or fully remote jobs.", "default": "any" }, "experience": { "title": "Experience", "uniqueItems": true, "type": "array", "description": "Optional: jobs asking for exactly one of these.", "items": { "type": "string", "enum": [ "none", "1-3", "3-5", "5-10", "10+" ], "enumTitles": [ "No experience", "1-3 years", "3-5 years", "5-10 years", "More than 10 years" ] } }, "minSalary": { "title": "Minimum salary (HUF a month)", "minimum": 0, "type": "integer", "description": "Optional: only jobs that state a salary of at least this much (Profession.hu counts hourly wages as monthly pay)." }, "onlyWithSalary": { "title": "Only jobs with a stated salary", "type": "boolean", "description": "Optional.", "default": false }, "radiusKm": { "title": "Radius around a town (km)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Optional, for towns and Budapest districts: Profession.hu's default is 15 km; 0 = only the town itself." }, "includeDetails": { "title": "Full job ad and details", "type": "boolean", "description": "Opens every job for its full text (tasks, requirements, what they offer, company info), education and languages asked, contract type, postcode and the expiry date. One more page per job, so slower.", "default": true }, "onlyNew": { "title": "Only new jobs since last run", "type": "boolean", "description": "Return only jobs that earlier runs of this watch list did not deliver; the rest are skipped and not charged. The first run returns everything, all marked as new. Combine with a Schedule for a daily alert. \"Max jobs per search\" counts what is checked, new or not, so set it above the number you expect.", "default": false }, "monitorKey": { "title": "Watch list name", "type": "string", "description": "Optional. Names the list of jobs already delivered. Empty: the search itself is the list (change the search and the list starts over). The same name keeps the list when you edit the search; different names keep several lists apart." }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to work on at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Used only to try again after a network error: the first try goes out directly.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }