# ITJobs Scraper: IT Jobs in Portugal (`santamaria-automations/itjobs-pt-jobs-scraper`) Actor

Scrape IT job ads from ITJobs.pt, the Portuguese tech job board: title, company, locations, remote or hybrid, salary range, posting date and, on request, the full text, contract and tags. Pay-per-result.

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

## Pricing

Pay per event

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/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

## ITJobs Scraper

Scrape job ads from ITJobs ([itjobs.pt](https://www.itjobs.pt/)), the Portuguese board for IT and tech jobs. You get the title, company, locations, the work model (on site, remote or hybrid), the salary range when the ad shows one, the posting date and the HOT and featured badges for every ad. Turn on the job page option to add the full text, contract, schedule, tags, valid-through date and the company website. Search by keyword, location, work model, contract, schedule, minimum salary and age of the ad.

### What you get

- One row per ad, with parsed salary numbers (from and up to, in EUR) and a clean ISO date.
- Optional job page details: exact posting date, valid-through date, full description as HTML and plain text, contract type, schedule, reference, postal address data, tags and the company website.
- Each ad once per run, even when several keywords or locations find it.
- A run with no input returns 5 ads for the keyword java.

### Use with AI Agents (MCP)

Connect this actor to any MCP-compatible AI client: Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents.

**Apify MCP server URL:**

`https://mcp.apify.com?tools=santamaria-automations/itjobs-pt-jobs-scraper`

**Example prompt once connected:**

> "Use `itjobs-pt-jobs-scraper` to find up to 5 jobs for the keyword "java" (developer roles in Lisbon). Return results as a table with title, company, location and job URL."

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

### Input

Every field is optional. Example:

```json
{
  "includeDetails": false,
  "maxResults": 5,
  "maxResultsPerQuery": 5,
  "searchQueries": [
    "java"
  ]
}
```

| Field | What it does |
|---|---|
| `searchQueries` | Keywords such as java, python, devops or product owner. Each keyword is its own search. |
| `locations` | Lisboa, Porto, Braga, Aveiro, Coimbra, Setubal, Leiria, Faro and the other places of the site, or International. Names with or without accents work. |
| `workModels` | Presencial (on site), Remoto (remote) or Hibrido (hybrid). |
| `contractTypes` | Contrato sem termo, Contrato a termo, Prestacao de Servicos or Estagio profissional. permanent, fixed-term, freelance and internship work too. |
| `schedules` | Full-time or Part-time. |
| `minSalary` | Only ads with a salary above this yearly amount in EUR. The site works in steps of 10 000 up to 60 000, then 100 000; the next lower step is used. 0 means no filter. |
| `postedWithin` | 24h, 7d or 15d. |
| `sortBy` | relevance or date, for keyword searches. |
| `maxResultsPerQuery` | Ads per keyword and filter combination. Default 50, up to 1000. |
| `maxResults` | Ads in total. 0 means no limit. |
| `includeDetails` | Read each job page for the extra fields. Default false. |

### Sample output

```json
{
  "id": "518759",
  "title": "Técnico de Sistemas IT - Field | Licenciatura em Informática + Microsoft AI",
  "slug": "tecnico-de-sistemas-it-field-licenciatura-em-informatica-microsoft-ai",
  "company": "Compuworks",
  "company_slug": "compuworks",
  "company_url": "https://www.itjobs.pt/empresa/compuworks",
  "company_logo": "https://static.itjobs.pt/images/companies/0f/49c/283/logo.png?btfc=1787306453",
  "company_website": "http://www.compuworks.pt/",
  "location": "Lisboa",
  "locations": [
    "Lisboa"
  ],
  "region": "Lisboa",
  "postal_code": "1000-001",
  "country": "PT",
  "work_model": "Presencial",
  "remote": false,
  "hybrid": false,
  "contract_type": "Contrato a termo",
  "schedule": "Full-time",
  "employment_types": [
    "FULL_TIME",
    "TEMPORARY"
  ],
  "salary_text": "€20 000 - €40 000",
  "salary_min": 20000,
  "salary_max": 40000,
  "salary_currency": "EUR",
  "reference": "Tec IT Licenciado",
  "posted_text": "3 Nov",
  "date_posted": "2026-11-03",
  "valid_through": "2026-12-03T10:51:46+00:00",
  "hot": true,
  "featured": true,
  "tags": [
    "ai",
    "microsoft"
  ],
  "description_html": "<p><strong>Estamos a recrutar!</strong></p><p><strong>Técnico de Sistemas IT - Field | Licenciatura em Informática + Microsoft AI</strong></p><p>A <strong>CompuWorks</strong>, empresa de referência na...",
  "description_text": "Estamos a recrutar!\n\nTécnico de Sistemas IT - Field | Licenciatura em Informática + Microsoft AI\n\nA CompuWorks, empresa de referência na prestação de serviços e soluções de Tecnologias de Informação, ...",
  "job_url": "https://www.itjobs.pt/oferta/518759/tecnico-de-sistemas-it-field-licenciatura-em-informatica-microsoft-ai",
  "details_fetched": true,
  "search_query": "java",
  "source": "itjobs.pt",
  "scraped_at": "2026-11-10T15:00:00Z"
}
```

### Fields

| Field | Type | Description |
|---|---|---|
| `id` | string | Ad number: the number in the ad address /oferta/<id>/<slug>. It is the dedup key. |
| `title` | string | Job title as shown on the ad. |
| `slug` | string | Text part of the ad address. |
| `company` | string, null | Hiring company as shown on the ad. |
| `company_slug` | string, null | Text part of the company page address /empresa/<slug>. |
| `company_url` | string, null | Company page on ITJobs with all its ads. |
| `company_logo` | string, null | Logo image URL of the ad. |
| `company_website` | string, null | Website of the company as given in the job posting data. Needs the job page. |
| `location` | string, null | Places of the ad joined by comma. Remote ads often have none. |
| `locations` | array | Places of the ad as a list (Lisboa, Porto, ...). Empty when the ad shows none. |
| `region` | string, null | Region of the first job location in the job posting data. Needs the job page. |
| `postal_code` | string, null | Postal code of the first job location in the job posting data. Needs the job page. |
| `country` | string, null | Country code of the first job location (PT). Needs the job page. |
| `work_model` | string, null | Presencial (on site), Remoto (remote) or Híbrido (hybrid), as shown on the ad. |
| `remote` | boolean, null | True when the work model is Remoto. Null when the ad shows no work model. |
| `hybrid` | boolean, null | True when the work model is Híbrido. Null when the ad shows no work model. |
| `contract_type` | string, null | Contract of the ad, for example Contrato sem termo or Prestação de Serviços. Needs the job page. |
| `schedule` | string, null | Full-time or Part-time. Needs the job page. |
| `employment_types` | array | Employment type codes of the job posting data, for example FULL_TIME. Needs the job page. |
| `salary_text` | string, null | Salary range as shown on the ad, for example "€20 000 - €40 000". Only some ads show one. |
| `salary_min` | number, null | Lower bound of the shown salary in EUR. A single amount is both bounds. |
| `salary_max` | number, null | Upper bound of the shown salary in EUR. |
| `salary_currency` | string, null | Currency code of the shown salary (EUR). |
| `reference` | string, null | Reference code the employer gave the ad. Needs the job page. |
| `posted_text` | string, null | Date box above the ad on the list ("10 Nov"), or the date line of the job page. |
| `date_posted` | string, null | Posting date as ISO date. From the job posting data with the job page, otherwise built from the date box (the year is the current one). |
| `valid_through` | string, null | Date and time until which the ad is valid, ISO 8601. Needs the job page. |
| `hot` | boolean | True when the ad carries the HOT (popular) badge. |
| `featured` | boolean | True when the ad was shown in the "Em destaque" (featured) block of the list. |
| `tags` | array | Tags of the job page. Needs the job page. |
| `description_html` | string, null | Full ad text as HTML. Needs the job page. |
| `description_text` | string, null | Full ad text as plain text. Needs the job page. |
| `job_url` | string | Address of the ad on itjobs.pt. |
| `details_fetched` | boolean | True when the job page was read for this row. |
| `search_query` | string | Keyword that found the ad, or "all jobs" for a search without keyword. |
| `source` | string | Site the ad comes from (itjobs.pt). |
| `scraped_at` | string | Time of the scrape, ISO 8601 UTC. |

### Pricing

This Actor uses pay per event. There is a small `apify-actor-start` event when a run starts and one `job-result` event for each ad in the dataset. You are never charged for an ad twice, and a run stops when it reaches the maximum charge you set.

Price: $0.001 start fee per run, then $0.0012 per job result ($1.20 per 1,000 jobs).

**New to Apify?** Every account gets a $5 free monthly platform credit, enough to try this actor at no cost.

### Related Actors

- [Net-Empregos.pt Scraper: Portugal Jobs, Salaries and Employers](https://apify.com/santamaria-automations/net-empregos-pt-scraper): Portuguese job listings from Net-Empregos.pt.
- [NoFluffJobs.com EU Scraper - Engineering Jobs & Salaries](https://apify.com/santamaria-automations/nofluffjobs-eu-scraper): Engineering jobs and salaries from NoFluffJobs.
- [JustJoin.it Scraper](https://apify.com/santamaria-automations/justjoinit-scraper): IT jobs with salary ranges from JustJoin.it.
- [InfoJobs Scraper - Spanish Job Listings & Salaries | $3/1K Jobs](https://apify.com/santamaria-automations/infojobs-scraper): Spanish job listings and salaries from InfoJobs.

### FAQ

**Which filters can I combine?**
All of them. Locations, work models, contract types and schedules accept several values: each value is read as its own search and an ad found twice is returned once. With several keywords, each keyword runs as its own search too.

**Why is the salary empty for most ads?**
Most employers do not state a salary on the list. Then `salary_text` and the numeric salary fields are `null`. The `minSalary` filter still works, because the site filters on the salary the employer entered.

**Is the posting date exact?**
With `includeDetails` on, yes: it comes from the job page. With it off, the list only shows a day and a month above each group of ads (for example "10 Nov"), so the date is built from that with the current year. Ads in the featured block carry no date until the job page is read.

**What happens when a keyword finds nothing?**
The run ends normally with the status "0 jobs found for <keyword>." and nothing is charged. The latest ads the site shows beside a page without matches are not returned.

**Why do some ads have no location?**
Some remote ads show no place on the list. Then `location` is `null` and `locations` is an empty list.

### Support

Something broken, or a field you wish this Actor returned? Open a ticket on the Actor's [Issues tab](https://apify.com/santamaria-automations/itjobs-pt-jobs-scraper/issues) or email contact@nanoscrape.com. We usually respond within one working day.

# Changelog

This Actor's version history is a separate document: https://apify.com/santamaria-automations/itjobs-pt-jobs-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords such as java, python, devops or product owner. Each keyword runs as its own search on ITJobs; an ad found by several keywords is returned once. Leave empty to list the newest ads (or the ads that match the filters).

## `locations` (type: `array`):

Only ads in these places: Lisboa, Porto, Braga, Aveiro, Coimbra, Setúbal, Leiria, Faro, Santarém, Castelo Branco, Açores, Viana do Castelo, Vila Real, Bragança or International. Names without accents work too. The numeric id of the site works as well. Each place is its own search; an ad found twice is returned once.

## `workModels` (type: `array`):

Only ads with these work models: Presencial (on site), Remoto (remote) or Híbrido (hybrid). onsite, remote and hybrid work too.

## `contractTypes` (type: `array`):

Only ads with these contracts: Contrato sem termo (permanent), Contrato a termo (fixed term), Prestação de Serviços (freelance) or Estágio profissional (internship). permanent, fixed-term, freelance and internship work too.

## `schedules` (type: `array`):

Only ads with these working hours: Full-time or Part-time.

## `minSalary` (type: `integer`):

Only ads that state a salary above this amount. The site filters in steps of 10 000, 20 000, 30 000, 40 000, 50 000, 60 000 and 100 000; the next lower step is used, and any amount below 10 000 gives all ads that state a salary. 0 = no salary filter.

## `postedWithin` (type: `string`):

Only ads posted within this time. Leave empty for all ads.

## `sortBy` (type: `string`):

Order of a keyword search: relevance or newest first. The site only offers this for keyword searches; leave empty for its default order.

## `maxResultsPerQuery` (type: `integer`):

Maximum number of ads per keyword and filter combination (or in total when no keyword is set). 0 = up to 1000.

## `maxResults` (type: `integer`):

Maximum number of ads in the dataset across all searches. 0 = no limit.

## `includeDetails` (type: `boolean`):

Read each job page for the full description, contract, schedule, work model, reference, tags, valid-through date, company website and exact posting date. Turn on when you need more than the list fields; the run is slower.

## Actor input object example

```json
{
  "minSalary": 0,
  "maxResultsPerQuery": 50,
  "maxResults": 0,
  "includeDetails": false
}
```

# Actor output Schema

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

Dataset with the scraped ITJobs job ads.

# 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("santamaria-automations/itjobs-pt-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 = {}

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,santamaria-automations/itjobs-pt-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/W3s85gpqVjfVNlENB/builds/0Xfm1GPDpNMqSMDaH/openapi.json
