{
  "openapi": "3.0.1",
  "info": {
    "title": "Get-in-IT Jobs & Employer Directory Scraper",
    "description": "Pull German IT job listings from get-in-it.de by career field, degree, state or keyword, fetch full job postings with salary and requirements, or browse the employer directory with full company profiles.",
    "version": "1.0",
    "x-build-id": "Sdu6IY3dCeQ1eg4kH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlyth-forge~get-in-it-jobs-and-employer-directory-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlyth-forge-get-in-it-jobs-and-employer-directory-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/crawlyth-forge~get-in-it-jobs-and-employer-directory-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlyth-forge-get-in-it-jobs-and-employer-directory-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/crawlyth-forge~get-in-it-jobs-and-employer-directory-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlyth-forge-get-in-it-jobs-and-employer-directory-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "jobDetails",
              "companies",
              "companyDetails"
            ],
            "type": "string",
            "description": "What to fetch.",
            "default": "search"
          },
          "careerFields": {
            "title": "Career fields",
            "type": "array",
            "description": "Filter jobs by one or more IT career fields (mode=search). Leave empty for all career fields; select several to match ANY of them.",
            "items": {
              "type": "string",
              "enum": [
                "anwendungsentwicklung",
                "business-analysis",
                "consulting",
                "datenbankentwicklung-bi",
                "embedded-systems",
                "forschung",
                "it-security",
                "produktmanagement",
                "projektmanagement",
                "quality-assurance",
                "risk-compliance-management",
                "system-engineering-admin",
                "ux-ui",
                "webentwicklung"
              ],
              "enumTitles": [
                "Application Development",
                "Business Analysis",
                "Consulting",
                "Database Development / BI",
                "Embedded Systems",
                "Research",
                "IT Security",
                "Product Management",
                "Project Management",
                "Quality Assurance",
                "Risk / Compliance Management",
                "System Engineering / Admin",
                "UX/UI",
                "Web Development"
              ]
            },
            "default": []
          },
          "studySubjects": {
            "title": "Study subjects",
            "type": "array",
            "description": "Filter jobs by the study subject(s) they target (mode=search). Leave empty for all subjects; select several to match ANY of them.",
            "items": {
              "type": "string",
              "enum": [
                "wirtschaftsinformatik",
                "informatik",
                "mathematik",
                "naturwissenschaften",
                "wirtschaftswissenschaften",
                "wirtschaftsingenieurwesen",
                "ingenieurwissenschaften",
                "elektrotechnik",
                "informationstechnik",
                "medieninformatik",
                "informatik-andere"
              ],
              "enumTitles": [
                "Business Informatics (Wirtschaftsinformatik)",
                "Computer Science (Informatik)",
                "Mathematics (Mathematik)",
                "Natural Sciences (Naturwissenschaften)",
                "Economics (Wirtschaftswissenschaften)",
                "Industrial Engineering (Wirtschaftsingenieurwesen)",
                "Engineering Sciences (Ingenieurwissenschaften)",
                "Electrical Engineering (Elektrotechnik)",
                "Information Technology (Informationstechnik)",
                "Media Informatics (Medieninformatik)",
                "Computer Science, Other (Informatik Andere)"
              ]
            },
            "default": []
          },
          "degrees": {
            "title": "Degree levels",
            "type": "array",
            "description": "Filter jobs by required degree level(s) (mode=search). Leave empty for all levels; select several to match ANY of them.",
            "items": {
              "type": "string",
              "enum": [
                "ausbildung",
                "bachelor",
                "master-diplom",
                "promotion"
              ],
              "enumTitles": [
                "Vocational training (Ausbildung)",
                "Bachelor",
                "Master / Diplom",
                "Doctorate (Promotion)"
              ]
            },
            "default": []
          },
          "states": {
            "title": "German states (Bundesländer)",
            "type": "array",
            "description": "Filter jobs (mode=search) or companies (mode=companies) by one or more German federal states. Leave empty for all states; select several to match ANY of them.",
            "items": {
              "type": "string",
              "enum": [
                "baden-wuerttemberg",
                "bayern",
                "berlin",
                "brandenburg",
                "bremen",
                "hamburg",
                "hessen",
                "mecklenburg-vorpommern",
                "niedersachsen",
                "nordrhein-westfalen",
                "rheinland-pfalz",
                "saarland",
                "sachsen",
                "sachsen-anhalt",
                "schleswig-holstein",
                "thueringen"
              ],
              "enumTitles": [
                "Baden-Württemberg",
                "Bayern (Bavaria)",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen (Hesse)",
                "Mecklenburg-Vorpommern",
                "Niedersachsen (Lower Saxony)",
                "Nordrhein-Westfalen (North Rhine-Westphalia)",
                "Rheinland-Pfalz (Rhineland-Palatinate)",
                "Saarland",
                "Sachsen (Saxony)",
                "Sachsen-Anhalt (Saxony-Anhalt)",
                "Schleswig-Holstein",
                "Thüringen (Thuringia)"
              ]
            },
            "default": []
          },
          "cities": {
            "title": "Cities (job search)",
            "type": "array",
            "description": "Only jobs (mode=search) or companies (mode=companies) within `radiusKm` of one or more German cities. Enter city names as shown on get-in-it.de, e.g. Berlin, München, Köln. Leave empty for all of Germany; select several cities to match ANY of them.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "City radius (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Search radius around each selected city (mode=search or mode=companies; used only when `cities` is set).",
            "default": 25
          },
          "branches": {
            "title": "Employer industries (mode=companies)",
            "type": "array",
            "description": "Filter companies by one or more industries (mode=companies). Leave empty for all industries; select several to match ANY of them.",
            "items": {
              "type": "string",
              "enum": [
                "automobilindustrie",
                "bankwesen",
                "bau-und-immobilien",
                "beratung-consulting",
                "energiewirtschaft",
                "handel",
                "industrie",
                "it-branche",
                "medien-internet",
                "medizin-life-science",
                "oeffentlicher-dienst",
                "telekommunikation",
                "transport-logistik",
                "versicherungswesen",
                "wissenschaft-forschung"
              ],
              "enumTitles": [
                "Automotive Industry",
                "Banking",
                "Construction & Real Estate",
                "Consulting",
                "Energy",
                "Retail",
                "Industry / Manufacturing",
                "IT Industry",
                "Media / Internet",
                "Medicine / Life Science",
                "Public Sector",
                "Telecommunications",
                "Transport / Logistics",
                "Insurance",
                "Science / Research"
              ]
            },
            "default": []
          },
          "companySizes": {
            "title": "Employer company size (mode=companies)",
            "type": "array",
            "description": "Filter companies by size category (mode=companies). Leave empty for all sizes; select several to match ANY of them.",
            "items": {
              "type": "string",
              "enum": [
                "startup",
                "mittelstand",
                "grossunternehmen"
              ],
              "enumTitles": [
                "Startup",
                "Mid-size company (Mittelstand)",
                "Large enterprise (Großunternehmen)"
              ]
            },
            "default": []
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "mode=search: only keep jobs matching every word of this text against title, company name, location, or career field (case-insensitive). mode=companies: only keep companies whose name contains this text."
          },
          "homeOfficeOnly": {
            "title": "Home office / remote only",
            "type": "boolean",
            "description": "Only keep jobs that offer home-office / remote work (mode=search).",
            "default": false
          },
          "companyIds": {
            "title": "Company IDs",
            "type": "array",
            "description": "mode=search: only keep jobs from these employers' numeric company IDs (matches ANY of the listed IDs). mode=companyDetails: which company profiles to fetch — accepts numeric company IDs, URL slugs (e.g. `adesso-se`), or full company URLs. Find a company's ID/slug in the `companyId`/`companyUrl` field of any job or company record.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "companyNames": {
            "title": "Company names",
            "type": "array",
            "description": "Restrict to one or more employers by name (mode=search and mode=companyDetails), or keep only matching companies (mode=companies). Names are resolved against get-in-it.de's employer directory and match ANY of them. Leave empty for all employers.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "jobIds": {
            "title": "Job IDs (mode=jobDetails)",
            "type": "array",
            "description": "Job IDs, `p<id>` slugs, or full job URLs (e.g. `310856`, `p310856`, `https://www.get-in-it.de/jobsuche/p310856`).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on emitted records (1–5000); the source has ~3,500 open jobs and ~1,200 companies.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}