# publicjobs.ie Scraper - Irish Civil and Public Service Jobs (`studio-amba/publicjobs-ie-scraper`) Actor

Scrape the open vacancies on publicjobs.ie, the Irish civil and public service recruiter. Get title, department, location, grade, contract, closing date and time, information booklets and the full description. No login.

- **URL**: https://apify.com/studio-amba/publicjobs-ie-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

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

## publicjobs.ie Scraper

Extract every open vacancy from [publicjobs.ie](https://www.publicjobs.ie), the Irish civil and public service recruiter, as structured JSON. Each row has the job title, the hiring department, the location and county, the grade, the contract type, the advertising and closing dates, the closing time of day, the candidate information booklets and the full job description.

No login. No cookies. No browser. The actor reads the plain HTML pages of the recruitment board that publicjobs.ie sends candidates to, so a run needs no browser and costs a fraction of a cent.

### What this actor does

publicjobs.ie runs its vacancy board on the publicjobs.tal.net recruitment platform. The board lists the open vacancies 50 to a page, and every vacancy has its own detail page. The actor walks the list, then opens each vacancy and returns one record with:

- Vacancy ID and job title
- Department or organisation that is hiring
- Location and county
- Grade, for example Clerical Officer, Executive Officer or Principal Officer
- Contract type, working pattern and type of role (civil service or public service)
- Advertising date and closing date, plus the closing time of day
- Department website
- Download links of the candidate information booklets (PDF)
- Job summary, main duties and information about the organisation
- Direct link to the vacancy

You can limit the run to vacancies whose title contains a word, such as nurse, engineer or clerical.

### Why use it

- **Public sector recruitment tracking.** See which Irish departments and agencies are hiring, at which grade, on which contract.
- **Closing date alerts.** Closing date and time of day are separate fields, so you can sort and alert on them.
- **Job aggregators.** Feed Irish civil and public service vacancies into your own job board with consistent fields.
- **Labour market research.** Count open vacancies per department, county or grade, and compare week over week.
- **Recruitment agencies and training providers.** Find the roles that match the people or courses you work with.

### How to scrape publicjobs.ie data

1. Open the actor and optionally enter a **Job title keyword**. Leave it empty for every open vacancy.
2. Set **Max Results**. The board lists about 260 open vacancies at a time, and the default of 300 covers all of them.
3. Leave **Include detail pages** on to get grade, contract, closing time, booklets and the description. Turn it off for a fast run with the list fields only.
4. Click **Start**. The actor reads the list page by page, opens each vacancy and writes one row per vacancy to the dataset.
5. Export the result as JSON, CSV or Excel, or read it through the Apify API.

A full run with detail pages takes about 15 minutes, because the actor waits between requests. A run without detail pages finishes in under a minute. To track the board over time, schedule the actor daily and compare the datasets by `vacancyId`.

### Input

| Field | Type | Description |
|-------|------|-------------|
| `keyword` | string | Only return vacancies whose title contains this word. Empty returns all. |
| `maxResults` | integer | Maximum number of vacancies to return. Default: `300`, maximum `1000`. |
| `includeDetails` | boolean | Open each vacancy page for grade, contract, closing time, booklets and description. Default: `true`. |
| `requestDelaySeconds` | integer | Pause between requests to the recruitment site. Default: `3`. The site's robots.txt asks for 10 seconds. |
| `proxyConfiguration` | object | Apify proxy settings. Default: Apify datacenter proxy. If the site refuses a request, the actor retries through Apify residential proxy. |

#### Example input

```json
{
    "keyword": "nurse",
    "maxResults": 50,
    "includeDetails": true,
    "proxyConfiguration": { "useApifyProxy": true }
}
```

### Output

Each vacancy is one row.

```json
{
    "vacancyId": "10583",
    "jobTitle": "Deputy Director – Coastal Units Branch, Irish Coast Guard (IRCG)",
    "department": "Department of Transport",
    "location": "Dublin",
    "county": "Dublin",
    "grade": "Principal Officer",
    "contract": "Permanent",
    "roleType": "Civil Service",
    "workingPattern": null,
    "vacancyType": "publicjobs",
    "advertisingDate": "2026-11-13",
    "closingDate": "2026-12-17",
    "closingDateTime": "2026-12-17T15:00",
    "departmentWebsite": "https://coastguard.gov.ie/",
    "informationBookletUrls": ["https://publicjobs.tal.net/.../download_file_opp/10583/105858/1/0/..."],
    "description": "Job summary\nThe Irish Coast Guard (IRCG) is undergoing a significant programme of organisational transformation...",
    "url": "https://publicjobs.tal.net/vx/.../opp/10583-Deputy-Director-Coastal-Units-Branch-Irish-Coast-Guard-IRCG/en-GB",
    "scrapedAt": "2026-11-17T15:03:11.281Z"
}
```

| Field | Description |
|-------|-------------|
| `vacancyId` | Vacancy number on publicjobs.ie |
| `jobTitle` | Title of the vacancy |
| `department` | Hiring department or organisation |
| `location`, `county` | Workplace location and county |
| `grade`, `contract`, `roleType`, `workingPattern` | Grade, contract type, type of role and working pattern |
| `vacancyType` | Vacancy type shown on the list |
| `advertisingDate`, `closingDate` | Dates as YYYY-MM-DD |
| `closingDateTime` | Closing date and time of day in Irish time |
| `departmentWebsite` | Website of the hiring department |
| `informationBookletUrls` | PDF download links of the candidate information booklets |
| `description` | Job summary, main duties and organisation text |
| `url` | Link to the vacancy |
| `scrapedAt` | UTC timestamp of the run |

### Data quality

The list fields (`vacancyId`, `jobTitle`, `department`, `location`, `advertisingDate`, `closingDate`, `url`) come from the list page and are present on every row. The detail fields (`county`, `grade`, `contract`, `roleType`, `closingDateTime`, `description`) come from the vacancy page. A field the department did not fill in returns `null`. On a live run of 60 vacancies the county, location, closing date and description were filled on every row, the contract on 80% and the grade on 30%, because many vacancies (medical posts, external recruiter posts) carry no grade. Every `vacancyId` in a run is unique.

### Cost estimate

The actor makes plain HTTP requests: 6 list pages and one detail page per vacancy. A full run of about 260 vacancies costs a fraction of a cent in platform compute. Usage cost settles once the run reports SUCCEEDED, so reading the dataset while the run is still going shows a lower figure than the final charge.

### Limitations

- **Slow by design with detail pages.** The recruitment site's robots.txt asks for a 10 second crawl delay. The default delay is 3 seconds. Raise it with `requestDelaySeconds` if you want to follow the request exactly.
- **Open vacancies only.** The board shows what is open now. It is not a historical archive, so schedule runs if you want history.
- **Other recruiters.** Departments that recruit through their own sites are not on this board. The actor covers vacancies run through publicjobs.
- **Salary is in the booklet.** The vacancy page does not carry a structured salary field. Pay scales are in the information booklets, which the actor links but does not parse.
- **Keyword matches the title only.** The board's search looks at vacancy titles.

### FAQ

**Does it need a login or an API key?**
No. The board is public.

**Can I search by department or county?**
Not as an input. Export the dataset and filter on `department` or `county`.

**How many vacancies does a run return?**
Up to the Max Results value. The board lists about 260 open vacancies at a time.

**How fresh is the data?**
Each run reads the live board.

**Are the dates in Irish time?**
`closingDateTime` is the local Irish closing time as printed on the vacancy. Dates are plain calendar dates.

### Related scrapers

Building an Irish jobs dataset? These actors return the same kind of clean JSON:

- **Jobs.ie Scraper** for Irish private sector jobs
- **IrishJobs Scraper** for Irish jobs from IrishJobs.ie

### Disclaimer

This actor collects publicly available data from publicjobs.ie for research and aggregation. Respect the terms of service of publicjobs.ie and applicable data protection law when you use the output.

# Actor input Schema

## `keyword` (type: `string`):

Only return vacancies whose title contains this word, for example nurse or engineer. Leave empty for every open vacancy.

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

Maximum number of vacancies to return. The board lists about 260 open vacancies at a time.

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

Open each vacancy page for grade, contract, role type, county, closing time, information booklets and the full description. Turn off to get only the list fields, which is much faster.

## `requestDelaySeconds` (type: `integer`):

Pause between requests to the recruitment site. Its robots.txt asks for a crawl delay of 10 seconds. The default of 3 keeps a full run with details at about 15 minutes.

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

Proxy settings. The site is reachable through Apify datacenter proxy. If it refuses a request, the actor retries through Apify residential proxy.

## Actor input object example

```json
{
  "maxResults": 5,
  "includeDetails": true,
  "requestDelaySeconds": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxResults": 5,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/publicjobs-ie-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 = {
    "maxResults": 5,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/publicjobs-ie-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 '{
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/publicjobs-ie-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/publicjobs-ie-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/hBiujeRRQ6ErdMyMZ/builds/KmofIwxXcArro8a7r/openapi.json
