# 🇪🇺 EURES European Jobs Scraper — 2M+ Jobs, 31 Countries (`nomad-agent/eures-scraper`) Actor

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.

- **URL**: https://apify.com/nomad-agent/eures-scraper.md
- **Developed by:** [Nomad.Dev](https://apify.com/nomad-agent) (community)
- **Categories:** Jobs
- **Stats:** 12 total users, 6 monthly users, 64.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.30 / 1,000 job results

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## 🇪🇺 EURES European Jobs Scraper — 2M+ Jobs, 31 Countries

> **Claude / Codex skill to describe and setup this actor: [SKILL.md](https://github.com/Exdenta/OinkAIJobSearch/blob/main/skill/eures-scraper/SKILL.md)**

Search **2M+ live vacancies** on EURES, the European Commission's official job-mobility portal covering **31 European countries** (EU + EEA + Switzerland), via its public jv-search REST API.

- **No login, no cookies, no proxies** — reads the official public API directly
- **Server-side filters** — keyword, country/NUTS region, contract type, working time, education, experience, posting age
- **Clean, flat JSON** — employer, apply URL, posted date, ESCO occupation categories
- **Delta mode** — scheduled runs emit only postings not seen before, so job-alert pipelines pay only for new results

### What EURES jobs data does this scraper extract?

Each result is one flat JSON record per job posting:

| Field | Meaning |
|---|---|
| `id` | Stable source-side identifier |
| `title` | Job title as posted |
| `company` | Hiring company / organisation (`null` if EURES doesn't disclose one) |
| `country` | ISO country code(s) the vacancy is located in (e.g. `"DE"`, or `"DE, FR"` for multi-country postings). EURES exposes country + NUTS-region codes, not free-text city names, so this is code data, not a street address |
| `location` | Deprecated alias of `country` — identical value, kept for backward compatibility. New integrations should read `country` |
| `url` | Direct link to the posting on the EURES portal |
| `postedAt` | Posting date (`YYYY-MM-DD`), or `null` if EURES didn't supply a valid creation date |
| `lastModifiedAt` | Date the posting was last updated (`YYYY-MM-DD`), or `null` |
| `contractType` | Contract type code, e.g. `directhire` (permanent), `temporary`, `internship`, `apprenticeship`, `seasonal`, `selfemployed`… (`null` if unspecified) |
| `workingTime` | Working-time codes, e.g. `["fulltime"]`, `["parttime"]`, `["flextime"]` (`null` if unspecified) |
| `jobCategories` | ESCO occupation URIs the vacancy is classified under (`null` if unclassified) |
| `languages` | ISO 639-1 codes the vacancy is advertised in, e.g. `["en", "fr"]` (`null` if none) |
| `numberOfPosts` | How many positions this vacancy is hiring for (`null` if not stated) |
| `euresFlag` | `true` when flagged as a cross-border / EURES-network opportunity |
| `employerWebsite` | Employer website URL when disclosed (often `null` — EURES rarely populates it) |
| `employerSector` | NACE economic-sector codes for the employer (often `null`) |
| `snippet` | Short plain-text description excerpt (HTML stripped) |
| `source` | Always `"eures"` |

### How to scrape EURES jobs with this Actor

1. Click **Try for free** / **Run** — no login to the target site, no cookies, no proxies to configure.
2. Adjust the input (keyword, filters, `maxItems`) or keep the defaults.
3. Run it and export the dataset as JSON, CSV or Excel, or read it over the [API](https://docs.apify.com/api/v2).

Run it from your own code:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("nomad-agent/eures-scraper").call(run_input={"maxItems": 50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], "—", item["company"], item["url"])
```

Or a single HTTP call that runs the Actor and returns items in one response:

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/nomad-agent~eures-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"maxItems": 50}'
```

### Input

| Field | Type | Default | Notes |
|---|---|---|---|
| `keywords` | array | *(built-in seeds)* | 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. |
| `locationCodes` | array | *(all EU)* | 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. |
| `publishedWithin` | string (`day`|`week`|`month`) | `week` | Only fetch vacancies EURES marks as posted within this window (filtered server-side by the EURES API). `week` matches this Actor's previous fixed behaviour. |
| `contractType` | array (multi-select) | *(all)* | Server-side filter: keep only vacancies offering one of these contract types (`directhire`, `temporary`, `temporarytohire`, `contracttohire`, `contract`, `apprenticeship`, `internship`, `seasonal`, `selfemployed`, `oncall`, `volunteer`, `recruitmentreserve`). |
| `workingTime` | array (multi-select) | *(all)* | Server-side filter: keep only vacancies with one of these working-time patterns (`fulltime`, `parttime`, `flextime`). |
| `educationLevel` | array (multi-select) | *(all)* | Server-side filter: keep only vacancies requiring one of these education levels (`basic`, `medium`, `tertiary`, `bachelor`, `master`, `doctoral`). |
| `experienceLevel` | array (multi-select) | *(all)* | Server-side filter: keep only vacancies requiring one of these experience bands (`none_required`, `up_to_1_year`, `between_1_and_2_years`, `between_2_and_5_years`, `more_than_5_years`). |
| `titleExclude` | array of strings | `[]` | Skip listings whose title contains any of these case-insensitive terms. |
| `companyExclude` | array of strings | `[]` | Skip listings whose company name contains any of these case-insensitive terms. |
| `onlyNewSinceLastRun` | boolean | `false` | Delta / incremental mode: remember every vacancy id returned on previous runs and emit only postings not seen before. Ideal for scheduled runs / job-alert bots — you pay only for genuinely new vacancies. State persists in a named key-value store across runs. |
| `maxItems` | integer | `50` (max `5000`) | 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 Pricing below. |
| `timeoutSeconds` *(Advanced)* | integer | `20` | How long to wait for a reply from the EURES API before giving up on that request, in seconds. |
| `cacheTtlSeconds` *(Advanced)* | integer | `1800` | 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. |

### Output example

```json
{
  "id": "8823771",
  "title": "Mechatronics Technician",
  "company": "Siemens AG",
  "country": "DE",
  "location": "DE",
  "url": "https://europa.eu/eures/portal/jv-se/jv-details/8823771",
  "postedAt": "2026-06-30",
  "lastModifiedAt": "2026-07-01",
  "contractType": "directhire",
  "workingTime": ["fulltime"],
  "jobCategories": ["http://data.europa.eu/esco/occupation/1234abcd-..."],
  "languages": ["de", "en"],
  "numberOfPosts": 1,
  "euresFlag": false,
  "employerWebsite": null,
  "employerSector": null,
  "snippet": "Siemens is hiring a mechatronics technician...",
  "source": "eures"
}
```

### Integrations

Export the dataset as JSON, CSV or Excel from the Console, pull it over the [Apify API](https://docs.apify.com/api/v2) (e.g. `run-sync-get-dataset-items` for a single blocking call), wire it into Make/Zapier/n8n, or call it as a tool from AI agents via the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp).

### Pricing

Pay per event: **$0.005 per Actor start** and **$0.003 per job returned**.
100 jobs ≈ $0.305. No subscription, no rental — you pay only for what you fetch.

### Use cases

- Pan-EU job boards and relocation services
- Cross-border labour-market research
- Job-alert bots for EU-wide searches
- Feeding matching engines with EU-wide supply

### How this EURES scraper compares

| | This Actor | Typical alternatives |
|---|---|---|
| Data source | Official EURES public REST API — no headless browser, so runs finish in seconds | HTML scraping or browser automation |
| Delta mode | ✅ `onlyNewSinceLastRun` remembers past results across runs — scheduled alerts pay only for new postings | ❌ every run re-bills the same postings |
| Server-side filters | Contract type (12 values), working time, education, experience, country/NUTS region, posting age — filtered by EURES itself, so you're never billed for records you'd discard | usually keyword + country only |
| Login / cookies / proxies | None needed | often required |
| Failure handling | Fail-open: bounded retries with backoff; unexpected errors end the run SUCCEEDED with an uncharged diagnostic row, so scheduled pipelines never break | hard failures |

### FAQ

**Is it legal to scrape EURES jobs?**
This Actor reads only publicly available job postings — data any visitor can see without logging in. No personal data behind authentication is touched. Review the target site's terms and your local regulations for your specific use case.

**Do I need an account on the target site?**
No. Postings are fetched from public pages/APIs — no login, cookies or session tokens.

**How fresh is the data?**
Every run fetches live listings, filtered server-side by EURES to postings from the last day/week/month via the `publishedWithin` input (default: last week). Within that, results are cached for `cacheTtlSeconds` (default 30 min, set 0 to always hit the source live).

**How many jobs can I get?**
`maxItems` caps the run (default 50, maximum 5000). Results are sorted by keyword-match relevance, not strictly newest-first. For very large pulls, add more `keywords` so the fan-out reaches distinct postings, and raise the run's timeout if needed.

**Can I filter by contract type, hours or education?**
Yes — `contractType`, `workingTime`, `educationLevel` and `experienceLevel` are applied server-side by EURES itself, so filtered runs fetch (and bill) only matching vacancies. Combine them with `keywords`, `locationCodes` and `publishedWithin`.

**Can I fetch only new jobs on a schedule?**
Set `onlyNewSinceLastRun: true`. The Actor remembers vacancy ids across runs in a named key-value store and emits only postings it hasn't seen before — perfect for daily job-alert bots, and you only pay for genuinely new vacancies.

**Does it return salary data?**
The EURES public jv-search API returns **no structured salary field** — verified directly against the live response, which carries no salary/compensation attribute on the vacancy or employer object. Where an employer states pay, it appears only inside the free-text `snippet`/description. This Actor deliberately emits no `salary` field rather than an always-empty or guessed one.

**Is scraping EURES allowed?**
EURES data comes from its public API. Per the portal's terms it is intended for personal / link-back use — review the EURES terms for your use case.

**How reliable are the runs?**
The Actor is built fail-open: transient EURES/API hiccups are retried with backoff, and any unexpected error ends the run **SUCCEEDED** with a single uncharged diagnostic row rather than a hard failure — so scheduled pipelines never break on a blip and you are never billed for a non-result.

**Something broken or missing?**
Open an issue on the Actor's **Issues** tab — it is monitored and reliability fixes ship fast.

**Is this Actor useful to you?**
A quick ⭐ review on the Actor's **Reviews** tab helps other EU job seekers find it — and tells us what to build next.

### Related Actors

- [Europe Jobs Scraper — 14 Sources in One](https://apify.com/nomad-agent/europe-jobs-bundle) — this Actor plus 13 more European job boards in a single run
- [Research & Academic Jobs Scraper — 12 Sources](https://apify.com/nomad-agent/researcher-bundle)
- [InfoJobs Scraper — Ofertas de Trabajo y Empleo España](https://apify.com/nomad-agent/infojobs-scraper) — AI skill tags, structured salary, delta mode
- [Tecnoempleo Scraper — Spain IT & Tech Jobs](https://apify.com/nomad-agent/tecnoempleo-scraper)
- [LinkedIn Jobs Scraper — No Login, No Cookies](https://apify.com/nomad-agent/linkedin-scraper)

***

**From the maker of [Oink](https://github.com/Exdenta/OinkAIJobSearch)** — an open-source, AI-powered job-search bot for Telegram that runs on these Actors. [Try the free bot](https://t.me/job_search_everyday_bot), get a managed instance at [oinkjobsearch.com](https://oinkjobsearch.com), or browse the [full catalog of 50+ Actors](https://apify.com/nomad-agent).

# Actor input Schema

## `keywords` (type: `array`):

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.

## `locationCodes` (type: `array`):

Restrict results to specific EU countries or NUTS regions. Use ISO 3166-1 alpha-2 country codes (e.g. <code>de</code>, <code>es</code>, <code>fr</code>) or NUTS codes. Leave empty to search all EU member states.

## `publishedWithin` (type: `string`):

Only fetch vacancies EURES marks as posted within this time window (filtered server-side by the EURES API itself). <code>Last 7 days</code> matches this Actor's previous fixed behaviour.

## `contractType` (type: `array`):

Keep only vacancies offering at least one of these contract types (filtered server-side by EURES). Leave empty for all contract types.

## `workingTime` (type: `array`):

Keep only vacancies with at least one of these working-time patterns (filtered server-side by EURES). Leave empty for any working time.

## `educationLevel` (type: `array`):

Keep only vacancies requiring at least one of these education levels (filtered server-side by EURES). Leave empty for any education level.

## `experienceLevel` (type: `array`):

Keep only vacancies requiring at least one of these experience bands (filtered server-side by EURES). Leave empty for any experience level.

## `titleExclude` (type: `array`):

Skip listings whose title contains any of these case-insensitive terms.

## `companyExclude` (type: `array`):

Skip listings whose company name contains any of these case-insensitive terms.

## `onlyNewSinceLastRun` (type: `boolean`):

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.

## `maxItems` (type: `integer`):

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.

## `timeoutSeconds` (type: `integer`):

How long to wait for a reply from the EURES API before giving up on that request, in seconds.

## `cacheTtlSeconds` (type: `integer`):

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.

## Actor input object example

```json
{
  "keywords": [
    "software engineer",
    "data analyst",
    "project officer"
  ],
  "locationCodes": [
    "de",
    "fr",
    "es"
  ],
  "publishedWithin": "week",
  "contractType": [],
  "workingTime": [],
  "educationLevel": [],
  "experienceLevel": [],
  "titleExclude": [
    "internship",
    "traineeship"
  ],
  "companyExclude": [],
  "onlyNewSinceLastRun": false,
  "maxItems": 50,
  "timeoutSeconds": 20,
  "cacheTtlSeconds": 1800
}
```

# Actor output Schema

## `dataset` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("nomad-agent/eures-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("nomad-agent/eures-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 '{}' |
apify call nomad-agent/eures-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nomad-agent/eures-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/AJ9Iq8kh5dhNykxpK/builds/Nl1b1qSbCe2he5Evw/openapi.json