{
  "openapi": "3.0.1",
  "info": {
    "title": "Arbeitsagentur Jobs Scraper: Bundesagentur für Arbeit",
    "description": "Jobs from Germany's largest job board, the Bundesagentur für Arbeit Jobsuche: title, employer, place with coordinates, working time, contract, salary, dates, external link and full description. Search by keyword, place and radius, or paste a search URL. Schedule it for new jobs only.",
    "version": "0.1",
    "x-build-id": "cCrzexMVzq4ku24Hq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/puhmeisterluka~bundesagentur-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-puhmeisterluka-bundesagentur-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/puhmeisterluka~bundesagentur-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-puhmeisterluka-bundesagentur-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/puhmeisterluka~bundesagentur-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-puhmeisterluka-bundesagentur-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",
            "type": "string",
            "description": "Job title or skill, as you would type it into the search on arbeitsagentur.de, e.g. \"Softwareentwickler/in\", \"Pflegefachkraft\" or \"Python\"."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, district or postcode in Germany, e.g. \"Berlin\", \"München\" or \"10115\". Leave empty for all of Germany."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Distance around the location, 0 to 200 km. Only used with a location.",
            "default": 25
          },
          "offerType": {
            "title": "Offer type",
            "enum": [
              "any",
              "job",
              "self-employment",
              "apprenticeship",
              "internship"
            ],
            "type": "string",
            "description": "Job, self-employment, apprenticeship (Ausbildung and dual study) or internship/trainee.",
            "default": "any"
          },
          "workingTime": {
            "title": "Working time",
            "type": "array",
            "description": "Any of these. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "full-time",
                "part-time",
                "shift-night-weekend",
                "home-office",
                "mini-job"
              ],
              "enumTitles": [
                "Full-time (Vollzeit)",
                "Part-time (Teilzeit)",
                "Shifts, nights, weekends",
                "Home office",
                "Mini job"
              ]
            }
          },
          "contractType": {
            "title": "Contract",
            "enum": [
              "any",
              "permanent",
              "temporary"
            ],
            "type": "string",
            "description": "Permanent (unbefristet) or fixed-term (befristet).",
            "default": "any"
          },
          "publishedSince": {
            "title": "Published since",
            "enum": [
              "any",
              "today",
              "yesterday",
              "7days",
              "14days",
              "28days"
            ],
            "type": "string",
            "description": "Only jobs published in this window, as the site offers it.",
            "default": "any"
          },
          "occupationField": {
            "title": "Occupational field",
            "type": "string",
            "description": "Optional. A field as the site names it, e.g. \"Informatik\" or \"Gesundheit\"."
          },
          "employer": {
            "title": "Employer",
            "type": "string",
            "description": "Optional. The employer's name exactly as the site shows it, e.g. \"Deutsche Bahn AG\"."
          },
          "includeTemporaryAgencies": {
            "title": "Include temp agencies (Zeitarbeit)",
            "type": "boolean",
            "description": "Off leaves out jobs from temporary employment agencies.",
            "default": true
          },
          "includePrivateAgencies": {
            "title": "Include private recruiters",
            "type": "boolean",
            "description": "Off leaves out jobs posted by private placement agencies (private Arbeitsvermittlung).",
            "default": true
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "relevance",
              "modified",
              "distance"
            ],
            "type": "string",
            "description": "Newest first suits schedules: with Only new jobs on, a run stops as soon as it reaches jobs it has seen.",
            "default": "newest"
          },
          "startUrls": {
            "title": "Search URLs",
            "type": "array",
            "description": "Optional. Searches copied from arbeitsagentur.de/jobsuche/suche with the filters you set there. When you paste any, the search fields above are ignored.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop each search after this many jobs. The API itself stops at 10,000 per search.",
            "default": 100
          },
          "fetchDetails": {
            "title": "Full job details",
            "type": "boolean",
            "description": "One extra request per job for the full description, the source job board, the temp-agency and private-recruiter flags, and the type of apprenticeship. Off returns the rest about 50 times faster.",
            "default": true
          },
          "onlyNew": {
            "title": "Only new jobs",
            "type": "boolean",
            "description": "Return only jobs this Actor has not returned before for the same search. Put it on a schedule to get new jobs as they appear.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. Runs work without a proxy."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}