{
"openapi": "3.0.1",
"info": {
"title": "🇪🇺 EURES European Jobs Scraper — 2M+ Jobs, 31 Countries",
"description": "Scrape 2M+ live vacancies from EURES, the EU's official job portal covering 31 European countries — no login, no cookies, no proxies. Filter by keyword, country, contract type, working time, education & experience. Clean JSON with employer, apply URL, dates. Delta mode for job alerts.",
"version": "0.1",
"x-build-id": "BJ8XvB0POzkH34fpt"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/nomad-agent~eures-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-nomad-agent-eures-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/nomad-agent~eures-scraper/runs": {
"post": {
"operationId": "runs-sync-nomad-agent-eures-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/nomad-agent~eures-scraper/run-sync": {
"post": {
"operationId": "run-sync-nomad-agent-eures-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": "One or more search terms. The scraper fans one API call per keyword and deduplicates results. Leave empty to use a built-in set of professional role seeds.",
"items": {
"type": "string"
}
},
"locationCodes": {
"title": "Country / NUTS codes",
"type": "array",
"description": "Restrict results to specific EU countries or NUTS regions. Use ISO 3166-1 alpha-2 country codes (e.g. de, es, fr) or NUTS codes. Leave empty to search all EU member states.",
"items": {
"type": "string"
}
},
"publishedWithin": {
"title": "Posted within",
"enum": [
"day",
"week",
"month"
],
"type": "string",
"description": "Only fetch vacancies EURES marks as posted within this time window (filtered server-side by the EURES API itself). Last 7 days matches this Actor's previous fixed behaviour.",
"default": "week"
},
"contractType": {
"title": "Contract type",
"type": "array",
"description": "Keep only vacancies offering at least one of these contract types (filtered server-side by EURES). Leave empty for all contract types.",
"items": {
"type": "string",
"enum": [
"directhire",
"temporary",
"temporarytohire",
"contracttohire",
"contract",
"apprenticeship",
"internship",
"seasonal",
"selfemployed",
"oncall",
"volunteer",
"recruitmentreserve"
],
"enumTitles": [
"Direct hire (permanent)",
"Temporary",
"Temp-to-hire",
"Contract-to-hire",
"Contract",
"Apprenticeship",
"Internship",
"Seasonal",
"Self-employed",
"On-call",
"Volunteer",
"Recruitment reserve"
]
},
"default": []
},
"workingTime": {
"title": "Working time",
"type": "array",
"description": "Keep only vacancies with at least one of these working-time patterns (filtered server-side by EURES). Leave empty for any working time.",
"items": {
"type": "string",
"enum": [
"fulltime",
"parttime",
"flextime"
],
"enumTitles": [
"Full-time",
"Part-time",
"Flexible hours"
]
},
"default": []
},
"educationLevel": {
"title": "Education level",
"type": "array",
"description": "Keep only vacancies requiring at least one of these education levels (filtered server-side by EURES). Leave empty for any education level.",
"items": {
"type": "string",
"enum": [
"basic",
"medium",
"tertiary",
"bachelor",
"master",
"doctoral"
],
"enumTitles": [
"Basic (primary / lower secondary)",
"Medium (upper secondary)",
"Tertiary (short-cycle)",
"Bachelor",
"Master",
"Doctoral"
]
},
"default": []
},
"experienceLevel": {
"title": "Required experience",
"type": "array",
"description": "Keep only vacancies requiring at least one of these experience bands (filtered server-side by EURES). Leave empty for any experience level.",
"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"
]
},
"default": []
},
"titleExclude": {
"title": "Title must NOT contain",
"type": "array",
"description": "Skip listings whose title contains any of these case-insensitive terms.",
"default": [],
"items": {
"type": "string"
}
},
"companyExclude": {
"title": "Company must NOT contain",
"type": "array",
"description": "Skip listings whose company name contains any of these case-insensitive terms.",
"default": [],
"items": {
"type": "string"
}
},
"onlyNewSinceLastRun": {
"title": "Only new since last run (delta mode)",
"type": "boolean",
"description": "Incremental mode: remember every vacancy id returned on previous runs and emit only postings not seen before. Ideal for scheduled runs / job-alert bots. State is kept in a named key-value store and persists across runs, so you only pay for genuinely new vacancies.",
"default": false
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum number of vacancies to return across all keyword queries. Combined with deduplication, this is a hard cap on pushed records. Each result returned is billed — see the Actor's Pricing tab — so set this only as high as you need.",
"default": 50
},
"timeoutSeconds": {
"title": "Request timeout (seconds)",
"minimum": 5,
"maximum": 120,
"type": "integer",
"description": "How long to wait for a reply from the EURES API before giving up on that request, in seconds.",
"default": 20
},
"cacheTtlSeconds": {
"title": "Cache TTL (seconds)",
"minimum": 0,
"type": "integer",
"description": "Reuse a search's results for this many seconds instead of asking EURES again, so quick repeat runs are faster and cheaper. Set 0 to always fetch fresh results.",
"default": 1800
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}