SEPE Spain Jobs Scraper: National Employment Service Data with GPS and Occupation Codes

Scrape job listings from empleate.gob.es, Spain's official national public employment portal (SEPE). Get title, company, autonomous community, province, CNO occupation code, GPS coordinates, disability flag, vacancies count, salary, and full description. Covers all 17 comunidades autonomas plus Ceuta and Melilla. HTTP-only, no browser, plain HTTP against the SEPE Solr API. $3.00 per 1,000 jobs.

Open on Apify → Read the tutorial

Pricing

$3.00 / 1,000 SERP; $5.00 / 1,000 with full details

Runtime

Cloud (Apify)

Proxy

Datacenter

Auth

None required

Coverage

All 17 Spanish comunidades autonomas + Ceuta and Melilla

Runtime type

HTTP-only against SEPE Solr API, no browser

What You Get

region / community_code — one of Spain's 19 administrative regions (17 comunidades + Ceuta + Melilla), machine-readable as community_code
province / location — Spanish province and city for sub-regional geo-routing
latitude / longitude — GPS coordinates of the workplace for map-based job search features
cno_code — Spanish National Occupation Classification code (Clasificacion Nacional de Ocupaciones) for sector-level analytics
disability_accessible / vacancies — SEPE disability flag and number of open positions for this listing
employment_type / workplace_type — permanent / fixed-term / commission-contract + on-site / remote normalized from SEPE's own classification
description / description_full / description_html / description_md — four description formats: snippet, plain text, raw HTML, and Markdown
source_origin — identifies whether the listing came from a SEPE partner (TECNO_EMPLEO, InfoJobs, HacesFalta) or directly from a PUP office

Input Example

{
  "searchQueries": ["ingeniero", "programador"],
  "location": "Madrid",
  "maxResultsPerQuery": 100,
  "includeJobDetails": true
}

Output Example

{
  "id": "1857143652",
  "title": "Ingeniero/a de Automatizacion Junior, Valencia",
  "company_name": "Michael Page",
  "location": "Valencia",
  "country": "ES",
  "region": "Comunidad Valenciana",
  "province": "Valencia",
  "community_code": "10",
  "cno_code": "2461",
  "employment_type": "permanent",
  "workplace_type": "on-site",
  "vacancies": 1,
  "disability_accessible": false,
  "latitude": 39.4699075,
  "longitude": -0.3762881,
  "salary_min": null,
  "salary_max": null,
  "salary_currency": null,
  "description": "Ingeniero/a de Automatizacion Junior. Las principales funciones que desarrollaras seran...",
  "source_origin": "TECNO_EMPLEO",
  "apply_url": "https://www.tecnoempleo.com/...",
  "posted_at_datetime": "2026-08-31T10:51:49Z",
  "source_platform": "empleate.gob.es",
  "scraped_at": "2026-08-31T12:00:00Z"
}

Who Should Use This

Spanish HR tech platforms and labour-market research institutions need SEPE data because it is the only job source in Spain that carries CNO occupation codes, GPS workplace coordinates, and disability-accessible flags as structured first-class fields — data that private job boards do not publish. Disability employment services and foundations use the disability_accessible flag and vacancies count to surface verified government-listed inclusive positions across all regions. Regional economic development agencies use community_code and GPS coordinates to build employment heatmaps at province and municipality level. EU/EURES mobility programs benefit from SEPE's unique coverage of public employment office listings that never appear on commercial boards like InfoJobs or Tecnoempleo. Note: SEPE-direct postings often have a null company_name by design; the hiring entity is described in plain text within description.

Integrations

n8n / Make / Zapier — trigger runs and process results via webhook
AI Agents (MCP) — Claude Desktop, Cursor, VS Code, LangChain, LlamaIndex
Python / Node.js — Apify SDK for programmatic access
Google Sheets / Airtable — export via Apify integrations

Run this actor directly on Apify (no code)

Click Open on Apify above to run sepe-es-scraper in your browser - no code, no install. In the Apify console you get:

One-click test - fill in the input form, or paste the JSON example above into the JSON editor tab, then hit Start.
Live output - watch rows stream into an interactive Output table as they arrive, or flip to the raw JSON / Log view.
Export in any format - one click to download the dataset as JSON, CSV, XML, Excel, HTML table, RSS, or JSONL.
Schedules - run this actor daily, weekly, hourly, or on a custom cron. Apify handles timing and stores every dataset run.
Integrations & webhooks - fire a webhook on success/failure, or plug into Zapier, n8n, Make, Airbyte, Google Sheets, Slack, S3, Postgres, and more from the Actions tab.
Transparent cost - see exact usage against your $5/month free tier before you spend a cent.

Get your Apify API token

To run this actor from your own code you need an Apify API token. Get one in about a minute:

Sign up for a free Apify account (Google, GitHub, or email).
Go to Settings → Integrations → API tokens.
Click Create a new API token. Copy it and keep it secret.

Free tier: Apify credits your account with $5 of platform usage every month, no credit card required. Enough to test any actor meaningfully - at $0.001 per result on typical scrapers, that is roughly 5,000 results for free every month.

Call from code

Run this actor from any language via the Apify REST API. Replace YOUR_TOKEN with your API token and adapt the input JSON to your needs.

curl -X POST "https://api.apify.com/v2/acts/santamaria-automations~sepe-es-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

// npm install apify-client
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('santamaria-automations/sepe-es-scraper').call({});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

# pip install apify-client
from apify_client import ApifyClient

client = ApifyClient('YOUR_TOKEN')
run = client.actor('santamaria-automations/sepe-es-scraper').call(run_input={})
items = list(client.dataset(run['defaultDatasetId']).iterate_items())
print(items)

// dotnet add package Apify.Client
using Apify.Client;

var client = new ApifyClient("YOUR_TOKEN");
var run = await client.Actor("santamaria-automations/sepe-es-scraper").CallAsync(new { });
var items = await client.Dataset(run.DefaultDatasetId).ListItemsAsync();

// Maven: com.apify:apify-client
import com.apify.client.ApifyClient;

ApifyClient client = new ApifyClient("YOUR_TOKEN");
ActorRun run = client.actor("santamaria-automations/sepe-es-scraper").call(Map.of());
List<Map<String,Object>> items = client.dataset(run.getDefaultDatasetId()).listItems();

Use with AI agents (MCP)

This actor is available on the Apify MCP server, so you can drive it from any MCP-compatible AI client - Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or a custom agent - without writing any code.

https://mcp.apify.com?tools=santamaria-automations/sepe-es-scraper

Example prompt once connected:

"Use <code>sepe-es-scraper</code> to run a scrape on my target list and give me the results as a table."

Clients that support dynamic tool discovery (Claude.ai, VS Code) receive the full input schema automatically via add-actor.

Use with no-code platforms

Trigger this actor from your favorite automation tool. Every platform below can call the Apify API in a few clicks - no code required.

Add the n8n Apify node (installed by default on n8n Cloud; on self-hosted install @apify/n8n-nodes-apify).
Set Actor to santamaria-automations/sepe-es-scraper.
Choose operation Run Actor and get dataset, paste your input JSON, and connect a downstream node (Google Sheets, Postgres, webhook, ...).

Create a new Zap with any trigger.
Add a Webhooks by Zapier POST action to https://api.apify.com/v2/acts/santamaria-automations~sepe-es-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN.
Body: your input JSON. Content-Type: application/json.

Create a new scenario.
Add an HTTP module: URL https://api.apify.com/v2/acts/santamaria-automations~sepe-es-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN, method POST, body raw JSON.
Parse the response with a JSON module to iterate items downstream.

Create a new workflow.
Add an HTTP Request step: POST to https://api.apify.com/v2/acts/santamaria-automations~sepe-es-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN.
Access steps.http.$return_value in subsequent steps.

Install the API Connector plugin.
Add a new API: POST https://api.apify.com/v2/acts/santamaria-automations~sepe-es-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN, body type JSON.
Initialize the call with your input, then reference the response array in workflow actions.