{
  "openapi": "3.0.1",
  "info": {
    "title": "EURES Jobs Scraper — New EU Vacancy Alerts",
    "description": "Search EURES, the EU's official jobs portal — 2.6M+ live vacancies from Europe's national employment services — by keyword, country and occupation. Structured vacancy records plus only-new alerts on any saved search. $0.002 per vacancy, no start fee.",
    "version": "0.0",
    "x-build-id": "mpbgHKkiQPPaUSUX8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/magnova~eures-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-magnova-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/magnova~eures-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-magnova-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/magnova~eures-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-magnova-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": {
          "countries": {
            "title": "Countries / regions (optional — empty = all)",
            "type": "array",
            "description": "Optional location filter: EURES country codes (e.g. \"de\", \"fr\", \"pl\") or NUTS region codes (e.g. \"de1\" for Baden-Württemberg, \"fr10\" for Île-de-France); \"de-ns\" selects vacancies in a country whose region is not specified. Several codes are combined with OR. Leave empty for all of Europe.",
            "items": {
              "type": "string"
            }
          },
          "keywordField": {
            "title": "Keyword field",
            "enum": [
              "EVERYWHERE",
              "TITLE",
              "DESCRIPTION",
              "EMPLOYER"
            ],
            "type": "string",
            "description": "Which field the keywords match against: EVERYWHERE (the whole vacancy), TITLE (job title only), DESCRIPTION (description text only) or EMPLOYER (employer name only)."
          },
          "keywords": {
            "title": "Keywords",
            "type": "string",
            "description": "What to search for on EURES — an occupation, a skill, an employer (e.g. \"nurse\", \"software developer\", \"warehouse\"). Matched against the field chosen in \"Keyword field\". Leave empty to search by country, occupation or filters alone."
          },
          "maxResults": {
            "title": "Maximum vacancies per run",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Hard cap on vacancies delivered (and charged) in one run. Results come back newest first (by the date EURES received them), so a capped run delivers the most recent matches. Vacancies a capped run could not deliver stay unseen in monitoring mode and are delivered by the next run if they still match."
          },
          "maxTotalChargeUsd": {
            "title": "Maximum total charge per run (USD)",
            "minimum": 0.01,
            "type": "number",
            "description": "Optional hard stop for this run's charges: delivery stops as soon as the charged vacancies reach this amount (checked conservatively at the highest per-vacancy price, so the run may stop slightly early on discounted tiers), and the SUMMARY record reports stoppedByMaxCharge. Undelivered new vacancies stay unseen, so the next run delivers them. Leave empty for no cap. The run-level maximum charge in the run options is also honoured exactly."
          },
          "monitorOnlyNew": {
            "title": "Start monitoring silently (skip the first baseline)",
            "type": "boolean",
            "description": "Off (default): the first run delivers the search's current vacancies as a baseline batch (charged), later runs deliver only new ones. On: the first run silently remembers the current vacancies without delivering or charging anything, and only vacancies published afterwards are ever delivered. Only applies when a monitor store is selected; without a store every run is a baseline run."
          },
          "monitorStore": {
            "title": "Monitor state store (for only-new delivery)",
            "type": "string",
            "description": "A key-value store this Actor may read and write to remember which vacancies it has already seen — this is what makes only-new delivery work across runs. Use one store per saved search. Pick any store you own; the Actor keeps one small state record in it. Without a store, every run delivers the search's vacancies as a baseline and remembers nothing. If the store is missing or cannot be opened, the run continues in baseline mode and the SUMMARY record says so — it never crashes. The Actor remembers every vacancy it processed (including ones outside the cursor window), so widening the window later does not re-deliver old vacancies."
          },
          "occupationUris": {
            "title": "Occupation URIs — ESCO (optional — empty = all)",
            "type": "array",
            "description": "Optional filter by ESCO occupation URI (e.g. \"http://data.europa.eu/esco/occupation/8d3e8aaa-791b-4c75-a465-f3f827028f50\" for nursing professionals). Several URIs are combined with OR. Leave empty for all occupations.",
            "items": {
              "type": "string"
            }
          },
          "positionOfferingCodes": {
            "title": "Position offering (optional — empty = all)",
            "type": "array",
            "description": "Optional filter by type of offering. Allowed values: apprenticeship, contract, contracttohire, directhire, internship, oncall, recruitmentreserve, seasonal, selfemployed, temporary, temporarytohire, volunteer, NS (not specified). Several values are combined with OR. Leave empty for all types.",
            "items": {
              "type": "string"
            }
          },
          "positionScheduleCodes": {
            "title": "Work schedule (optional — empty = all)",
            "type": "array",
            "description": "Optional filter by work schedule. Allowed values: fulltime, parttime, flextime, NS (not specified). Several values are combined with OR. Leave empty for all schedules.",
            "items": {
              "type": "string"
            }
          },
          "publicationPeriod": {
            "title": "Publication period (optional)",
            "enum": [
              "",
              "LAST_DAY",
              "LAST_THREE_DAYS",
              "LAST_WEEK",
              "LAST_MONTH"
            ],
            "type": "string",
            "description": "Optional recency filter applied by EURES itself: only vacancies EURES received within the chosen period. Leave on \"No period filter\" for all dates."
          },
          "publishedSince": {
            "title": "Published on/after (stateless cursor)",
            "type": "string",
            "description": "Optional stateless cursor for workflow tools (Make, Zapier, your own scheduler) that hold state themselves: only vacancies EURES received on this ISO date or later are delivered — for example \"2026-11-01\" or \"2026-11-01T00:00:00Z\". The check runs on each vacancy's own creation timestamp, boundary-inclusive and exact. Leave empty for no cursor."
          },
          "requiredExperienceCodes": {
            "title": "Required experience (optional — empty = all)",
            "type": "array",
            "description": "Optional filter by required experience. Allowed values: none_required, up_to_1_year, between_1_and_2_years, between_2_and_5_years, more_than_5_years, NS (not specified). Several values are combined with OR. Leave empty for all levels.",
            "items": {
              "type": "string"
            }
          },
          "sectorCodes": {
            "title": "Sectors — NACE (optional — empty = all)",
            "type": "array",
            "description": "Optional filter by NACE sector: a single section letter (\"a\" agriculture … \"u\") or NS (not specified). Several values are combined with OR. Leave empty for all sectors.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}