{
  "openapi": "3.0.1",
  "info": {
    "title": "EURES Jobs Scraper [$0.60/1k] - EU Job Vacancies, 31 Countries",
    "description": "$0.60 per 1,000 jobs. Search EU job vacancies on the official EURES portal (1.9M+ jobs, 31 countries). Input: keywords, countries, NUTS regions, ESCO occupations, contract type, working time, posted-within days. Returns per job: title, employer, country, city, occupation, salary, posted date, URL.",
    "version": "1.0",
    "x-build-id": "Y4jy9ejciSHAVlZpd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/kadi_bence~eures-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-kadi_bence-eures-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/kadi_bence~eures-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-kadi_bence-eures-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/kadi_bence~eures-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-kadi_bence-eures-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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Job titles or skills, e.g. \"software developer\", \"nurse\", \"Python\". Each keyword is a separate search (results are merged and de-duplicated). Leave empty for all jobs. Put places in Countries or Regions, not here.",
            "items": {
              "type": "string"
            }
          },
          "searchIn": {
            "title": "Match keywords in",
            "enum": [
              "everywhere",
              "title"
            ],
            "type": "string",
            "description": "Where EURES looks for the keywords.",
            "default": "everywhere"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest"
            ],
            "type": "string",
            "description": "EURES matches keyword words loosely (any word, any language version), so \"Best match\" (default with keywords) puts the real matches first. Without keywords the order is always newest first."
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "EU/EEA countries plus Switzerland. Leave empty for all 31 EURES countries. Via the API, \"GR\" and English country names also work for Greece. UK jobs are not in EURES.",
            "items": {
              "type": "string",
              "enum": [
                "AT",
                "BE",
                "BG",
                "HR",
                "CY",
                "CZ",
                "DK",
                "EE",
                "FI",
                "FR",
                "DE",
                "EL",
                "HU",
                "IS",
                "IE",
                "IT",
                "LV",
                "LI",
                "LT",
                "LU",
                "MT",
                "NL",
                "NO",
                "PL",
                "PT",
                "RO",
                "SK",
                "SI",
                "ES",
                "SE",
                "CH"
              ],
              "enumTitles": [
                "Austria (AT)",
                "Belgium (BE)",
                "Bulgaria (BG)",
                "Croatia (HR)",
                "Cyprus (CY)",
                "Czechia (CZ)",
                "Denmark (DK)",
                "Estonia (EE)",
                "Finland (FI)",
                "France (FR)",
                "Germany (DE)",
                "Greece (EL)",
                "Hungary (HU)",
                "Iceland (IS)",
                "Ireland (IE)",
                "Italy (IT)",
                "Latvia (LV)",
                "Liechtenstein (LI)",
                "Lithuania (LT)",
                "Luxembourg (LU)",
                "Malta (MT)",
                "Netherlands (NL)",
                "Norway (NO)",
                "Poland (PL)",
                "Portugal (PT)",
                "Romania (RO)",
                "Slovakia (SK)",
                "Slovenia (SI)",
                "Spain (ES)",
                "Sweden (SE)",
                "Switzerland (CH)"
              ]
            }
          },
          "regions": {
            "title": "Regions (NUTS 2)",
            "type": "array",
            "description": "Optional NUTS region codes or names, e.g. \"FR10\", \"Île-de-France\", \"Bayern\", \"DE21\". EURES filters by NUTS 2: a NUTS 1 area is expanded to its NUTS 2 regions, a NUTS 3 code is widened to its NUTS 2 region. A region narrows its own country only (countries IE + DE with region Bayern = all of Ireland, only Bayern in Germany).",
            "items": {
              "type": "string"
            }
          },
          "occupations": {
            "title": "Occupations (ESCO / ISCO)",
            "type": "array",
            "description": "ESCO occupation URIs, ISCO-08 codes (e.g. \"2512\" software developers, \"5120\" cooks, \"2221\" nursing professionals) or English occupation names (e.g. \"chef\", \"truck driver\"). A name that is not an exact ESCO label matches up to 25 close ESCO occupations; the log lists them.",
            "items": {
              "type": "string"
            }
          },
          "publishedWithinDays": {
            "title": "Published within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Only jobs published or updated in the last N days (the EURES \"published\" filter; e.g. 1 for daily alerts). 0 = any date. Many feeds refresh old ads, so the posted date can be older than N days."
          },
          "contractTypes": {
            "title": "Contract type",
            "type": "array",
            "description": "Type of position offered.",
            "items": {
              "type": "string",
              "enum": [
                "directhire",
                "temporary",
                "contract",
                "contracttohire",
                "temporarytohire",
                "seasonal",
                "apprenticeship",
                "internship",
                "selfemployed",
                "oncall",
                "recruitmentreserve",
                "volunteer"
              ],
              "enumTitles": [
                "Direct hire",
                "Temporary",
                "Contract",
                "Contract to hire",
                "Temporary to hire",
                "Seasonal",
                "Apprenticeship",
                "Internship",
                "Self-employed",
                "On call",
                "Recruitment reserve",
                "Volunteer"
              ]
            }
          },
          "workingTime": {
            "title": "Working time",
            "type": "array",
            "description": "Full-time, part-time or flexible hours.",
            "items": {
              "type": "string",
              "enum": [
                "fulltime",
                "parttime",
                "flextime"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Flexible"
              ]
            }
          },
          "educationLevels": {
            "title": "Education level",
            "type": "array",
            "description": "Required education (ISCED / EQF levels).",
            "items": {
              "type": "string",
              "enum": [
                "basic",
                "secondary",
                "shortTertiary",
                "bachelor",
                "master",
                "doctoral"
              ],
              "enumTitles": [
                "Basic (primary / lower secondary)",
                "Upper secondary / post-secondary",
                "Short-cycle tertiary",
                "Bachelor's",
                "Master's",
                "Doctoral"
              ]
            }
          },
          "experience": {
            "title": "Experience required",
            "type": "array",
            "description": "Required work experience.",
            "items": {
              "type": "string",
              "enum": [
                "none_required",
                "up_to_1_year",
                "between_1_and_2_years",
                "between_2_and_5_years",
                "more_than_5_years"
              ],
              "enumTitles": [
                "None required",
                "Up to 1 year",
                "1-2 years",
                "2-5 years",
                "More than 5 years"
              ]
            }
          },
          "sectors": {
            "title": "Sector (NACE)",
            "type": "array",
            "description": "Employer sector (NACE section).",
            "items": {
              "type": "string",
              "enum": [
                "a",
                "b",
                "c",
                "d",
                "e",
                "f",
                "g",
                "h",
                "i",
                "j",
                "k",
                "l",
                "m",
                "n",
                "o",
                "p",
                "q",
                "r",
                "s",
                "t",
                "u"
              ],
              "enumTitles": [
                "A - Agriculture, forestry & fishing",
                "B - Mining & quarrying",
                "C - Manufacturing",
                "D - Electricity & gas supply",
                "E - Water supply & waste",
                "F - Construction",
                "G - Wholesale & retail trade",
                "H - Transport & storage",
                "I - Accommodation & food service",
                "J - Information & communication",
                "K - Financial & insurance",
                "L - Real estate",
                "M - Professional, scientific & technical",
                "N - Administrative & support services",
                "O - Public administration & defence",
                "P - Education",
                "Q - Human health & social work",
                "R - Arts, entertainment & recreation",
                "S - Other service activities",
                "T - Households as employers",
                "U - Extraterritorial organisations"
              ]
            }
          },
          "languages": {
            "title": "Required languages (your level)",
            "type": "array",
            "description": "Languages the job asks for, as two-letter codes with your optional CEFR level: \"en\", \"de:B2\". EURES returns jobs that need the language at that level or lower; without a level any level matches.",
            "items": {
              "type": "string"
            }
          },
          "adLanguages": {
            "title": "Ad written in",
            "type": "array",
            "description": "Only ads written in these languages (e.g. English-language ads in Germany). Filtered after the search, so a narrow choice can scan many pages.",
            "items": {
              "type": "string",
              "enum": [
                "bg",
                "cs",
                "da",
                "de",
                "el",
                "en",
                "es",
                "et",
                "fi",
                "fr",
                "ga",
                "hr",
                "hu",
                "is",
                "it",
                "lt",
                "lv",
                "mt",
                "nl",
                "no",
                "pl",
                "pt",
                "ro",
                "sk",
                "sl",
                "sv"
              ],
              "enumTitles": [
                "Bulgarian",
                "Czech",
                "Danish",
                "German",
                "Greek",
                "English",
                "Spanish",
                "Estonian",
                "Finnish",
                "French",
                "Irish",
                "Croatian",
                "Hungarian",
                "Icelandic",
                "Italian",
                "Lithuanian",
                "Latvian",
                "Maltese",
                "Dutch",
                "Norwegian",
                "Polish",
                "Portuguese",
                "Romanian",
                "Slovak",
                "Slovenian",
                "Swedish"
              ]
            }
          },
          "euresFlagOnly": {
            "title": "Only EURES-flagged jobs",
            "type": "boolean",
            "description": "Only jobs whose employer explicitly wants to recruit from other EU countries.",
            "default": false
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many jobs. 0 = no limit. The default without input (API, MCP and AI-agent calls) is 20. The limit is shared fairly across keywords and countries/regions. Big searches are split by country / NUTS 2 region to get past the EURES 10,000-per-search cap.",
            "default": 20
          },
          "includeDetails": {
            "title": "Fetch full details (slow)",
            "type": "boolean",
            "description": "Opens every vacancy for city, postal code, salary, deadline, start date, education, experience, required languages and the apply link. europa.eu asks for 10 s between requests, so this gives about 6 jobs per minute (vs about 300 without). Same price per job. Best for targeted runs of a few hundred jobs or daily alerts.",
            "default": false
          },
          "preferredLanguage": {
            "title": "Preferred text language",
            "enum": [
              "bg",
              "cs",
              "da",
              "de",
              "el",
              "en",
              "es",
              "et",
              "fi",
              "fr",
              "ga",
              "hr",
              "hu",
              "is",
              "it",
              "lt",
              "lv",
              "mt",
              "nl",
              "no",
              "pl",
              "pt",
              "ro",
              "sk",
              "sl",
              "sv"
            ],
            "type": "string",
            "description": "If an ad has several language versions (e.g. Belgium), use this one."
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "text",
              "html",
              "both",
              "none"
            ],
            "type": "string",
            "description": "Job description as plain text, HTML, both, or none (smaller dataset). E-mails, phone numbers and contact persons are always removed.",
            "default": "text"
          },
          "onlyNewJobs": {
            "title": "Only new jobs (monitoring mode)",
            "type": "boolean",
            "description": "Remember returned jobs and output only NEW ones on later runs with the same search. Ideal for daily schedules with \"Published within (days)\" = 1 or 3: you only pay for new jobs.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Separate 'already seen' lists for different schedules with the same search. Use a new name to start over.",
            "default": "default"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Not needed: the EURES API is open. Off by default.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}