{
  "openapi": "3.0.1",
  "info": {
    "title": "Werkzoeken.nl Jobs Scraper",
    "description": "Scrape werkzoeken.nl vacatures by keyword, city, radius, salary and contract. Get title, company, salary, hours, full description, apply URL and employer info. Export JSON, CSV, Excel.",
    "version": "1.0",
    "x-build-id": "7WJeCpvxTrMUkVMJG"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parsebird~werkzoeken-nl-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parsebird-werkzoeken-nl-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/parsebird~werkzoeken-nl-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parsebird-werkzoeken-nl-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/parsebird~werkzoeken-nl-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parsebird-werkzoeken-nl-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": {
          "queries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Job titles or keywords to search on werkzoeken.nl, one per line, for example 'kok', 'schilder' or 'software developer'. Each keyword runs as its own search. Leave empty with no start URLs to browse all vacancies.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Dutch cities, postcodes, regions or provinces, for example 'Amsterdam', '3511' or 'Noord-Brabant'. Each keyword is searched in each location. Leave empty to search all of the Netherlands.",
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Search distance around each location. werkzoeken.nl offers 0, 10, 15, 30 and 50 km; other values also work. Only used when a location is set.",
            "default": 30
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "werkzoeken.nl search result URLs (https://www.werkzoeken.nl/vacatures/?what=...), job pages (https://www.werkzoeken.nl/vacatures-voor/schilder/almere/) or vacancy URLs (https://www.werkzoeken.nl/vacature/16063249-voorman-schilder/). Filters in a search URL are applied strictly, so only matching vacancies are returned. Vacancy URLs always load full details.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of vacancies to save across all searches. Set 0 for no limit.",
            "default": 100
          },
          "includeDetails": {
            "title": "Include full details",
            "type": "boolean",
            "description": "Open each vacancy for the full description (text, HTML, Markdown), apply URL, address with coordinates, benefits, tasks, requirements, education, driver's license, contact person and employer info. Charged as a separate 'job-details' event. Turn off for search-card data only.",
            "default": true
          },
          "includeCompanyProfile": {
            "title": "Include company profiles",
            "type": "boolean",
            "description": "Add the employer's full werkzoeken.nl profile: industry, employee range, headquarters and branch addresses, average age, gender ratio, dress code, open vacancies per category and application steps. Needs full details. Each company is loaded once per run.",
            "default": false
          },
          "salaryMin": {
            "title": "Minimum monthly salary (€)",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Only vacancies whose salary range reaches at least this gross monthly amount (werkzoeken.nl's own salary filter, which also converts hourly wages). The site uses steps of €100 from €1,000 to €4,000, then €250 up to €7,500; other values are rounded down to the nearest step."
          },
          "hoursMin": {
            "title": "Minimum hours per week",
            "minimum": 0,
            "maximum": 40,
            "type": "integer",
            "description": "Only vacancies with at least this many hours per week (0–40)."
          },
          "hoursMax": {
            "title": "Maximum hours per week",
            "minimum": 0,
            "maximum": 40,
            "type": "integer",
            "description": "Only vacancies with at most this many hours per week (0–40)."
          },
          "contractTypes": {
            "title": "Contract types",
            "type": "array",
            "description": "Contractvorm. Pick one or more; vacancies matching any of them are returned.",
            "items": {
              "type": "string",
              "enum": [
                "permanent",
                "temporary",
                "secondment",
                "freelance",
                "traineeship",
                "internship"
              ],
              "enumTitles": [
                "Loondienst (vast) — permanent",
                "Loondienst (tijdelijk) — temporary",
                "Loondienst (detachering) — secondment",
                "Freelance",
                "Traineeship / BBL",
                "Stage — internship"
              ]
            }
          },
          "educationLevels": {
            "title": "Education levels",
            "type": "array",
            "description": "Opleiding required for the job.",
            "items": {
              "type": "string",
              "enum": [
                "none",
                "vmbo",
                "mbo",
                "hbo",
                "university"
              ],
              "enumTitles": [
                "Geen diploma — no diploma",
                "VMBO",
                "MBO",
                "HBO",
                "Universiteit — university"
              ]
            }
          },
          "experienceLevels": {
            "title": "Experience levels",
            "type": "array",
            "description": "Ervaring asked for in the vacancy.",
            "items": {
              "type": "string",
              "enum": [
                "starter",
                "experienced",
                "expert"
              ],
              "enumTitles": [
                "Starter (0–2 years)",
                "Ervaren — experienced (3–7 years)",
                "Expert (7+ years)"
              ]
            }
          },
          "workSchedules": {
            "title": "Working times",
            "type": "array",
            "description": "Werktijden: when the work takes place.",
            "items": {
              "type": "string",
              "enum": [
                "day",
                "evening",
                "night",
                "weekend",
                "shifts",
                "irregular",
                "on-call"
              ],
              "enumTitles": [
                "Dagdienst — day",
                "Avond — evening",
                "Nacht — night",
                "Weekend",
                "Ploegendienst — shifts",
                "Onregelmatig — irregular",
                "Oproep — on call"
              ]
            }
          },
          "companyTypes": {
            "title": "Company types",
            "type": "array",
            "description": "Soort bedrijf: who posted the vacancy.",
            "items": {
              "type": "string",
              "enum": [
                "direct-employer",
                "recruitment-agency",
                "temp-agency"
              ],
              "enumTitles": [
                "Directe werkgever — direct employer",
                "Werving en selectie — recruitment agency",
                "Uitzendbureau — temp agency"
              ]
            }
          },
          "companySizes": {
            "title": "Company sizes",
            "type": "array",
            "description": "Bedrijfsgrootte by number of employees.",
            "items": {
              "type": "string",
              "enum": [
                "small",
                "medium",
                "large",
                "very-large"
              ],
              "enumTitles": [
                "Klein (1–10)",
                "Middel (11–50)",
                "Groot (51–250)",
                "Zeer groot (251+)"
              ]
            }
          },
          "benefits": {
            "title": "Benefits",
            "type": "array",
            "description": "Voordelen the vacancy must offer.",
            "items": {
              "type": "string",
              "enum": [
                "permanent-prospect",
                "direct-permanent",
                "pension",
                "insurance",
                "signing-bonus",
                "bonus",
                "13th-month",
                "profit-sharing",
                "year-end-bonus",
                "weekly-pay",
                "shares",
                "performance-bonus",
                "commission",
                "holiday-pay",
                "lease-car",
                "travel-allowance",
                "bike-plan",
                "fuel-card",
                "charging-card",
                "flexible-hours",
                "extra-holidays",
                "atv-days",
                "birthday-off",
                "birth-leave",
                "volunteer-days",
                "study-budget",
                "growth-opportunities",
                "training",
                "study-paid",
                "coaching",
                "courses",
                "development-plan",
                "shift-allowance",
                "night-allowance",
                "overtime-allowance",
                "irregular-hours-allowance",
                "home-office-allowance",
                "home-workplace",
                "laptop",
                "phone",
                "sports",
                "staff-discount",
                "free-lunch",
                "free-fruit"
              ],
              "enumTitles": [
                "Uitzicht op vast",
                "Direct vast",
                "Pensioen",
                "Verzekeringen",
                "Startbonus",
                "Bonus",
                "13e maand",
                "Winstdeling",
                "Eindejaarsuitkering",
                "Wekelijks betaald",
                "Aandelen",
                "Prestatiebonus",
                "Provisie",
                "Vakantiegeld",
                "Leaseauto",
                "Reiskosten vergoed",
                "Fietsplan",
                "Tankpas",
                "Laadpas",
                "Flexibele uren",
                "Extra vakantie",
                "ATV-dagen",
                "Verjaardag vrij",
                "Geboorteverlof",
                "Vrijwilligersdagen",
                "Studiebudget",
                "Doorgroeikansen",
                "Opleiding",
                "Studie vergoed",
                "Coaching",
                "Trainingen",
                "Ontwikkelplan",
                "Ploegentoeslag",
                "Nachttoeslag",
                "Overwerktoeslag",
                "ORT-toeslag",
                "Thuiswerkvergoeding",
                "Thuiswerkplek",
                "Laptop",
                "Telefoon",
                "Sporten",
                "Personeelskorting",
                "Gratis lunch",
                "Gratis fruit"
              ]
            }
          },
          "noCvRequired": {
            "title": "Only vacancies without CV requirement",
            "type": "boolean",
            "description": "Return only vacancies marked 'CV niet verplicht', where you can apply without a CV.",
            "default": false
          },
          "publishedWithinDays": {
            "title": "Published within (days)",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Only keep vacancies posted at most this many days ago. werkzoeken.nl has no date filter, so the scraper checks each result's posting date; older ones are skipped and not charged. Ages shown as weeks ('2 weken geleden') count as the lower bound (14 days)."
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Stop each search after this many result pages (50 vacancies per page). 0 = no limit; Max results still applies. Useful with 'Published within', which skips results without stopping the search.",
            "default": 0
          },
          "incrementalMode": {
            "title": "Incremental mode",
            "type": "boolean",
            "description": "Track vacancies across runs. The first run builds a baseline; later runs return only NEW, UPDATED and REAPPEARED vacancies, each with changeType, firstSeenAt and lastSeenAt.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Name for the saved tracking state. Runs with the same key compare against each other. Leave empty to derive one from the search input."
          },
          "emitUnchanged": {
            "title": "Include unchanged vacancies",
            "type": "boolean",
            "description": "In incremental mode, also return vacancies that did not change (changeType UNCHANGED).",
            "default": false
          },
          "emitExpired": {
            "title": "Include expired vacancies",
            "type": "boolean",
            "description": "In incremental mode, also return tracked vacancies that are no longer listed (changeType EXPIRED). Only checked when every search ran to its last page.",
            "default": false
          },
          "skipReposts": {
            "title": "Skip reposts",
            "type": "boolean",
            "description": "In incremental mode, drop new vacancies that match an expired one by title, company, location, contract and description.",
            "default": false
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Return only core fields (title, company, location, salary, hours, contract, education, dates, URLs, description). Smaller rows for AI agents and spreadsheets.",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "Description max length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters. 0 = full text.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "werkzoeken.nl blocks datacenter IPs, so Apify residential proxies in the Netherlands are used by default. Proxy cost is included in the event prices.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "NL"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}