{
  "openapi": "3.0.1",
  "info": {
    "title": "Jobup.ch Scraper - Switzerland Jobs, Salaries, Employers",
    "description": "Scrape job listings from Jobup.ch, a Swiss general job board (JobCloud AG). Returns title, company, location, canton, workload, salary, contact details, and full descriptions. Multi-language (DE/FR/IT/EN). Public JSON API, no login. Pay-per-result.",
    "version": "0.3",
    "x-build-id": "9jRksDdIIcVkeuxsc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/santamaria-automations~jobup-ch-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-santamaria-automations-jobup-ch-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~jobup-ch-scraper/runs": {
      "post": {
        "operationId": "runs-sync-santamaria-automations-jobup-ch-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~jobup-ch-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-santamaria-automations-jobup-ch-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": {
          "searchQueries": {
            "title": "Search Keywords",
            "type": "array",
            "description": "One or more search keywords. Each keyword runs as a separate search on Jobup.ch. Results are deduplicated across queries. Leave empty and use searchUrls or directUrls instead.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "A city or place name, for example Basel or Lausanne. Filters keyword searches with jobup.ch's own location search (jobs in and around the place). Applies to Search Keywords only; Search URLs keep their own filters. For regions, use a Search URL with jobup.ch's region filter."
          },
          "searchUrls": {
            "title": "Search URLs",
            "type": "array",
            "description": "Paste one or more Jobup.ch search URLs with pre-applied filters. A URL with only a keyword uses the search API. Any other filter in the URL (category, industry, segment, workload, employment type, region, position, company, language skill, benefit) is applied by paging the Jobup.ch search page itself (a category in the URL path such as /fr/emplois/banques-economie/ also works). Only the jobs that match the URL are returned, and the run stops at the total number of jobs Jobup.ch shows for that URL, or at maxResults. The order is the one Jobup.ch uses for that page. This is the easiest way to scrape narrow segments.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs (alias for Search URLs)",
            "type": "array",
            "description": "Alias for searchUrls (Apify convention). Behaves identically, including category, industry and segment filters (paged on the Jobup.ch search page, stopping at the total Jobup.ch shows for the URL). Provided for compatibility with Apify tools that inject startUrls.",
            "items": {
              "type": "string"
            }
          },
          "directUrls": {
            "title": "Direct Job URLs",
            "type": "array",
            "description": "List of Jobup.ch job detail page URLs (https://www.jobup.ch/{lang}/jobs/detail/{id}/). Skips search and scrapes each URL directly. Useful for still-alive checks or targeted re-scrapes.",
            "items": {
              "type": "string"
            }
          },
          "language": {
            "title": "Language",
            "enum": [
              "de",
              "fr",
              "it",
              "en"
            ],
            "type": "string",
            "description": "Search interface + detail page language. Note: Jobup.ch shows listings in all languages regardless of this setting; language mostly affects UI labels.",
            "default": "de"
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "newest",
              "relevance"
            ],
            "type": "string",
            "description": "How to order results. 'newest' = most recently posted first (recommended for scheduled scrapes). 'relevance' = Jobup.ch default ranking (best for one-off keyword searches).",
            "default": "newest"
          },
          "postedWithinDays": {
            "title": "Posted Within Days",
            "minimum": 0,
            "type": "integer",
            "description": "Only return jobs posted within the last N calendar days (Europe/Zurich, today included). Older jobs are dropped before the detail fetch and are not charged. With Sort By = newest the search also stops early. 0 = no limit.",
            "default": 0
          },
          "maxAgeHours": {
            "title": "Max Age (Hours)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return jobs posted within the last N hours (exact). Older jobs are dropped before the detail fetch and are not charged. If Posted Within Days is also set, the stricter limit wins. 0 = no limit.",
            "default": 0
          },
          "includeJobDetails": {
            "title": "Include Job Details",
            "type": "boolean",
            "description": "Fetch full job descriptions from detail pages (slower but returns description_full, apply_url, contact_email, remote_type). Disable for fast SERP-only scrapes.",
            "default": true
          },
          "titleFilter": {
            "title": "Filter by Job Title",
            "type": "string",
            "description": "Comma-separated list of terms to match against job titles (case-insensitive OR-match, substring). Example: Laborant, Chemiker, QC. Only jobs whose title contains one of the terms are returned. Non-matching rows are dropped before the detail fetch, so you do not pay for detail on filtered-out jobs. Leave empty to disable.",
            "default": ""
          },
          "maxResults": {
            "title": "Max Total Results",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap across all queries. Set to 0 for unlimited (per-query limited by maxResultsPerQuery). Jobup.ch caps each keyword at 400 total.",
            "default": 0
          },
          "maxResultsPerQuery": {
            "title": "Max Results per Query",
            "minimum": 0,
            "type": "integer",
            "description": "Cap per keyword. Example: 100 results × 3 queries = up to 300 items total (deduplicated). Set to 0 for unlimited per query.",
            "default": 100
          },
          "maxConcurrency": {
            "title": "Max Concurrent Detail Requests",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Number of detail pages to fetch in parallel when includeJobDetails is enabled. Higher = faster but more proxy bandwidth. 1 = sequential.",
            "default": 8
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}