# Portugal Jobs Feed Empregos: Net-Empregos, SAPO, IEFP, ITJobs (`getascraper/portugal-jobs-feed`) Actor

Nine Portuguese job boards (vagas de emprego) in one run: Net-Empregos, Emprego SAPO, IEFP, ITJobs.pt, Eurofirms, Ofertas de Emprego, Expresso Emprego, Alerta Emprego, Landing.jobs. One job format with districts, EUR pay and 14-salary yearly figure, duplicate groups, new, updated or closed jobs.

- **URL**: https://apify.com/getascraper/portugal-jobs-feed.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 93.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.70 / 1,000 job postings

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

## 🇵🇹 Portugal Jobs Feed Empregos: Net-Empregos, SAPO, IEFP, ITJobs

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-bottom:0">
<tr>
<td style="padding:24px 28px;background:#EEF6F1;color:#1C1917;border:1px solid #C3DECF;border-top:4px solid #046A38;border-radius:10px 10px 0 0">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Search Portugal's job boards in one run and get every job in one clean format</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Pull jobs from Net-Empregos, Emprego SAPO, IEFP, ITJobs.pt and five more Portuguese boards with pay in euros as published, gross or net when the ad says so, and every job placed in its district and municipality.</span>
</td>
</tr>
</table>
<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-top:0">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;color:#1C1917;border:1px solid #C3DECF;border-top:none;border-radius:0 0 0 10px;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#034D29">💶 Pay you can compare</span><br><span style="font-size:12px;color:#57534E">Monthly pay as published, plus the yearly figure on Portugal's 14-salary year.</span></td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;color:#1C1917;border:1px solid #C3DECF;border-top:none;border-left:none;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#034D29">📍 Every district</span><br><span style="font-size:12px;color:#57534E">18 districts, Açores and Madeira in Portuguese and English. Setubal finds Setúbal.</span></td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;color:#1C1917;border:1px solid #C3DECF;border-top:none;border-left:none;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#034D29">🧬 Same job, one group</span><br><span style="font-size:12px;color:#57534E">A job posted on two boards shares one group id, or collapses to one row.</span></td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;color:#1C1917;border:1px solid #C3DECF;border-top:none;border-left:none;border-radius:0 0 10px 0;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#034D29">🔔 What changed</span><br><span style="font-size:12px;color:#57534E">New, updated and closed jobs between scheduled runs.</span></td>
</tr>
</table>

Recruiters, staffing agencies and job-market analysts who follow hiring in Portugal usually open one board at a time and then match up pay, places and titles by hand. This feed reads the ofertas de emprego and vagas de emprego of up to nine boards in a single run, from Net-Empregos and Emprego SAPO to the public IEFP service and ITJobs.pt. It applies the same filters to all of them and returns one table you can sort, export or schedule. Todas as vagas num só sítio, no mesmo formato.

### 🔎 What does Portugal Jobs Feed do?

You give it keywords, districts and filters. It searches every board you select, turns what each one publishes into the same fields, and marks which rows are new since your last run. Portuguese and English keywords both work, with or without accents. Nothing is guessed: if a board does not publish a value, the field is left out.

| Board | Strongest for | Good to know |
| --- | --- | --- |
| Net-Empregos | The largest general board: every sector and every district, many small employers | Pay, experience, education and languages are read from the ad text when you ask for full details, and only when the ad states them. The site has no search by municipality, so a municipality search keeps the district's jobs whose title names that place. |
| Eurofirms Portugal | Offers from a recruitment and temporary-work agency, with vacancies, applicant counts and schedules | The client company is not published, so rows name the client's sector instead of a company. Most offers say the salary is still to be defined. The site has no Vila Real area, so a Vila Real search skips this board and says so. |
| Ofertas de Emprego | Office, retail, hospitality and tech jobs with work model, languages and experience level | The salary label is rounded and does not say whether it is monthly or yearly, so it is kept as published and never converted. Exact posting dates come with full details or for the newest jobs. |
| Emprego SAPO | A large general board with employers in every district | Pay, experience and languages come from the ad text when the ad states them. Some employers post anonymously, so those rows have no company. The site limits how many searches one run can make, so a large run can stop early here and keeps the rows already found. |
| IEFP | Offers from the public employment service, many in hospitality, retail, industry and care | Gross monthly pay on most offers when full details are on. IEFP publishes no employer name and no posting date, so those fields stay empty and the posted-within filter keeps no IEFP rows. |
| ITJobs.pt | IT and software jobs | A yearly salary on a few offers, kept yearly. Every job is an IT job: an IT category such as Informática reads the whole board, and any other category skips it with a message. Districts the board does not list are skipped the same way. |
| Expresso Emprego (opt-in) | A general board with many company postings | Jobs abroad are left out unless you add them in the board options. There is no remote search on this board, so a Remote search skips it. |
| Alerta Emprego (opt-in) | An aggregator that collects offers from other boards | The same job often also comes from another board: those rows share one group id, and "One row per job across boards" keeps one of them. Posting dates need full details. |
| Landing.jobs (opt-in) | A small tech board, often with a yearly gross salary range | Jobs whose offices are all outside Portugal are left out unless you add them in the board options. |

Six boards are selected by default. Expresso Emprego, Alerta Emprego and Landing.jobs are opt-in: add them under Job boards when you need them.

### 🎯 Who uses it

- **I am a recruiter** in Lisboa and Porto and want every new opening from six boards in one table each morning.
- **I run a staffing agency** and track which roles are being advertised, with vacancies and applicant counts where the board shows them.
- **I am a pay analyst** comparing published monthly pay by district, including the gross pay IEFP prints on its offers.
- **I hire developers** and follow ITJobs.pt and Landing.jobs next to the general boards, with skills and yearly pay where published.
- **I build a job site** and need a clean Portugal feed where one posting never shows up twice, even from an aggregator.

### 🚀 How it works

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:16px 14px;width:33%;background:#EEF6F1;color:#1C1917;border:1px solid #C3DECF;border-radius:10px 0 0 10px;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#046A38;letter-spacing:1px">STEP 1</span><br><span style="font-size:14px;font-weight:700;color:#1C1917">Pick boards and a search</span><br><span style="font-size:12px;color:#57534E">Choose boards, keywords, districts and filters, or paste a board link.</span></td>
<td style="padding:16px 14px;width:33%;background:#EEF6F1;color:#1C1917;border:1px solid #C3DECF;border-left:none;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#046A38;letter-spacing:1px">STEP 2</span><br><span style="font-size:14px;font-weight:700;color:#1C1917">Get one table</span><br><span style="font-size:12px;color:#57534E">Every row has the same fields, whichever board it came from.</span></td>
<td style="padding:16px 14px;width:33%;background:#EEF6F1;color:#1C1917;border:1px solid #C3DECF;border-left:none;border-radius:0 10px 10px 0;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#046A38;letter-spacing:1px">STEP 3</span><br><span style="font-size:14px;font-weight:700;color:#1C1917">Schedule it</span><br><span style="font-size:12px;color:#57534E">Give the search a monitor name and each run flags new, updated and closed jobs.</span></td>
</tr>
</table>

The default run reads the newest jobs in Lisboa from the six default boards, 25 rows in total, and usually finishes in under 10 seconds.

### 💶 How pay is handled

- Pay is kept exactly as the ad prints it, in `salaryRaw`, next to the numbers read from it.
- A period (monthly, yearly, hourly) is set only when the ad says so. "1.000€ - 1.200€ bruto/mensal" is monthly; "€17k - €17k" has no period and stays that way.
- Monthly pay also gets a yearly figure on the Portuguese 14-salary year (12 months plus the holiday and Christmas subsidies). Rows with a calculated yearly figure say so with `salaryDerived` and `salaryMonthsPerYear: 14`.
- A yearly figure is kept as published and is never split into a monthly one, because the ad does not say whether it already counts 12 or 14 payments.
- Gross or net is set only when the ad says bruto, ilíquido (both gross) or líquido (net).
- "Salário a definir", "a combinar" and "competitivo" are not turned into numbers. Those rows show `salaryDisclosed: false`.

The monthly salary filter compares monthly pay directly and divides a yearly figure by 14 for the comparison only. Pay printed without a period cannot be compared, so it is kept unless you also tick "Only jobs with a published salary". About 95% of Portuguese ads hide pay, so expect few rows when you filter on it.

### ⌨️ Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `sources` | array of enum | No | Boards to read: `net-empregos`, `emprego-sapo`, `eurofirms`, `ofertas-de-emprego`, `iefp`, `itjobs-pt` (default), plus the opt-in `expresso-emprego`, `alerta-emprego`, `landing-jobs`. |
| `startUrls` | array of URLs | No | Search or job links copied from a supported board. Empty the board list to read only these links. The run's filters, including employment types, also apply to these rows. |
| `keywords` | array of strings | No | Titles or skills, for example enfermeiro, programador or motorista. Leave empty to browse the newest jobs. |
| `expandKeywords` | boolean | No | Also search Portuguese titles for common English ones (nurse also searches enfermeiro). |
| `districts` | array of strings | No | Districts (Lisboa, Porto, Setúbal ...), Açores, Madeira, municipalities (Matosinhos, Oeiras, Funchal), Remote, or Portugal for the whole country. Default Lisboa. |
| `categories` | array of strings | No | Job areas such as Informática, Hotelaria or Saúde, matched to each board's own categories. |
| `employmentTypes` | array of enum | No | Full-time, part-time, internship, temporary, freelance, fixed-term or permanent. |
| `remoteOnly` | boolean | No | Keep only remote or hybrid jobs. |
| `experience` | enum | No | Experience band the job must overlap. |
| `education` | enum | No | Minimum education the job asks for, from 9th grade to doctorate. |
| `minMonthlySalaryEur` | integer | No | Minimum monthly pay in euros (yearly pay divided by 14 for the check). |
| `maxMonthlySalaryEur` | integer | No | Maximum monthly pay in euros. |
| `onlyDisclosedSalary` | boolean | No | Drop jobs with no published pay. |
| `postedWithinDays` | integer | No | Keep jobs posted within this many days. |
| `companyNames` | array of strings | No | Keep only these employers. Lda, S.A. and accents do not matter. |
| `excludeKeywords` | array of strings | No | Drop jobs that mention any of these words. |
| `includeDescription` | boolean | No | Add the description and the job-page facts: requirements, education, languages, vacancies, applicants, schedule. |
| `includeCompanyProfile` | boolean | No | Add the employer profile where the board has one (Ofertas de Emprego). |
| `includeSourceFields` | boolean | No | Attach the untouched board record. |
| `extractContacts` | boolean | No | Pull emails and Portuguese phone numbers printed in the job text into `extractedEmails` and `extractedPhones`. Works best with the full description on. |
| `convertToUsd` | boolean | No | Add monthly and yearly pay in US dollars. |
| `monitorScope` | string | No | Name a search to track it over time (NEW, UPDATED, UNCHANGED, REOPENED, CLOSED). |
| `outputMode` | enum | No | All rows, only new and changed rows, or compact rows. |
| `uniqueOnly` | boolean | No | Keep one row per job when it is listed on several boards. |
| `includeClosed` | boolean | No | Report jobs that disappeared on two complete scans. |
| `maxTotalRows` | integer | No | Most rows for the whole run (default 25), shared fairly between boards. |
| `maxItemsPerSource` | integer | No | Most rows from one board (default 25). |
| `maxPagesPerSource` | integer | No | Most result pages per search (default 5). |
| `proxyConfiguration` | object | No | Optional proxy for every board. Most runs never need it. |
| `boardOptions` | object | No | Settings only one board has, for example Eurofirms offer type, Net-Empregos category ids, or jobs abroad on Expresso Emprego and Landing.jobs. |

### 📦 Output

Every row has the same shape, whichever board it came from. A real row from a run:

```json
{
  "listingKey": "eurofirms:089-009420",
  "sourcePlatform": "eurofirms",
  "sourceRecordId": "089-009420",
  "title": "Bate-Chapas (M/F) - Almada",
  "companyIndustry": "Automóvel",
  "postedByType": "agency",
  "locationRaw": "Sintra, Lisboa",
  "district": "Lisboa",
  "districtEn": "Lisbon",
  "districtCode": "PT-11",
  "city": "Sintra",
  "country": "PT",
  "salaryRaw": "de 1.000€ - 1.200€ Bruto/mensal",
  "salaryCurrency": "EUR",
  "salaryGrossOrNet": "gross",
  "salaryPeriod": "month",
  "salaryMonthlyMinEur": 1000,
  "salaryMonthlyMaxEur": 1200,
  "salaryAnnualMinEur": 14000,
  "salaryAnnualMaxEur": 16800,
  "salaryDerived": true,
  "salaryMonthsPerYear": 14,
  "educationEn": "Basic education (9th grade)",
  "languages": ["Portuguese"],
  "employmentTypeEn": "Full-time",
  "jobCategory": "Bate-chapas",
  "openings": 1,
  "weeklyHours": 40,
  "postedAt": "2026-10-26T00:00:00.000Z",
  "expiresAt": "2026-11-10T00:00:00.000Z",
  "listingUrl": "https://jobs.eurofirms.com/pt/pt/sintra/bate-chapas---almada-089-009420",
  "signals": { "applicants": 7 },
  "lifecycleStatus": "NEW",
  "platformData": { "reference": "089-009420", "directHire": true, "clientSector": "Automóvel" }
}
```

The Output tab has four views: 💼 Jobs, 💶 Pay, 🎓 Requirements and 🔔 Changes. Every run also saves a run summary and a per-board health report in the run's storage.

### 🗂️ Data table

| Field | Type | Description |
| --- | --- | --- |
| `title`, `company` | string | Job title and employer as published. Agency rows have no company and set `postedByType` to agency. |
| `sourcePlatform`, `sourceRecordId`, `listingUrl` | string | Board, the board's own job id, and the job page. |
| `district`, `districtEn`, `districtCode`, `city` | string | District in Portuguese and English, its official code (PT-11 for Lisboa), and the municipality or town. |
| `country`, `isAbroad` | string, boolean | PT for jobs in Portugal; another code for jobs abroad listed on Portuguese boards. |
| `workModel`, `isRemote` | string, boolean | Remote, hybrid or on-site, only when the board or ad says so. |
| `salaryRaw` | string | Pay exactly as published. |
| `salaryMin`, `salaryMax`, `salaryPeriod` | number, string | Published figures and their period (month, year, hour), only from an explicit word. |
| `salaryGrossOrNet` | string | Gross or net, only when stated. |
| `salaryMonthlyMinEur`, `salaryMonthlyMaxEur` | number | Monthly pay from a monthly figure. |
| `salaryAnnualMinEur`, `salaryAnnualMaxEur` | number | Yearly pay as published, or monthly pay x14. |
| `salaryDerived`, `salaryMonthsPerYear` | boolean, integer | Marks yearly figures calculated from monthly pay (14 payments). |
| `employmentType`, `employmentTypeEn`, `employmentCategories` | string, array | Contract type as published, in English, and as filter values. |
| `experienceRaw`, `experienceMinYears`, `experienceMaxYears` | string, number | Experience asked for. |
| `educationRaw`, `educationEn`, `educationRank` | string, integer | Education asked for (0 none to 6 doctorate). |
| `languages`, `languagesRaw` | array | Languages asked for, in English and as published. |
| `jobCategory`, `companyIndustry` | string | Category or job function, and the sector. |
| `openings`, `weeklyHours`, `workHours`, `signals` | integer, number, string, object | Vacancies, weekly hours, schedule text and applicant counts. |
| `description`, `requirementsText`, `skills`, `benefits` | string, array | Full text and tags (description with full details). |
| `extractedEmails`, `extractedPhones` | array | Contact emails and Portuguese phone numbers found in the job text, only when `extractContacts` is on and the ad publishes them. |
| `postedAt`, `expiresAt` | string | Posting and closing dates. |
| `clusterId`, `clusterSize`, `isCanonical` | string, integer, boolean | Group id shared by the same job on several boards. |
| `lifecycleStatus`, `changedFields`, `firstSeenAt`, `lastSeenAt`, `closedAt` | string, array | Change tracking for named monitors. |
| `platformData` | object | Every other value the board publishes, under its own name. |

### 💰 Pricing

This Actor uses pay per event: you pay for the job rows delivered, and a run that finds nothing costs nothing. There is no subscription. A small default run of 25 rows is a good way to check a search before scheduling it.

Free plan runs are limited to 25 rows per run, 3 runs per day and a 30-minute wait between runs. Paid plans have no such limits.

### ⭐ Enjoying Portugal Jobs Feed?

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:20px 24px 14px;background:#EEF6F1;color:#1C1917;border:1px solid #C3DECF;border-left:5px solid #046A38;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">Did one run replace a morning of board searches for you?</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other recruiters and job-market analysts find it. Your feedback also tells us which board to add next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#046A38;color:#FFFFFF;border:1px solid #046A38;border-left:5px solid #046A38;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/portugal-jobs-feed/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### 💡 Tips

- Start with the default 25 rows, check the result, then raise `maxTotalRows` and `maxItemsPerSource`.
- For a daily feed, set a monitor name and choose "Only new and changed rows". Keep the same settings on every scheduled run.
- Full details add job-page facts but read one extra page per job, so runs take longer. Leave them off for a quick scan.
- Pay, experience and education filters need the job page on several boards, so they make those boards slower.
- Pasted links follow the run's filters too: clear the employment types if a pasted search returns fewer rows than expected.

### ❓ FAQ

**Como obter as ofertas de emprego do Net-Empregos, Emprego SAPO, IEFP e ITJobs de uma só vez?**
Keep the default boards selected, add keywords and districts, and run. All jobs come back in one table with the same fields. Add Expresso Emprego, Alerta Emprego or Landing.jobs under Job boards when you want them too.

**Why do IEFP rows have no company or posting date?**
IEFP publishes its offers without the employer's name and without a publication date. The feed leaves those fields empty instead of guessing, so the posted-within filter keeps no IEFP rows.

**Does it need a login or an account on the job boards?**
No. It reads public job listings only. No login, password or account is used.

**Why do so few rows have a salary?**
Most Portuguese ads do not publish pay, or say it is to be defined. The feed never invents a figure: rows without pay simply have no salary fields.

**Why is the yearly salary 14 times the monthly one?**
Employees in Portugal receive 14 payments a year: 12 monthly salaries plus the holiday and Christmas subsidies. Rows with a calculated yearly figure are marked, and a yearly figure the ad publishes is never changed.

**Quais distritos são suportados?**
All 18 districts plus Açores and Madeira, in Portuguese or English, with or without accents, and the main municipalities such as Matosinhos, Oeiras, Almada or Funchal.

**I already use one of the single-board scrapers. Can I keep my monitor?**
The saved history of the single-board scrapers does not carry over, so the first feed run with a monitor name reports every job as NEW. The Net-Empregos market snapshot (open-offer counts per district and category) stays in the Net-Empregos Portugal Jobs Scraper.

### 🔗 Other actors

- [Net-Empregos Portugal Jobs Scraper](https://apify.com/getascraper/net-empregos-jobs-scraper) ↗ - Net-Empregos offers with a new-offers feed and a market snapshot of open jobs.
- [Eurofirms Portugal Jobs Scraper](https://apify.com/getascraper/eurofirms-portugal-jobs-scraper) ↗ - Eurofirms offers by function, district and town, with a change feed.
- [Ofertas de Emprego Jobs Scraper](https://apify.com/getascraper/ofertas-de-emprego-jobs-scraper) ↗ - Ofertas de Emprego jobs with area, contract, work model and language filters.
- [Japan Jobs Feed](https://apify.com/getascraper/japan-jobs-feed) ↗ - the same one-feed format for Japanese job boards.
- [Israel Jobs Feed](https://apify.com/getascraper/israel-jobs-feed) ↗ - the same one-feed format for Israeli job boards.

# Changelog

This Actor's version history is a separate document: https://apify.com/getascraper/portugal-jobs-feed/changelog.md

# Actor input Schema

## `sources` (type: `array`):

Which Portuguese job boards to read. Each board is searched with the same keywords, districts and filters, and every row says which board it came from. Six boards are on by default: Net-Empregos and Emprego SAPO (the large general boards), Eurofirms Portugal (agency offers with vacancies and applicant counts), Ofertas de Emprego (work model, languages and experience level), IEFP (the public employment service: gross monthly pay on most offers with full details, but no posting date and no employer name) and ITJobs.pt (IT jobs only). Expresso Emprego, Alerta Emprego (an aggregator of other boards, so expect duplicates) and Landing.jobs (a small tech board) are opt-in: add them when you need them.

## `startUrls` (type: `array`):

Optional links copied from a supported board: a search results page or a single job page on any of the nine boards. The board is detected from each link. Empty the Job boards list to read only the pasted links. The run's filters, including employment types, also apply to rows from pasted links. A link that belongs to no supported board is reported and skipped.

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

Job titles or skills to search, in Portuguese or English, for example enfermeiro, programador or motorista. Accents are optional: tecnico finds técnico. Every keyword is searched in every district. Leave empty to browse the newest jobs.

## `expandKeywords` (type: `boolean`):

Also search a short built-in list of Portuguese titles for common English ones (for example nurse also searches enfermeiro, driver also searches motorista). Finds more jobs and uses more requests.

## `districts` (type: `array`):

Any of the 18 districts plus Açores and Madeira (Lisboa, Porto, Braga, Setúbal, Faro ...), or a municipality such as Matosinhos, Oeiras or Funchal. Enter Remote for remote jobs, or Portugal (or leave the list empty) to search the whole country. An unknown place is reported with suggestions and never turned into a whole-country search.

## `categories` (type: `array`):

Optional job areas in Portuguese, for example Informática, Hotelaria, Saúde, Logística or Construção. Each board maps the word onto its own category list, and a board with no matching category says so instead of returning unrelated jobs. ITJobs.pt lists IT jobs only: an IT category such as Informática reads the whole board, any other category skips it.

## `employmentTypes` (type: `array`):

Keep only these kinds of employment. Leave empty for all. Jobs whose type is not stated are dropped when a type is chosen.

## `remoteOnly` (type: `boolean`):

Keep only jobs the board describes as remote (remoto, teletrabalho) or hybrid (híbrido). Jobs that do not say are dropped.

## `experience` (type: `string`):

Keep jobs whose required experience overlaps this band. Jobs that do not state experience are dropped when a band is chosen.

## `education` (type: `string`):

Keep jobs that ask for at least this level. Jobs that do not state an education level are dropped when a level is chosen.

## `minMonthlySalaryEur` (type: `integer`):

Keep jobs whose published monthly pay reaches at least this amount. A yearly figure is divided by 14 for this check only (Portugal pays 14 salaries a year). A figure the board prints without saying monthly or yearly cannot be compared and is kept, unless you also tick Only jobs with a published salary. Jobs with no published pay are dropped.

## `maxMonthlySalaryEur` (type: `integer`):

Keep jobs whose published monthly pay starts at or below this amount. Yearly figures are divided by 14 for this check only.

## `onlyDisclosedSalary` (type: `boolean`):

Drop jobs whose pay is to be defined (a definir), negotiable or missing. Together with a salary limit, it also drops figures that cannot be compared monthly.

## `postedWithinDays` (type: `integer`):

Keep jobs posted within this many days (1 keeps today's postings). Jobs that carry no date cannot be checked and are dropped when this is set.

## `companyNames` (type: `array`):

Keep only jobs from companies whose name contains one of these words. Accents and legal forms such as Lda or S.A. do not matter.

## `excludeKeywords` (type: `array`):

Drop jobs whose title, company, category, tags or posting text contain any of these words, for example estágio or call center.

## `includeDescription` (type: `boolean`):

Add the job description and read each job page for the facts only it shows: requirements, education, languages, vacancies, applicant counts, schedule and the exact posting date. Runs are slower and rows are larger.

## `includeCompanyProfile` (type: `boolean`):

Add the employer's profile where the board publishes one (Ofertas de Emprego: about text, website, address, number of open jobs).

## `includeSourceFields` (type: `boolean`):

Attach the untouched record read from the board under provenance, for audits and fields not mapped to the common format.

## `extractContacts` (type: `boolean`):

Pull any email addresses and Portuguese phone numbers printed in the job text into extractedEmails and extractedPhones. Reads only text already fetched, so turn on Include full description for the best results. Nothing is guessed: a job with no published contact gets no field.

## `convertToUsd` (type: `boolean`):

Add monthly and annual pay in US dollars using the current exchange rate. If the rate cannot be loaded the USD fields are left out.

## `monitorScope` (type: `string`):

Give a name to track this search over time. Each run marks every row NEW, UPDATED, UNCHANGED or REOPENED, and a job that stays gone on two complete scans is reported CLOSED. Use the same name and settings on every scheduled run. Leave empty for a one-off run.

## `outputMode` (type: `string`):

All rows with every field, only rows that are new or changed since the last run, or a short compact row for feeds. Compact rows keep one row per job.

## `uniqueOnly` (type: `boolean`):

When the same job is listed on several boards, keep only the richest copy. Every row carries a cluster id either way, so you can also group them yourself.

## `includeClosed` (type: `boolean`):

When monitoring, add a short CLOSED row for each job that disappeared on two complete scans. Closed rows count as delivered rows.

## `maxTotalRows` (type: `integer`):

Hard limit on rows delivered by the whole run. It is shared fairly between the boards, and a board that finds less hands its share to the others.

## `maxItemsPerSource` (type: `integer`):

Most jobs read from one board in this run (split across your keyword, district and category combinations).

## `maxPagesPerSource` (type: `integer`):

Most result pages read for each keyword, district and category on a board. A search that stops here is not treated as complete, so it cannot report closed jobs.

## `proxyConfiguration` (type: `object`):

Optional. By default each board starts on the cheapest connection that works for it and moves to a proxy only if it is refused. A proxy chosen here is used for every board instead.

## `boardOptions` (type: `object`):

Optional per-board settings as JSON, keyed by board id, for filters only one board has. Examples: {"net-empregos": {"categoryIds": \["5"], "jobTypes": \["3"]}}, {"eurofirms": {"offerType": "selection", "noExperience": true}}, {"emprego-sapo": {"qualification": "licenciatura"}}, {"expresso-emprego": {"abroad": "include"}} (adds jobs abroad), {"landing-jobs": {"includeAbroad": true}} (adds jobs with offices outside Portugal only), {"ofertas-de-emprego": {"includeHtml": true}}. Unknown keys are ignored.

## Actor input object example

```json
{
  "sources": [
    "net-empregos",
    "eurofirms",
    "ofertas-de-emprego",
    "emprego-sapo",
    "iefp",
    "itjobs-pt"
  ],
  "keywords": [],
  "expandKeywords": false,
  "districts": [
    "Lisboa"
  ],
  "categories": [],
  "employmentTypes": [],
  "remoteOnly": false,
  "experience": "any",
  "education": "any",
  "onlyDisclosedSalary": false,
  "companyNames": [],
  "excludeKeywords": [],
  "includeDescription": false,
  "includeCompanyProfile": false,
  "includeSourceFields": false,
  "extractContacts": false,
  "convertToUsd": false,
  "monitorScope": "",
  "outputMode": "all",
  "uniqueOnly": false,
  "includeClosed": true,
  "maxTotalRows": 25,
  "maxItemsPerSource": 25,
  "maxPagesPerSource": 5,
  "boardOptions": {}
}
```

# Actor output Schema

## `jobs` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `health` (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 = {
    "sources": [
        "net-empregos",
        "eurofirms",
        "ofertas-de-emprego",
        "emprego-sapo",
        "iefp",
        "itjobs-pt"
    ],
    "keywords": [],
    "expandKeywords": false,
    "districts": [
        "Lisboa"
    ],
    "categories": [],
    "employmentTypes": [],
    "remoteOnly": false,
    "experience": "any",
    "education": "any",
    "onlyDisclosedSalary": false,
    "companyNames": [],
    "excludeKeywords": [],
    "includeDescription": false,
    "includeCompanyProfile": false,
    "includeSourceFields": false,
    "extractContacts": false,
    "convertToUsd": false,
    "monitorScope": "",
    "outputMode": "all",
    "uniqueOnly": false,
    "includeClosed": true,
    "maxTotalRows": 25,
    "maxItemsPerSource": 25,
    "maxPagesPerSource": 5,
    "boardOptions": {}
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/portugal-jobs-feed").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 = {
    "sources": [
        "net-empregos",
        "eurofirms",
        "ofertas-de-emprego",
        "emprego-sapo",
        "iefp",
        "itjobs-pt",
    ],
    "keywords": [],
    "expandKeywords": False,
    "districts": ["Lisboa"],
    "categories": [],
    "employmentTypes": [],
    "remoteOnly": False,
    "experience": "any",
    "education": "any",
    "onlyDisclosedSalary": False,
    "companyNames": [],
    "excludeKeywords": [],
    "includeDescription": False,
    "includeCompanyProfile": False,
    "includeSourceFields": False,
    "extractContacts": False,
    "convertToUsd": False,
    "monitorScope": "",
    "outputMode": "all",
    "uniqueOnly": False,
    "includeClosed": True,
    "maxTotalRows": 25,
    "maxItemsPerSource": 25,
    "maxPagesPerSource": 5,
    "boardOptions": {},
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/portugal-jobs-feed").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 '{
  "sources": [
    "net-empregos",
    "eurofirms",
    "ofertas-de-emprego",
    "emprego-sapo",
    "iefp",
    "itjobs-pt"
  ],
  "keywords": [],
  "expandKeywords": false,
  "districts": [
    "Lisboa"
  ],
  "categories": [],
  "employmentTypes": [],
  "remoteOnly": false,
  "experience": "any",
  "education": "any",
  "onlyDisclosedSalary": false,
  "companyNames": [],
  "excludeKeywords": [],
  "includeDescription": false,
  "includeCompanyProfile": false,
  "includeSourceFields": false,
  "extractContacts": false,
  "convertToUsd": false,
  "monitorScope": "",
  "outputMode": "all",
  "uniqueOnly": false,
  "includeClosed": true,
  "maxTotalRows": 25,
  "maxItemsPerSource": 25,
  "maxPagesPerSource": 5,
  "boardOptions": {}
}' |
apify call getascraper/portugal-jobs-feed --silent --output-dataset

```

## MCP server setup

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

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/lHsB4NW0b8eBiCrXq/builds/DpEvqqA3oWxwdEb17/openapi.json
