{
  "openapi": "3.0.1",
  "info": {
    "title": "Arbeitsagentur Jobs Scraper",
    "description": "Arbeitsagentur Jobs Scraper SD - Arbeitsagentur Jobs Scraper is a job data tool that extracts German jobs from the Bundesagentur für Arbeit job board: title, employer, location, salary, working time, contract, start date and full description. No login.",
    "version": "1.0",
    "x-build-id": "JRwQFhvXNRkS3vmA6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/neuro-scraper~arbeitsagentur-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-neuro-scraper-arbeitsagentur-jobs-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/neuro-scraper~arbeitsagentur-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-neuro-scraper-arbeitsagentur-jobs-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/neuro-scraper~arbeitsagentur-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-neuro-scraper-arbeitsagentur-jobs-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": {
          "keyword": {
            "title": "Keyword (was)",
            "type": "string",
            "description": "Job title, skill or company to search for, as in the site's \"Was\" box, e.g. \"Python\", \"Pflegefachkraft\", \"Buchhalter\". Leave empty to list every job in the location."
          },
          "keywords": {
            "title": "More keywords",
            "type": "array",
            "description": "Extra keywords, one per line, each searched separately (combined with every location), e.g. \"Data Scientist\", \"DevOps\". Results are de-duplicated by reference number.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Location (wo)",
            "type": "string",
            "description": "City, postcode or federal state as in the site's \"Wo\" box, e.g. \"Berlin\", \"80331\", \"Bayern\". Empty = all of Germany."
          },
          "locations": {
            "title": "More locations",
            "type": "array",
            "description": "Extra locations, one per line, each searched separately (combined with every keyword), e.g. \"Hamburg\", \"Nordrhein-Westfalen\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "Search radius (km)",
            "minimum": -1,
            "maximum": 200,
            "type": "integer",
            "description": "Radius around the location in km (the site's \"Umkreis\": 0, 10, 15, 25, 50, 100, 200). -1 = the site's default.",
            "default": -1
          },
          "startUrls": {
            "title": "Arbeitsagentur URLs",
            "type": "array",
            "description": "Search result URLs copied from the site with all filters (https://www.arbeitsagentur.de/jobsuche/suche?was=Python&wo=Berlin&umkreis=25&angebotsart=1) or job pages (https://www.arbeitsagentur.de/jobsuche/jobdetail/10000-1234567890-S). A bare reference number (10000-1234567890-S) works too. The filters below are added to a search URL only where the URL does not set them.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "offerType": {
            "title": "Offer type",
            "enum": [
              "any",
              "1",
              "34",
              "2",
              "4"
            ],
            "type": "string",
            "description": "The site's \"Angebotsart\" filter (server-side).",
            "default": "any"
          },
          "workingTime": {
            "title": "Working time",
            "type": "array",
            "description": "The site's \"Arbeitszeit\" filter; several values = jobs with any of them (server-side).",
            "items": {
              "type": "string",
              "enum": [
                "vz",
                "tz",
                "snw",
                "mj"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Shift / night / weekend",
                "Mini-job"
              ]
            },
            "default": []
          },
          "contractType": {
            "title": "Contract type",
            "enum": [
              "any",
              "1",
              "2"
            ],
            "type": "string",
            "description": "The site's \"Befristung\" filter (server-side).",
            "default": "any"
          },
          "publishedSinceDays": {
            "title": "Published within the last N days",
            "minimum": -1,
            "maximum": 365,
            "type": "integer",
            "description": "The site's \"Veröffentlicht seit\" filter: 0 = today, 1 = since yesterday, 7, 14, 28 ... -1 = any age.",
            "default": -1
          },
          "remoteOnly": {
            "title": "Home office possible only",
            "type": "boolean",
            "description": "Keep only jobs that state home office (the site's \"Homeoffice\" filter, server-side).",
            "default": false
          },
          "homeOfficeMinPercent": {
            "title": "Minimum home-office share (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "With a value above 0: only jobs that state at least this home-office percentage (the site's slider, e.g. 50). Jobs without a percentage are left out.",
            "default": 0
          },
          "temporaryWork": {
            "title": "Temporary staffing (Zeitarbeit)",
            "enum": [
              "any",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "The site's \"Zeitarbeit\" filter (server-side).",
            "default": "any"
          },
          "privateAgencies": {
            "title": "Private recruitment agencies (Personalvermittlung)",
            "enum": [
              "any",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "The site's \"Personalvermittlung\" filter (server-side).",
            "default": "any"
          },
          "externalJobBoards": {
            "title": "Jobs from external job boards",
            "enum": [
              "any",
              "exclude",
              "only"
            ],
            "type": "string",
            "description": "The site's \"Externe Stellenbörsen\" filter (server-side).",
            "default": "any"
          },
          "careerChangeOnly": {
            "title": "Suitable for career changers only",
            "type": "boolean",
            "description": "The site's \"Quereinstieg\" filter (server-side).",
            "default": false
          },
          "disabilityOnly": {
            "title": "Jobs offered only to severely disabled people",
            "type": "boolean",
            "description": "The site's \"Behinderung\" filter (server-side).",
            "default": false
          },
          "minAnnualSalary": {
            "title": "Minimum annual salary (EUR)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "The site's \"Vergütung\" filter: jobs stating a yearly salary of at least this amount, e.g. 60000. 0 = off.",
            "default": 0
          },
          "minHourlyWage": {
            "title": "Minimum hourly wage (EUR)",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "The site's \"Vergütung\" filter: jobs stating an hourly wage of at least this amount, e.g. 15. 0 = off.",
            "default": 0
          },
          "startDateFrom": {
            "title": "Start date from",
            "type": "string",
            "description": "The site's \"Beginn\" filter: jobs starting on or after this date, e.g. 2026-11-01 (use with Start date to).",
            "default": ""
          },
          "startDateTo": {
            "title": "Start date to",
            "type": "string",
            "description": "Jobs starting before this date, e.g. 2026-12-01.",
            "default": ""
          },
          "industries": {
            "title": "Industries (Branche ids)",
            "type": "array",
            "description": "The site's \"Branche\" filter ids, e.g. 11 = IT, Computer, Telekommunikation; 7 = Gesundheit, Soziales; 13 = Management, Beratung, Recht, Steuern; 21 = Logistik, Transport, Verkehr (the id is in the site's URL after you tick an industry: branche=11).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "employer": {
            "title": "Employer",
            "type": "string",
            "description": "Exact employer name as the site shows it in the \"Arbeitgeber\" filter, e.g. \"Deutsche Bahn AG\".",
            "default": ""
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevanz",
              "veroeffdatum",
              "moddatum",
              "eintrittsdatum",
              "entfernung"
            ],
            "type": "string",
            "description": "The site's sort order.",
            "default": "relevanz"
          },
          "includeDetails": {
            "title": "Fetch full job details",
            "type": "boolean",
            "description": "One extra small request per job: full description (text and Markdown), allianz partner, agency / temporary-staffing / disability flags.",
            "default": true
          },
          "includeEmployerProfile": {
            "title": "Fetch employer profiles",
            "type": "boolean",
            "description": "One request per employer that has a public profile on the site: company description, website and links, social links, keywords and benefits.",
            "default": false
          },
          "monitorMode": {
            "title": "Output mode",
            "enum": [
              "snapshot",
              "changes_only"
            ],
            "type": "string",
            "description": "Changes only remembers the jobs of this search (named key-value store arbeitsagentur-jobs-monitor) and returns new and updated ones (changeType). Schedule the Actor for a new-jobs feed.",
            "default": "snapshot"
          },
          "includeUnchanged": {
            "title": "Include unchanged jobs",
            "type": "boolean",
            "description": "Changes only: also return jobs that did not change (changeType \"unchanged\").",
            "default": false
          },
          "stateName": {
            "title": "Monitoring state name",
            "type": "string",
            "description": "Optional name that keeps one monitored search apart from another, e.g. \"berlin-python\". Empty = built from the search inputs.",
            "default": ""
          },
          "maxItems": {
            "title": "Maximum number of jobs",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many jobs in total. The scraper follows the site's result pages (up to 100 jobs each) until this number or the last page; past the site's 10,000-result window a search is split by industry.",
            "default": 50
          },
          "maxPagesPerSearch": {
            "title": "Maximum result pages per search",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop each search after this many result pages. 0 = no page limit.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Parallel detail requests",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many job details / employer profiles are fetched at the same time (each worker paced ~1 request/s).",
            "default": 4
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "The site answered every logged-out request without a challenge in tests; a German residential proxy is the default for steady runs on the Apify platform.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "DE"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}