# EURES Jobs Scraper — New EU Vacancy Alerts (`magnova/eures-jobs-scraper`) Actor

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.

- **URL**: https://apify.com/magnova/eures-jobs-scraper.md
- **Developed by:** [Magnova](https://apify.com/magnova) (community)
- **Categories:** Automation, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 vacancies

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## EURES Jobs Scraper — New EU Vacancy Alerts

Search **EURES** — the European Employment Services portal, the EU's official job-mobility service — and get structured vacancy records from **2.6M+ live vacancies** published by the national employment services of 31 countries. Search by keyword, country or region, ESCO occupation, offering type, schedule and experience; take the current corpus in one run, or attach a monitor store and receive **only the vacancies that are new** on every run after.

No API key, no login, no proxies. Records are read from the portal's own public search API — the same one the EURES website itself uses.

### What you get

Every delivered record is one vacancy, shaped like this (a real record delivered by this Actor):

```json
{
 "recordType": "VACANCY",
 "vacancyId": "MTAwMDEtMTAwMzk5NTA3OS1TIDE",
 "nationalReference": "10001-1003995079-S",
 "sourceFeedId": 1,
 "jobTitle": "90/2026 Engagierte Pflegefachkraft (m/w/d) für den häuslichen Pflegedienst in Weimar (Pflegefachmann/-frau (Altenpflege))",
 "employerName": "AWO Regionalverband Mitte-West Thüringen e.V.",
 "countries": [
  "DE"
 ],
 "regions": [
  "DEG05"
 ],
 "locationMap": {
  "DE": [
   "DEG05"
  ]
 },
 "publicationDate": "2026-11-10",
 "creationDate": "2026-11-10T23:03:21Z",
 "lastModificationDate": "2026-11-10T23:03:21Z",
 "descriptionSnippet": "Stellenausschreibung 90/2026Der AWO Regionalverband Mitte-West-Thüringen e.V. sucht ab sofort für Vollzeit mit 39 WST eine Pflegefachkraft (m/w/d) für den häuslichen Pflegedienst in Weimar.Wer sind wir?Getreu unserem AWO-Leitbild steht im häuslichen Pflegedienst in Weimar der Mensch im Mittelpunkt – sowohl die Menschen, die wir in ihrem Zuhause begleiten, als auch unsere Mitarbeiter*innen. Unser Team zeichnet sich durch fachliche Kompetenz, Verlässlichkeit und vor allem durch menschliche…",
 "positionOfferingCode": "directhire",
 "positionScheduleCodes": [
  "fulltime"
 ],
 "numberOfPosts": 1,
 "escoCategoryUris": [
  "http://data.europa.eu/esco/occupation/f4525ed8-54eb-4a3b-90db-55cc01b0d9fd",
  "http://data.europa.eu/esco/occupation/50743f62-3d5b-4ef6-b706-00d2b1adfcc3",
  "http://data.europa.eu/esco/occupation/8d3e8aaa-791b-4c75-a465-f3f827028f50"
 ],
 "euresFlag": false,
 "availableLanguages": [
  "de"
 ],
 "vacancyUrl": "https://europa.eu/eures/portal/jv-se/jv-details/MTAwMDEtMTAwMzk5NTA3OS1TIDE?lang=en"
}
```

Titles and descriptions appear in the vacancy's published language when EURES holds no translation — that is how the portal itself presents them.

### Pricing

**$0.002 per vacancy delivered — $2.00 per 1,000 vacancies. No start fee, no platform surcharge from this Actor.**

- A first corpus run capped at 500 vacancies costs **$1.00**.
- A monitor that finds ~600 new matching vacancies in a month costs **~$1.20 that month** (600 × $0.002) — and quiet days cost nothing.
- Tier discounts apply automatically: SILVER pays $0.0017 per vacancy, GOLD and above $0.0014.

**Not charged:**

- Vacancies already seen by your monitor store (duplicates)
- Vacancies outside your `publishedSince` cursor window
- Vacancies silently seeded on a `monitorOnlyNew` first run
- ERROR records and the run SUMMARY record

### Three ways to run it

**1. Corpus (default).** A run delivers the current matches for your search, newest first, up to your per-run cap. This is the backfill: use it to build a dataset, a jobs board or a market snapshot.

**2. Only-new monitoring.** Pick one of your key-value stores as the *Monitor state store* and schedule the run (hourly, daily, weekly). The first run delivers the current matches as a baseline; every later run delivers only vacancies whose EURES id was never seen. The id is a stable composite of the vacancy's national reference and its source feed, minted once by EURES — so only-new works across all 31 national feeds by construction, not by fuzzy matching. Prefer to start clean? Turn on **Start monitoring silently** (`monitorOnlyNew`): the first run remembers the current matches without delivering or charging anything, and only vacancies published afterwards are ever delivered.

**3. Stateless cursor.** Hold state in your own workflow (Make, Zapier, a scheduler) instead: pass `publishedSince` (e.g. `"2026-11-01"`) and only vacancies EURES received on or after that date are delivered. The check runs on each vacancy's own creation timestamp — boundary-inclusive and exact.

### Inputs

| Input | What it does |
|---|---|
| Keywords | A term or phrase — an occupation, a skill, an employer. Matched against the field below. Empty = search by filters alone. |
| Keyword field | `EVERYWHERE` (default), `TITLE`, `DESCRIPTION` or `EMPLOYER`. |
| Countries / regions | Country codes (`de`, `fr`, `pl`…) or NUTS region codes (`de1`, `fr10`…); `de-ns` = country with region unspecified. OR-combined. Empty = all of Europe. |
| Occupation URIs (ESCO) | Filter by ESCO occupation URI. OR-combined. |
| Position offering | `apprenticeship`, `contract`, `contracttohire`, `directhire`, `internship`, `oncall`, `recruitmentreserve`, `seasonal`, `selfemployed`, `temporary`, `temporarytohire`, `volunteer`, `NS`. |
| Work schedule | `fulltime`, `parttime`, `flextime`, `NS`. |
| Required experience | `none_required`, `up_to_1_year`, `between_1_and_2_years`, `between_2_and_5_years`, `more_than_5_years`, `NS`. |
| Sectors (NACE) | A section letter (`a`–`u`) or `NS`. |
| Publication period | EURES-side recency filter: last day / three days / week / month. |
| Published on/after | The stateless cursor described above. |
| Monitor state store | Your key-value store — the memory behind only-new delivery. One store per saved search. |
| Start monitoring silently | Skip the baseline: seed silently, deliver only what's new afterwards. |
| Maximum vacancies per run | Delivery (and charge) cap per run, 1–10,000. Default 500. |
| Maximum total charge per run (USD) | Optional hard stop for the run's charges. |

### Output fields

| Field | Meaning |
|---|---|
| `vacancyId` | The vacancy's EURES id — stable across runs; the only-new key. |
| `nationalReference` / `sourceFeedId` | The vacancy's reference in its national feed, and the numeric id of the employment service that supplied it (both decoded from the EURES id). |
| `jobTitle` | The title as published. |
| `employerName` | The employer's business name as published. A few national feeds publish few or no employer names in the search feed (Spain's is the notable one) — the field is then absent, never invented. |
| `countries` / `regions` / `locationMap` | ISO country codes and NUTS region codes from the portal's location map. |
| `publicationDate` / `creationDate` | The date / timestamp EURES received the vacancy from its national feed (see the FAQ — this is an ingestion timestamp). |
| `lastModificationDate` | When the vacancy last changed on EURES. |
| `descriptionSnippet` | The first ~500 characters of the description as plain text, with any email addresses or phone numbers the posting text contained removed. |
| `positionOfferingCode` / `positionScheduleCodes` | The portal's offering and schedule codes, where the national feed publishes them (some feeds leave schedule lists empty on most postings). |
| `numberOfPosts` | Open positions the vacancy advertises. |
| `escoCategoryUris` | ESCO/ISCO occupation category URIs. |
| `euresFlag` / `availableLanguages` | The cross-border flag, and the languages the vacancy text exists in. |
| `vacancyUrl` | The vacancy's page on the EURES portal. |

Each run also ends with one **SUMMARY** record (totals, duplicates skipped, whether the run caught up or stopped at a cap), and an **ERROR** record if EURES could not be read — in that case nothing is charged and the monitor state is not advanced, so the next run catches up.

### FAQ

**Are the dates the employers' posting dates?** No — and this matters. `creationDate` is when EURES *ingested* the vacancy from its national feed. National feeds land in batches, so a vacancy can appear on EURES days after the employer posted it locally. What this Actor promises is *new on EURES*, exactly and verifiably — never real-time employer posting times.

**Why is there no application-deadline field?** Fewer than half of EURES postings publish a structured deadline, and it is not part of the portal's search feed, so the Actor does not guess one. When an employer set a deadline, the vacancy's EURES page (`vacancyUrl`) shows it.

**Why is there no contact email or phone?** By design. Some postings print a recruiter's email or phone inside the description text; the snippet is scrubbed of both before delivery, and individual contact persons are never read or shipped. Employer *names* — business data, as published — are included.

**How much can one run read?** The portal's search serves at most the 10,000 newest matches of any search (its own result window), and a run delivers at most your per-run cap. For very wide searches, narrow by country, occupation or period — or run a monitor, which only ever reads down to previously-seen territory.

**What if EURES is down or changes shape?** The run writes an ERROR record, charges nothing for undelivered vacancies, and leaves the monitor state untouched so the next run catches up. The Actor also reports its own failures and silent data drift to the publisher automatically.

**Which countries are covered?** All 31 EURES countries (the EU member states plus Iceland, Liechtenstein, Norway and Switzerland), each fed by its national public employment service.

### Legal and data note

EURES is the European Commission's official, public job-mobility portal; the vacancies are published by national public employment services for public dissemination, and this Actor reads them through the portal's own public search API — no login, no account, no CAPTCHA bypass. It ships business and vacancy data only: employer names as published, locations, occupation codes, dates and a contact-scrubbed description snippet. No individual contact persons, email addresses or phone numbers are collected or delivered.

# Actor input Schema

## `countries` (type: `array`):

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.

## `keywordField` (type: `string`):

Which field the keywords match against: EVERYWHERE (the whole vacancy), TITLE (job title only), DESCRIPTION (description text only) or EMPLOYER (employer name only).

## `keywords` (type: `string`):

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` (type: `integer`):

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` (type: `number`):

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` (type: `boolean`):

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` (type: `string`):

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` (type: `array`):

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.

## `positionOfferingCodes` (type: `array`):

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.

## `positionScheduleCodes` (type: `array`):

Optional filter by work schedule. Allowed values: fulltime, parttime, flextime, NS (not specified). Several values are combined with OR. Leave empty for all schedules.

## `publicationPeriod` (type: `string`):

Optional recency filter applied by EURES itself: only vacancies EURES received within the chosen period. Leave on "No period filter" for all dates.

## `publishedSince` (type: `string`):

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` (type: `array`):

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.

## `sectorCodes` (type: `array`):

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.

## Actor input object example

```json
{
  "countries": [
    "de"
  ],
  "keywordField": "EVERYWHERE",
  "keywords": "nurse",
  "maxResults": 100,
  "maxTotalChargeUsd": 1,
  "monitorOnlyNew": false,
  "occupationUris": [
    "http://data.europa.eu/esco/occupation/8d3e8aaa-791b-4c75-a465-f3f827028f50"
  ],
  "positionOfferingCodes": [
    "directhire"
  ],
  "positionScheduleCodes": [
    "fulltime"
  ],
  "publicationPeriod": "LAST_WEEK",
  "publishedSince": "2026-11-01",
  "requiredExperienceCodes": [
    "none_required"
  ],
  "sectorCodes": [
    "q"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "countries": [
        "de"
    ],
    "keywordField": "EVERYWHERE",
    "keywords": "nurse",
    "maxResults": 100,
    "monitorOnlyNew": false,
    "publicationPeriod": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("magnova/eures-jobs-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "countries": ["de"],
    "keywordField": "EVERYWHERE",
    "keywords": "nurse",
    "maxResults": 100,
    "monitorOnlyNew": False,
    "publicationPeriod": "",
}

# Run the Actor and wait for it to finish
run = client.actor("magnova/eures-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "countries": [
    "de"
  ],
  "keywordField": "EVERYWHERE",
  "keywords": "nurse",
  "maxResults": 100,
  "monitorOnlyNew": false,
  "publicationPeriod": ""
}' |
apify call magnova/eures-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,magnova/eures-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/34hgCEqJ86VUq3JvM/builds/mpbgHKkiQPPaUSUX8/openapi.json
