# Europa Jobs Search Scraper (`soft_alexist/europa-jobs-search-scraper`) Actor
Scrape job listings from Europa.eu's EURES portal with precision. Collect job titles, descriptions, employer details, locations, employment categories, and more — perfect for job aggregators, labor market analysts, and European recruitment platforms.
- **URL**: https://apify.com/soft\_alexist/europa-jobs-search-scraper.md
- **Developed by:** [Soft Alexist](https://apify.com/soft_alexist) (community)
- **Categories:** Automation, Developer tools, Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Europa Jobs Search Scraper: Extract EU Job Listings Across EURES
---
### What Is Europa.eu?
Europa.eu hosts the EURES (European Employment Services) portal, the European Commission's official job search platform connecting millions of job seekers with employers across EU member states. The platform contains thousands of active listings with multilingual support and standardized job categorization. Manually extracting this data from search results is laborious — the **Europa Jobs Search Scraper** automates collection, delivering clean, structured records at scale.
---
### Overview
The **Europa Jobs Search Scraper** extracts job listings from EURES search result pages, converting unstructured HTML into a complete dataset of 16 rich fields. It is ideal for:
- **Job aggregators** integrating European listings into multi-country platforms
- **Labor market researchers** analyzing EU employment trends
- **Recruitment consultants** building candidate-job matching datasets
- **Data analysts** tracking job availability by sector and region
The scraper handles bulk collections efficiently, supports configurable item limits, and gracefully manages URL failures to ensure reliable, production-grade data extraction.
---
### Input Format
The scraper accepts a JSON configuration specifying search URLs and collection parameters:
```json
{
"urls": [
"https://europa.eu/eures/portal/jv-se/search?page=1&resultsPerPage=50&orderBy=MOST_RECENT&keywordsEverywhere=ICT%20help%20desk%20agent&previousPageType=findJob&lang=en"
],
"ignore_url_failures": true,
"max_items_per_url": 200
}
````
| Field | Description |
|---|---|
| `urls` | Direct links to EURES search result pages (filtered by keyword, location, or category) |
| `max_items_per_url` | Maximum number of job listings to collect per search page (e.g., `200`) |
| `ignore_url_failures` | If `true`, scraper continues if some URLs fail; if `false`, stops on first failure |
> **Note:** You can generate search URLs directly on Europa.eu by filtering by keyword, country, or position type, then paste the full URL into the `urls` array.
***
### Output Format
**Sample output**
```json
{
"title": "Krankenpfleger für das Mobile Team (w/m/d)",
"description": "Unbefristeter Vertrag - Vollzeit oder Teilzeit
Krankenpfleger für das Mobile Team (w/m/d)
Wir bieten
- Einen unbefristeten Vollzeit- oder Teilzeitvertrag
- Ein attraktiver Dienstplan mit einem freien Wochenende pro Monat und Nachtdiensten nur in Ausnahmefällen
- Abwechslungsreiche Arbeit in einem dynamischen Team
- Offenheit für neue Projekte
- Weiterbildungsmöglichkeiten mit Unterstützung der Klinik
- Ein Training Center für Pflege
- Eine Direktion, die sich um das Wohlergehen der Mitarbeiter kümmert
- Arbeitsnormen, die an die Arbeitsbelastung angepasst sind
- Bezahlung nach den Baremen der paritätischen Kommission für private Krankenhäuser
- Außergesetzliche Vorteile (Mahlzeitschecks, Flexibilitätsprämie, usw.)
Über die Klinik St. Josef
Die Klinik Sankt Josef in Sankt Vith bietet eine ganzheitliche Gesundheitsversorgung – physisch, psychisch und sozial – in rund 20 Fachabteilungen in Sankt Vith und Eupen. In diesem leistungsfähigen Akutkrankenhaus arbeiten rund 600 Mitarbeiter in einer familiären Umgebung. Mitarbeiterzufriedenheit, kohäsive Teams und die Anwendung von modernsten pflegewissenschaftlichen Erkenntnissen und Geräten verhelfen der Klinik zu Patientenzufriedenheitswerten, welche sich auf nationaler Ebene messen können. Die Klinik liegt im Grenzgebiet zu Luxemburg und Deutschland, am Treffpunkt von Eifel und Ardennen in der Gemeinde Sankt Vith. Die Region ist seit Generationen bekannt für ihre Gastfreundschaft und ihr hochwertiges touristisches, kulturelles und sportliches Angebot.",
"id": "Mzc0NTggOTAx",
"creation_date": 1783672452000,
"last_modification_date": 1783672452000,
"number_of_posts": 1,
"location_map": {
"b_e": [
"BE336"
]
},
"eures_flag": false,
"job_categories_codes": [
"http://data.europa.eu/esco/isco/C2221"
],
"position_schedule_codes": [
"parttime",
"flextime",
"fulltime"
],
"position_offering_code": "contract",
"employer": {
"name": "Klinik St. Josef VoG",
"legal_i_d": null,
"organisation_size_code": null,
"organisation_ownership_type_code": null,
"website": null,
"sector_codes": [],
"description": null
},
"available_languages": [
"de",
"fr"
],
"score": null,
"translation_type": "FIRST_LANGUAGE",
"translations": {
"de": {
"title": "Krankenpfleger für das Mobile Team (w/m/d)",
"description": "Unbefristeter Vertrag - Vollzeit oder Teilzeit
Krankenpfleger für das Mobile Team (w/m/d)
Wir bieten
- Einen unbefristeten Vollzeit- oder Teilzeitvertrag
- Ein attraktiver Dienstplan mit einem freien Wochenende pro Monat und Nachtdiensten nur in Ausnahmefällen
- Abwechslungsreiche Arbeit in einem dynamischen Team
- Offenheit für neue Projekte
- Weiterbildungsmöglichkeiten mit Unterstützung der Klinik
- Ein Training Center für Pflege
- Eine Direktion, die sich um das Wohlergehen der Mitarbeiter kümmert
- Arbeitsnormen, die an die Arbeitsbelastung angepasst sind
- Bezahlung nach den Baremen der paritätischen Kommission für private Krankenhäuser
- Außergesetzliche Vorteile (Mahlzeitschecks, Flexibilitätsprämie, usw.)
Über die Klinik St. Josef
Die Klinik Sankt Josef in Sankt Vith bietet eine ganzheitliche Gesundheitsversorgung – physisch, psychisch und sozial – in rund 20 Fachabteilungen in Sankt Vith und Eupen. In diesem leistungsfähigen Akutkrankenhaus arbeiten rund 600 Mitarbeiter in einer familiären Umgebung. Mitarbeiterzufriedenheit, kohäsive Teams und die Anwendung von modernsten pflegewissenschaftlichen Erkenntnissen und Geräten verhelfen der Klinik zu Patientenzufriedenheitswerten, welche sich auf nationaler Ebene messen können. Die Klinik liegt im Grenzgebiet zu Luxemburg und Deutschland, am Treffpunkt von Eifel und Ardennen in der Gemeinde Sankt Vith. Die Region ist seit Generationen bekannt für ihre Gastfreundschaft und ihr hochwertiges touristisches, kulturelles und sportliches Angebot."
}
},
"from_url": "https://europa.eu/eures/portal/jv-se/search?page=1&resultsPerPage=50&orderBy=MOST_RECENT&keywordsEverywhere=ICT%20help%20desk%20agent&previousPageType=findJob&lang=en"
}
```
Each scraped job record contains 16 comprehensive fields:
#### Job Identity & Core Info
| Field | Meaning |
|---|---|
| `Title` | Job title as displayed on the EURES listing |
| `ID` | Unique EURES identifier for the job posting |
| `Description` | Full job description provided by the employer |
| `Employer` | Company or organization name offering the role |
#### Dates & Visibility
| Field | Meaning |
|---|---|
| `Creation Date` | Date the job was first posted to EURES |
| `Last Modification Date` | Most recent update to the listing |
| `Number Of Posts` | Quantity of open positions for this role |
#### Classification & Codes
| Field | Meaning |
|---|---|
| `Job Categories Codes` | ISCO (International Standard Classification of Occupations) or EURES category codes |
| `Position Schedule Codes` | Employment type codes (e.g., full-time, part-time, temporary) |
| `Position Offering Code` | Standard EURES classification for the offering type |
#### Geographic & Language Data
| Field | Meaning |
|---|---|
| `Location Map` | Geographic data (region, country, city) for the job |
| `Available Languages` | Languages in which the job description is available |
| `Translations` | List of translated versions of the job listing |
| `Translation Type` | Type of translation applied (e.g., automatic, professional) |
#### Quality & Matching
| Field | Meaning |
|---|---|
| `EURES Flag` | Whether the listing meets EURES quality or promotion standards |
| `Score` | Relevance or match score (if applicant data is provided) |
***
### How to Use
1. **Build search URLs** — Visit Europa.eu/EURES and filter by keyword (e.g., "ICT help desk"), country, or sector. Copy the full search URL from your browser.
2. **Prepare JSON config** — Add URLs to the `urls` array. Adjust `max_items_per_url` based on how many results per page you need (typical EURES pages show 10–50 per page).
3. **Enable failure tolerance** — Set `ignore_url_failures: true` for bulk runs to prevent interruptions if a single URL fails.
4. **Execute the scraper** — Start the actor and monitor progress in real time.
5. **Export & analyze** — Download results as JSON, CSV, or Excel; integrate into dashboards, databases, or BI tools.
**Best practices:**
- Use specific search filters (keyword, country, sector) to reduce noise and increase data relevance.
- Increase `max_items_per_url` for multi-page results if you want comprehensive coverage.
- Test with a single URL before scaling to bulk collections.
***
### Use Cases & Business Value
- **Cross-border recruitment platforms** aggregate EU jobs at scale for jobseekers across multiple countries
- **Labor market intelligence** track sector growth, salary trends, and skills demand across Europe
- **Academic research** analyze EU employment patterns, job mobility, and sector shifts
- **Candidate matching** build datasets to recommend roles based on skillsets and preferences
- **Competitive analysis** monitor competitor job postings and hiring strategy
The Europa Jobs Search Scraper eliminates manual copy-paste work, delivering production-ready datasets that power recruitment platforms, dashboards, and strategic business decisions.
***
### Conclusion
The **Europa Jobs Search Scraper** is an essential tool for anyone building European job platforms, conducting labor market research, or aggregating EURES listings at scale. With 16 standardized output fields and flexible configuration, it transforms EURES search pages into clean, actionable data ready for immediate use.
# Actor input Schema
## `urls` (type: `array`):
Add the URLs of the Jobs list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.
## `ignore_url_failures` (type: `boolean`):
If true, the scraper will continue running even if some URLs fail to be scraped.
## `max_items_per_url` (type: `integer`):
The maximum number of items to scrape per URL.
## Actor input object example
```json
{
"urls": [
"https://europa.eu/eures/portal/jv-se/search?page=1&resultsPerPage=50&orderBy=MOST_RECENT&keywordsEverywhere=ICT%20help%20desk%20agent&previousPageType=findJob&lang=en"
],
"ignore_url_failures": true,
"max_items_per_url": 20
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"urls": [
"https://europa.eu/eures/portal/jv-se/search?page=1&resultsPerPage=50&orderBy=MOST_RECENT&keywordsEverywhere=ICT%20help%20desk%20agent&previousPageType=findJob&lang=en"
],
"ignore_url_failures": true,
"max_items_per_url": 20
};
// Run the Actor and wait for it to finish
const run = await client.actor("soft_alexist/europa-jobs-search-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"urls": ["https://europa.eu/eures/portal/jv-se/search?page=1&resultsPerPage=50&orderBy=MOST_RECENT&keywordsEverywhere=ICT%20help%20desk%20agent&previousPageType=findJob&lang=en"],
"ignore_url_failures": True,
"max_items_per_url": 20,
}
# Run the Actor and wait for it to finish
run = client.actor("soft_alexist/europa-jobs-search-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"urls": [
"https://europa.eu/eures/portal/jv-se/search?page=1&resultsPerPage=50&orderBy=MOST_RECENT&keywordsEverywhere=ICT%20help%20desk%20agent&previousPageType=findJob&lang=en"
],
"ignore_url_failures": true,
"max_items_per_url": 20
}' |
apify call soft_alexist/europa-jobs-search-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=soft_alexist/europa-jobs-search-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Europa Jobs Search Scraper",
"description": "Scrape job listings from Europa.eu's EURES portal with precision. Collect job titles, descriptions, employer details, locations, employment categories, and more — perfect for job aggregators, labor market analysts, and European recruitment platforms.",
"version": "0.0",
"x-build-id": "RTHDwajQ4eACIXDMd"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/soft_alexist~europa-jobs-search-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-soft_alexist-europa-jobs-search-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/soft_alexist~europa-jobs-search-scraper/runs": {
"post": {
"operationId": "runs-sync-soft_alexist-europa-jobs-search-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/soft_alexist~europa-jobs-search-scraper/run-sync": {
"post": {
"operationId": "run-sync-soft_alexist-europa-jobs-search-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": {
"urls": {
"title": "URLs of the Jobs list urls to scrape",
"type": "array",
"description": "Add the URLs of the Jobs list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
"items": {
"type": "string"
}
},
"ignore_url_failures": {
"title": "Continue running even if some URLs fail to be scraped",
"type": "boolean",
"description": "If true, the scraper will continue running even if some URLs fail to be scraped."
},
"max_items_per_url": {
"title": "Max items per URL",
"type": "integer",
"description": "The maximum number of items to scrape per URL."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```