{ "openapi": "3.0.1", "info": { "title": "EURES Jobs Scraper – 2M EU & Swiss Job Vacancies", "description": "Search ~2 million job vacancies from European public employment services on EURES (ELA), incl. 45,000+ Swiss jobs: keyword, country/NUTS region, ESCO occupation, contract type, date. Employer, salary, skills, apply link, only-new alerts. $0.80 per 1,000 jobs.", "version": "0.1", "x-build-id": "R02eophMS1YVu7XgU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gazidev~eures-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gazidev-eures-jobs", "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/gazidev~eures-jobs/runs": { "post": { "operationId": "runs-sync-gazidev-eures-jobs", "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/gazidev~eures-jobs/run-sync": { "post": { "operationId": "run-sync-gazidev-eures-jobs", "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 title, skill or employer words, e.g. \"nurse\", \"software developer\", \"Krankenpfleger\". Each keyword is a separate search. Vacancies are in the employer's language, so add local-language terms for better coverage. Leave empty to list all vacancies matching the filters.", "items": { "type": "string" } }, "keywordIn": { "title": "Search keywords in", "enum": [ "everywhere", "title", "description", "employer" ], "type": "string", "description": "Where the keyword must appear. 'Job title' gives the most precise results; 'Everywhere' matches any of the words anywhere in the vacancy (use with 'Best match' sorting).", "default": "title" }, "countries": { "title": "Countries or regions", "type": "array", "description": "ISO country codes (de, fr, nl, at, se, es, it, pl, ... - Greece is el) or country names, or NUTS-1/NUTS-2 region codes (e.g. dea = Nordrhein-Westfalen, fr10 = Ile-de-France, nl32 = Noord-Holland). Empty = all 30 EURES countries.", "items": { "type": "string" } }, "occupations": { "title": "Occupations (ESCO)", "type": "array", "description": "Free-text occupation in English (e.g. \"nurse\", \"truck driver\") resolved to the best ESCO occupation, or ESCO occupation URIs (http://data.europa.eu/esco/occupation/...). Works across all languages because vacancies are tagged with ESCO codes.", "items": { "type": "string" } }, "publicationPeriod": { "title": "Published within", "enum": [ "any", "1d", "3d", "7d", "30d" ], "type": "string", "description": "Only vacancies published in this period.", "default": "any" }, "positionSchedule": { "title": "Working time", "type": "array", "description": "Full-time, part-time or flexible. Empty = any.", "items": { "type": "string", "enum": [ "fulltime", "parttime", "flextime" ], "enumTitles": [ "Full-time", "Part-time", "Flexible" ] } }, "positionOffering": { "title": "Contract type", "type": "array", "description": "Empty = any.", "items": { "type": "string", "enum": [ "directhire", "contract", "temporary", "temporarytohire", "contracttohire", "seasonal", "internship", "apprenticeship", "selfemployed", "volunteer", "oncall" ], "enumTitles": [ "Permanent (direct hire)", "Fixed-term contract", "Temporary / agency", "Temporary to hire", "Contract to hire", "Seasonal", "Internship", "Apprenticeship", "Self-employed", "Volunteer", "On call" ] } }, "requiredExperience": { "title": "Required experience", "type": "array", "description": "Empty = any. Most vacancies do not state experience, so this filter narrows results strongly.", "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" ] } }, "education": { "title": "Education level", "type": "array", "description": "Empty = any.", "items": { "type": "string", "enum": [ "basic", "medium", "tertiary", "bachelor", "master", "doctoral" ], "enumTitles": [ "Basic", "Upper secondary / vocational", "Short tertiary", "Bachelor", "Master", "Doctoral" ] } }, "requiredLanguages": { "title": "Required language", "type": "array", "description": "ISO language codes (e.g. en). Only vacancies that list this language as a requirement.", "items": { "type": "string" } }, "euresFlagOnly": { "title": "Only employers recruiting EU-mobile candidates (EURES flag)", "type": "boolean", "description": "Only vacancies where the employer explicitly wants applicants from other EU/EEA countries.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevance" ], "type": "string", "description": "Order of results.", "default": "newest" }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "SLOW: one extra request per vacancy, and EURES asks for 10 seconds between requests (robots.txt Crawl-delay), so details take about 10 s per vacancy (30 vacancies = 5 min). Adds full description, city and postal code, salary, start date, application deadline, required skills and languages, application instructions, apply URL and the source employment service. Charged as an extra 'job-details' event.", "default": false }, "includeContacts": { "title": "Include recruiter contacts", "type": "boolean", "description": "With full details: recruiter name, email and phone when the vacancy publishes them. Personal data - you are responsible for a lawful GDPR basis for processing it.", "default": false }, "maxDetailedItems": { "title": "Max vacancies with full details", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Only the first N vacancies get full details (about 10 s each); the rest are saved with the search fields only. Max 1,000 (about 3 hours).", "default": 30 }, "maxItems": { "title": "Max vacancies", "minimum": 0, "type": "integer", "description": "Stop after this many vacancies. 0 = no limit. Speed: 50 vacancies per request, one request every 10 s (EURES crawl-delay) = about 300 vacancies per minute without details. Searches over 10,000 results are split by region automatically.", "default": 100 }, "onlyNew": { "title": "Only new vacancies since the last run", "type": "boolean", "description": "Remembers vacancies already returned (named key-value store 'eures-jobs-state') and outputs only new ones. Ideal for scheduled job alerts. Seen vacancies are free.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Separate 'already seen' lists for different monitors.", "default": "default" } } }, "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 } } } } } } } } } }