{
  "openapi": "3.0.1",
  "info": {
    "title": "Profession.hu Job Scraper",
    "description": "[💰 $1.8 / 1K] Extract job listings from profession.hu, Hungary's largest job board. Filter by category, location, employment type, remote work, and experience level. Returns title, company, location, salary, posted date, full description, skills, and the apply link per job.",
    "version": "1.0",
    "x-build-id": "wwsL3jbTeWpmcxntS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~profession-hu-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-profession-hu-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/solidcode~profession-hu-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-profession-hu-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/solidcode~profession-hu-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-profession-hu-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": {
          "searchQuery": {
            "title": "Search Keyword",
            "type": "string",
            "description": "Job title, role, or keyword to search for (e.g. 'szoftverfejlesztő', 'sales manager', 'könyvelő'). Leave blank to collect all jobs matching the filters below."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City or county to search in (e.g. 'Budapest', 'Pest', 'Debrecen'). Leave blank to search nationwide."
          },
          "categories": {
            "title": "Job Categories",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs in these categories. Leave empty to include every category.",
            "items": {
              "type": "string",
              "enum": [
                "administration-office",
                "bank-insurance",
                "logistics-procurement",
                "healthcare-pharma",
                "sales-retail",
                "production-manufacturing",
                "human-resources",
                "it-development",
                "legal",
                "marketing-media-pr",
                "education-science-sport",
                "manual-unskilled",
                "finance-accounting",
                "customer-service",
                "hospitality-tourism",
                "construction-real-estate",
                "agriculture-environment",
                "skilled-trade",
                "it-ops-telecom",
                "business-support-ssc",
                "engineering",
                "public-administration",
                "management-executive"
              ],
              "enumTitles": [
                "Administration / Assistant / Office",
                "Bank / Insurance / Broker",
                "Logistics / Procurement / Transport",
                "Healthcare / Pharma",
                "Sales / Retail",
                "Production / Manufacturing",
                "Human Resources",
                "IT Programming / Development",
                "Legal",
                "Marketing / Media / PR",
                "Education / Science / Sport",
                "Manual / Unskilled / Trainee labour",
                "Finance / Accounting",
                "Customer Service",
                "Hospitality / Hotel / Tourism",
                "Construction / Real Estate",
                "Agriculture / Environment",
                "Skilled trade",
                "IT Operations / Telecommunications",
                "Business support centres (SSC)",
                "Engineering",
                "Public administration",
                "Management / Executive"
              ]
            },
            "default": []
          },
          "employmentTypes": {
            "title": "Employment Types",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs of these employment types. Leave empty to include all types. This filter is applied to the jobs as they are collected (the site has no employment-type search filter), so on very specific searches it may scan several listing pages to find matches; the run stops early if many pages in a row contain none.",
            "items": {
              "type": "string",
              "enum": [
                "full-time",
                "part-time",
                "internship",
                "contractor",
                "student"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Internship",
                "Contractor",
                "Student / trainee"
              ]
            },
            "default": []
          },
          "remoteType": {
            "title": "Work Arrangement",
            "enum": [
              "any",
              "on-site",
              "remote"
            ],
            "type": "string",
            "description": "Filter by where the work is done: On-site or Remote. Choosing anything other than 'Any' reads each job's detail page to determine its work arrangement, so full job details are fetched automatically for this filter even if detail enrichment is turned off below. On very specific searches the run may stop early when several listing pages in a row contain no matching jobs.",
            "default": "any"
          },
          "experienceLevel": {
            "title": "Experience Level",
            "enum": [
              "any",
              "none",
              "1-3",
              "3-5",
              "5-10",
              "10+"
            ],
            "type": "string",
            "description": "Only include jobs requiring this level of experience. Leave as 'Any' for no restriction.",
            "default": "any"
          },
          "searchUrls": {
            "title": "Search URLs",
            "type": "array",
            "description": "Paste profession.hu search or category URLs directly from your browser (e.g. https://www.profession.hu/allasok/...). Use this when you've already built filters in the site's UI. When provided, the keyword and filters above are ignored.",
            "items": {
              "type": "string"
            }
          },
          "jobUrls": {
            "title": "Job URLs",
            "type": "array",
            "description": "Paste one or more individual job URLs to scrape just those listings. If set, only these postings are scraped and the search filters above are ignored.",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Fetch full job details",
            "type": "boolean",
            "description": "Turn on to open each job's detail page and collect the full description, requirements, responsibilities, skills, benefits, and tech stack. Turn off for faster runs with listing-level fields only.",
            "default": true
          },
          "descriptionFormat": {
            "title": "Description Format",
            "enum": [
              "all",
              "text",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "Which description formats to include in each job. Only applies when full job details are fetched.",
            "default": "all"
          },
          "maxResults": {
            "title": "Maximum Results",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on total job rows returned across all sources. Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper bound still applies to prevent runaway pagination). The actor stops requesting new pages once this number is hit but keeps the full last page even if it slightly overshoots.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}