{
  "openapi": "3.0.1",
  "info": {
    "title": "Arbeitsagentur.de Scraper - German Federal Job Board",
    "description": "Extract jobs from Germany's official employment agency (Bundesagentur für Arbeit): titles, companies, locations, salaries, descriptions and contact details where available. Supports search filters, direct search URLs and job status checks.",
    "version": "4.5",
    "x-build-id": "ZdiGRq1plrNhtWvjf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/santamaria-automations~arbeitsagentur-de-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-santamaria-automations-arbeitsagentur-de-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/santamaria-automations~arbeitsagentur-de-scraper/runs": {
      "post": {
        "operationId": "runs-sync-santamaria-automations-arbeitsagentur-de-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/santamaria-automations~arbeitsagentur-de-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-santamaria-automations-arbeitsagentur-de-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": {
          "directUrls": {
            "title": "Direct Job URLs",
            "type": "array",
            "description": "Optional: Direct URLs to specific job listings to check status",
            "items": {
              "type": "string",
              "pattern": "^https://"
            }
          },
          "searchQueries": {
            "title": "Search Keywords (Was)",
            "type": "array",
            "description": "One or more search keywords. Each keyword runs as a separate search. Results are deduplicated across queries.",
            "items": {
              "type": "string"
            }
          },
          "searchQuery": {
            "title": "Search Keyword (single, legacy)",
            "type": "string",
            "description": "Single search keyword (backward compatible). Use 'searchQueries' for multiple keywords."
          },
          "titleFilter": {
            "title": "Title Filter (comma-separated)",
            "type": "string",
            "description": "Comma-separated title terms (case-insensitive substring OR-match). Filters SERP results by job title before detail fetch. Empty disables the filter. Example: 'Sales Manager, Vertriebsmitarbeiter, Account Executive'. Saves job-detail-result costs by skipping non-matching titles.",
            "default": ""
          },
          "location": {
            "title": "Location (Wo)",
            "type": "string",
            "description": "City, region, or area (e.g., 'Munchen', 'Berlin', 'Nordrhein-Westfalen')"
          },
          "radius": {
            "title": "Radius (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Optional. Search radius in kilometers around the Location (sent as the umkreis parameter). 0 means the exact place only. Needs a Location: without one the radius is ignored with a warning. Leave empty for the site default."
          },
          "bundesland": {
            "title": "Bundesland (Federal State)",
            "enum": [
              "",
              "BW",
              "BY",
              "BE",
              "BB",
              "HB",
              "HH",
              "HE",
              "MV",
              "NI",
              "NW",
              "RP",
              "SL",
              "SN",
              "ST",
              "SH",
              "TH"
            ],
            "type": "string",
            "description": "German federal state code",
            "default": ""
          },
          "sortBy": {
            "title": "Sort Order",
            "enum": [
              "newest",
              "relevance"
            ],
            "type": "string",
            "description": "Result ordering. 'newest' maps to sort=veroeffdatum (publication date descending). 'relevance' maps to sort=relevanz (platform default relevance ranking). Recommended: newest for scheduled scrapes to get freshest listings first.",
            "default": "newest"
          },
          "employmentType": {
            "title": "Employment Type",
            "enum": [
              "",
              "FULL_TIME",
              "PART_TIME",
              "INTERNSHIP",
              "APPRENTICESHIP",
              "CONTRACT"
            ],
            "type": "string",
            "description": "Filter by employment type. FULL_TIME and PART_TIME use the arbeitszeit param (vz/tz). INTERNSHIP and APPRENTICESHIP use the angebotsart param. Leave empty for all types.",
            "default": ""
          },
          "workingTime": {
            "title": "Working Time (arbeitszeit)",
            "type": "array",
            "description": "Optional. Restrict the search to one or more working time models (sent as the arbeitszeit parameter): full_time = vz, part_time = tz, shift_night_weekend = snw, mini_job = mj. Combined with Employment Type FULL_TIME or PART_TIME the codes are merged (no duplicates). Home office is not a working time value here: use Minimum Remote Percentage.",
            "items": {
              "type": "string",
              "enum": [
                "full_time",
                "part_time",
                "shift_night_weekend",
                "mini_job"
              ],
              "enumTitles": [
                "Full-time (Vollzeit)",
                "Part-time (Teilzeit)",
                "Shift, night or weekend work (Schicht, Nacht, Wochenende)",
                "Mini job (Minijob)"
              ]
            }
          },
          "postedWithinDays": {
            "title": "Posted within days",
            "minimum": 0,
            "type": "integer",
            "description": "Only return jobs posted within the last N days. Passes directly as veroeffentlichtseit to the Arbeitsagentur API (arbitrary integers accepted, e.g. 1=yesterday, 7=one week, 14=two weeks, 28=four weeks). Default: 0 (no age filter).",
            "default": 0
          },
          "remotePercentageMin": {
            "title": "Minimum Remote Percentage",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Filter for homeoffice (remote work) options. Set to 100 to return only fully remote jobs (homeoffice=prozentual_100). Set to 50 for at least 50% remote. Default: 0 (no remote filter). This is a platform-specific Arbeitsagentur filter not available on most other job boards.",
            "default": 0
          },
          "maxResultsPerQuery": {
            "title": "Max Results per Query",
            "minimum": 0,
            "type": "integer",
            "description": "Per-keyword cap. Total possible results = maxResultsPerQuery x number of searchQueries (deduplicated). Example: 100 x 8 queries = up to 800 results. Set to 0 for unlimited per query (only maxResults caps the total).",
            "default": 100
          },
          "maxResults": {
            "title": "Max Total Results",
            "minimum": 0,
            "type": "integer",
            "description": "Total cap across all queries. Set to 0 for unlimited (each query limited by maxResultsPerQuery).",
            "default": 0
          },
          "includeJobDetails": {
            "title": "Extract Contact Details and Full Job Details",
            "type": "boolean",
            "description": "Extract contact details (email, phone, contact person where shown), plus full job description, company website, logo, and description. Pure HTTP -- no browser needed. Slower (~3-5s/job) but provides valuable data.",
            "default": false
          },
          "offerType": {
            "title": "Offer Type (angebotsart)",
            "enum": [
              "",
              "work",
              "self_employed",
              "training",
              "internship_trainee"
            ],
            "type": "string",
            "description": "Optional. Restrict the search to one offer type. Sent as the angebotsart parameter of the search: work = 1, self_employed = 2, training = 4, internship_trainee = 34. When set, it replaces the angebotsart that an Employment Type of INTERNSHIP, APPRENTICESHIP or CONTRACT would set. Leave empty for all offer types."
          },
          "onlyNewSinceLastRun": {
            "title": "Only New Jobs Since Last Run",
            "type": "boolean",
            "description": "For daily monitoring. When on, the actor remembers the job IDs it delivered in earlier runs with the same search settings (keywords, location, state, employment type, offer type, age filter, title filter) in a named key-value store in your account, and skips them before details are fetched and before you are charged. Remembers the last 50,000 IDs. Off by default.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}