# Emprego Sapo.Pt Scraper (`unfenced-group/emprego-sapo-pt-scraper`) Actor
Scraper for SAPO Emprego — Portugal's leading job board
- **URL**: https://apify.com/unfenced-group/emprego-sapo-pt-scraper.md
- **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community)
- **Categories:** Jobs, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## 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
## SAPO Emprego Scraper
Extract structured job listings from [SAPO Emprego](https://emprego.sapo.pt), Portugal's largest employment platform with over 20,000 active vacancies. No API key required. Returns up to 50,000 results per run.
### What you get
- **Full job descriptions** from each listing's detail page
- **Company details** — name, logo reference, company profile URL
- **Location data** — country, district, municipality, city
- **Contract & schedule** — Full-Time / Part-Time, work model (on-site / remote / hybrid)
- **Salary data** when publicly listed (currency, min, max)
- **Sector / industry** classification
- **Publication & expiry dates** in ISO 8601 format
- **Repost detection** — skip jobs already seen in previous runs (90-day memory)
### Input parameters
| Parameter | Type | Description |
|---|---|---|
| `keywords` | string | Job title, skill, or company name |
| `location` | string | Portuguese district or city (e.g. `Lisboa`, `Porto`) |
| `category` | string | Category slug (e.g. `informatica`, `comercial`) |
| `workModel` | string | `presencial`, `teletrabalho`, or `hibrido` |
| `workHours` | string | `Full-Time` or `Part-Time` |
| `sortOrder` | string | `mais-recentes` (default), `relevancia`, `mais-antigas` |
| `daysOld` | integer | Max age of listings in days (0 = no limit) |
| `maxResults` | integer | Maximum number of results (default: 100) |
| `fetchDetails` | boolean | Fetch detail pages for full descriptions (default: true) |
| `skipReposts` | boolean | Skip jobs seen in previous runs (default: false) |
| `startUrls` | array | Specific job listing URLs to scrape directly |
### Output schema
Each result contains:
```json
{
"id": "ea7ae155-4cc9-457c-90ad-9473af31a3f7",
"title": "Java Developer",
"pitch": "Hybrid position in Lisbon",
"company": "Dellent",
"companyId": "db6a971e-...",
"companyUrl": "https://emprego.sapo.pt/offers/company/dellent",
"location": "Lisboa",
"district": "Lisboa",
"municipality": "Lisboa",
"country": "Portugal",
"workHours": "Full-Time",
"workModel": "remote",
"description": "Dellent is a consulting company...
",
"descriptionText": "Dellent is a consulting company...",
"descriptionMarkdown": "Dellent is a consulting company...",
"industry": "Informática e Tecnologias",
"educationRequirements": "Bachelor's degree",
"experienceRequirements": "6+ years",
"salaryMin": null,
"salaryMax": null,
"salaryCurrency": "EUR",
"publishDate": "2026-04-02",
"publishDateISO": "2026-04-02T00:00:00.000Z",
"expiresDate": "2026-05-02",
"applyUrl": null,
"url": "https://emprego.sapo.pt/offers/java-developer?id=ea7ae155-...",
"isHighlighted": false,
"hasVideo": false,
"canonical": "java-developer",
"source": "emprego.sapo.pt",
"scrapedAt": "2026-04-05T07:44:00.000Z",
"contentHash": "a3f7b2..."
}
````
### Pricing
**$1.50 per 1,000 results** — usage-based, no subscription needed.
| Volume | Cost |
|---|---|
| 1,000 results | $1.50 |
| 10,000 results | $15.00 |
| 50,000 results | $75.00 |
| Flat-rate competitor | ~$49–99/month |
### Performance
| Scenario | Results | Duration |
|---|---|---|
| Keyword search, no details | 1,000 | ~2 min |
| Keyword search, with details | 1,000 | ~8 min |
| Full market crawl | 20,000+ | ~90 min |
### Known limitations
- Salary data is only available when the employer publicly discloses it (roughly 20–30% of listings)
- Some jobs redirect to external company career pages — these are flagged with `applyUrl` set
- The platform uses a fixed page size of 9 results per API call; large crawls require many requests
- **Highlighted/promoted listings bypass location, work model, and contract filters** — these always appear at the top of results regardless of search parameters; this is platform behaviour
- **`workModel` is only reliably populated when `fetchDetails: true`** — without detail pages, detection falls back to keyword scanning of the job title
### Technical details
- Scrapes the public JSON search API and individual job detail pages
- Cross-run deduplication with 90-day TTL prevents duplicate entries in incremental workflows
- Built-in retry logic with exponential backoff and rate-limit handling
- Storm-abort circuit breaker halts runs if persistent blocking is detected
### Additional services
Need custom data, scheduled exports, or integration support? Contact us at **info@unfencedgroup.nl** — we offer tailored scraping solutions for recruitment platforms across Europe.
***
*Built and maintained by [unfenced-group](https://apify.com/unfenced-group) · Part of the European Job Board Scraper Portfolio*
# Actor input Schema
## `keywords` (type: `string`):
Job title, company name, or keyword to search for.
## `location` (type: `string`):
Portuguese district or city name (e.g. Lisboa, Porto, Braga).
## `category` (type: `string`):
Job category slug (e.g. informatica, comercial, administrativo). See SAPO Emprego categories.
## `workModel` (type: `string`):
Filter by work model.
## `workHours` (type: `string`):
Filter by work hours type.
## `sortOrder` (type: `string`):
Order in which to return results.
## `daysOld` (type: `integer`):
Only return jobs published within the last N days. 0 = no limit.
## `maxResults` (type: `integer`):
Maximum number of job listings to return.
## `fetchDetails` (type: `boolean`):
Fetch individual job detail pages to retrieve full descriptions, salary, and additional fields. Recommended. Disable to scrape listing data only (faster, less data).
## `skipReposts` (type: `boolean`):
Skip jobs seen in a previous run (within 90 days). Useful for incremental updates.
## `startUrls` (type: `array`):
List of specific SAPO Emprego job detail URLs to scrape directly. Overrides search parameters when provided.
## Actor input object example
```json
{
"keywords": "",
"location": "",
"category": "",
"workModel": "",
"workHours": "",
"sortOrder": "mais-recentes",
"maxResults": 100,
"fetchDetails": true,
"skipReposts": false,
"startUrls": []
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {};
// Run the Actor and wait for it to finish
const run = await client.actor("unfenced-group/emprego-sapo-pt-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 = {}
# Run the Actor and wait for it to finish
run = client.actor("unfenced-group/emprego-sapo-pt-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 unfenced-group/emprego-sapo-pt-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=unfenced-group/emprego-sapo-pt-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Emprego Sapo.Pt Scraper",
"description": "Scraper for SAPO Emprego — Portugal's leading job board",
"version": "0.0",
"x-build-id": "tPB9Zs0YgKTlZewJy"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/unfenced-group~emprego-sapo-pt-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-unfenced-group-emprego-sapo-pt-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/unfenced-group~emprego-sapo-pt-scraper/runs": {
"post": {
"operationId": "runs-sync-unfenced-group-emprego-sapo-pt-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/unfenced-group~emprego-sapo-pt-scraper/run-sync": {
"post": {
"operationId": "run-sync-unfenced-group-emprego-sapo-pt-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": {
"keywords": {
"title": "Keywords",
"type": "string",
"description": "Job title, company name, or keyword to search for.",
"default": ""
},
"location": {
"title": "Location / District",
"type": "string",
"description": "Portuguese district or city name (e.g. Lisboa, Porto, Braga).",
"default": ""
},
"category": {
"title": "Category",
"type": "string",
"description": "Job category slug (e.g. informatica, comercial, administrativo). See SAPO Emprego categories.",
"default": ""
},
"workModel": {
"title": "Work Model",
"enum": [
"",
"presencial",
"teletrabalho",
"hibrido"
],
"type": "string",
"description": "Filter by work model.",
"default": ""
},
"workHours": {
"title": "Work Hours",
"enum": [
"",
"Full-Time",
"Part-Time"
],
"type": "string",
"description": "Filter by work hours type.",
"default": ""
},
"sortOrder": {
"title": "Sort Order",
"enum": [
"mais-recentes",
"mais-antigas",
"relevancia",
"nome-a-z",
"nome-z-a"
],
"type": "string",
"description": "Order in which to return results.",
"default": "mais-recentes"
},
"daysOld": {
"title": "Maximum Age (days)",
"minimum": 0,
"maximum": 365,
"type": "integer",
"description": "Only return jobs published within the last N days. 0 = no limit."
},
"maxResults": {
"title": "Maximum Results",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Maximum number of job listings to return.",
"default": 100
},
"fetchDetails": {
"title": "Fetch Detail Pages",
"type": "boolean",
"description": "Fetch individual job detail pages to retrieve full descriptions, salary, and additional fields. Recommended. Disable to scrape listing data only (faster, less data).",
"default": true
},
"skipReposts": {
"title": "Skip Already-Scraped Jobs",
"type": "boolean",
"description": "Skip jobs seen in a previous run (within 90 days). Useful for incremental updates.",
"default": false
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "List of specific SAPO Emprego job detail URLs to scrape directly. Overrides search parameters when provided.",
"default": [],
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```