# Paylocity Jobs Scraper: Full Ads, Pay, Places & Alerts (`notarealgamedev/paylocity-jobs`) Actor

Every open job from any Paylocity job board (recruiting.paylocity.com): health centres, dealerships, schools, manufacturers, non-profits. Clean JSON with the full ad, street address and ZIP, department, remote flag, posting date and pay as numbers. Filters and only-new-jobs monitoring.

- **URL**: https://apify.com/notarealgamedev/paylocity-jobs.md
- **Developed by:** [NotAReal GameDev](https://apify.com/notarealgamedev) (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

from $8.00 / 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/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

## Paylocity Jobs Scraper: Full Ads, Pay, Places & Alerts

### What does Paylocity Jobs Scraper do?

It reads the job board of any employer that hires through **Paylocity** and returns every open job as clean, flat JSON: boards on `recruiting.paylocity.com/Recruiting/Jobs/All/{board id}`, used by thousands of US health centres, dealerships, schools, manufacturers, restaurants, non-profits and other mid-sized employers that run their HR and payroll on Paylocity.

It reads what job seekers see: the board's list of open jobs and each delivered job's own posting. No login, no API key, no browser. Paste one board or a thousand.

**Typical uses**

- **Job boards and aggregators**: complete, fresh postings from mid-sized US employers that rarely appear elsewhere.
- **Sales signals**: who is hiring, where and for what, with the employer's website on every row.
- **Pay research**: hourly and yearly pay as numbers for frontline, clinical and skilled roles.
- **Alerts**: only the jobs that are new since the last run, plus notice of jobs that closed.

### Why this one

| | What you get |
|---|---|
| **The full ad** | Each job's own posting is read: the whole ad as text (and HTML on request), with the date it was first published and the date it was last updated. |
| **The exact place** | City and state with the ISO country code, and in `extras` the workplace's street address, ZIP code, county and location name, straight from the board's own data. |
| **Pay as numbers** | Pay written in the ad becomes numbers with currency and period: "$16.85 - $18.87 per hour" becomes 16.85–18.87, USD, hour. |
| **Remote and departments** | The board's remote flag, the hiring department when the employer sets one, and hybrid roles from the title. |
| **Filters before you pay** | Title words, locations, remote, posted within N days, ad language. Jobs removed by filters are not charged. |
| **Only new jobs** | Monitoring returns only jobs you have not received, and lists jobs that closed since the last run. |
| **Polite and complete** | One request for the whole board, then one per job page, one at a time: Paylocity answers too many requests at once with "try later", so reading one page at a time is both faster and complete. |

**Test, 15 November 2026:** Indiana Health Centers (30 jobs):

- **30 of 30 jobs** in 19 seconds (32 requests, no retries), each with the full ad, the first and last publication dates, the language, the country code, the street address and ZIP of the clinic, and the employer's website.
- Pay as numbers for the **22** jobs whose ad states it.

### How to use it

1. Paste one or more entries into **Job boards**, one per line:
   - **Board link**: `https://recruiting.paylocity.com/Recruiting/Jobs/All/0062c37f-a34c-479c-978c-bd800d23f223` (links with the company name after the id, and the board's feed link, work too)
   - **Short form**: `paylocity:0062c37f-a34c-479c-978c-bd800d23f223`
   - **The company's own careers page**, when it links to its Paylocity board
2. Optionally set filters: title words, location, remote, posted within N days, ad language. **Jobs removed by filters are not charged.**
3. Click **Start**. Download the results as JSON, CSV or Excel, or get them through the API.

#### Input example

```json
{
  "companies": [
    "https://recruiting.paylocity.com/Recruiting/Jobs/All/0062c37f-a34c-479c-978c-bd800d23f223"
  ],
  "titleKeywords": ["nurse", "medical assistant"],
  "maxJobsPerCompany": 100,
  "onlyNewJobs": true,
  "monitorId": "clinic-jobs"
}
```

#### Daily monitoring

Set **Only new jobs** and schedule the Actor, for example daily. Each run returns only the jobs this monitor hasn't delivered before, so you pay for each job once. Each **Monitor name** keeps its own memory, and the run summary (key-value store `OUTPUT`) lists jobs that closed since the last run.

### Output

One row per job. Example (shortened):

```json
{
  "title": "Intake Specialist - Bedford",
  "companyName": "Indiana Health Centers, Inc.",
  "ats": "paylocity",
  "board": "0062c37f-a34c-479c-978c-bd800d23f223",
  "jobId": "4518872",
  "location": "Bedford, IN",
  "country": "United States",
  "countryCode": "US",
  "salaryMin": 16.85,
  "salaryMax": 18.87,
  "salaryCurrency": "USD",
  "salaryPeriod": "hour",
  "postedAt": "2026-11-13T16:40:38Z",
  "updatedAt": "2026-11-13T22:40:32Z",
  "language": "en",
  "url": "https://recruiting.paylocity.com/Recruiting/Jobs/Details/4518872",
  "applyUrl": "https://recruiting.paylocity.com/Recruiting/Jobs/Apply/4518872",
  "description": "Indiana Health Centers, Inc. (IHC) is a mission-driven organization…",
  "extras": {
    "address": "2415 Mitchell Road STE C",
    "postalCode": "47421",
    "county": "Lawrence",
    "locationName": "IHC Bedford",
    "companyWebsite": "https://indianahealthonline.org/"
  }
}
```

| Field | Meaning |
|---|---|
| `title`, `companyName` | Job title and employer. |
| `department` | The hiring department, when the employer sets one. |
| `location`, `locations`, `country`, `countryCode` | City and state, country and its ISO code. |
| `workplaceType` | `remote` when the board flags the job as remote; `hybrid` when the title says so. |
| `employmentType`, `seniority` | Full-time, part-time… when the posting says so; seniority from the title. |
| `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod` | Pay when the ad states it. |
| `postedAt`, `updatedAt` | First publication on the board and the last update of the posting (UTC). |
| `language` | Language of the ad. |
| `url`, `applyUrl`, `boardUrl` | Job page, application page and the board. |
| `description`, `descriptionHtml` | Plain text (on by default) and HTML (off by default). |
| `extras` | The workplace's street address, ZIP code, county and location name, the employer's website. |
| `jobId`, `jobKey` | The job's Paylocity ID and a unique key for de-duplication. |

The run summary (key-value store `OUTPUT`) lists every board with its status, jobs on the board, jobs matching your filters, jobs delivered, a hiring snapshot and any notes.

### Pricing

**$6.00 per 1,000 jobs delivered** ($0.006 per job, the full ad included), plus Apify's small charge per run start. Jobs removed by your filters are free, and so are jobs already delivered to a monitor.

Examples:

- 10 employers × 30 jobs = 300 jobs = **$1.80**.
- Daily monitoring of 50 employers with about 15 new jobs a day ≈ 450 jobs a month ≈ **$2.70 a month**.

### FAQ

**How do I find an employer's Paylocity board?** Open a job on the employer's careers page: the address bar or the Apply button shows `recruiting.paylocity.com/Recruiting/Jobs/...`. The board link is the one with `Jobs/All/` and a long id; paste it, or the careers page that links to it.

**Is this allowed?** The Actor reads public job ads that employers publish so that people find them, within the site's robots.txt rules (it has none today), without logging in. Personal e-mail addresses and phone numbers in ads are removed; shared mailboxes such as careers@ are kept. How you use the data is up to you and the laws that apply to you.

**Other job systems?** **Career Page Jobs** by the same author reads more than 20 hiring systems (Greenhouse, Lever, Workday, iCIMS, Jobvite, Paylocity and more) in one run, with the same output.

### Integrations

Results work with anything Apify connects to: the API, webhooks at the end of each run, Google Sheets, Slack, email, Make, Zapier and n8n.

# Changelog

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

# Actor input Schema

## `companies` (type: `array`):

One per line: a company's Paylocity job board (https://recruiting.paylocity.com/Recruiting/Jobs/All/<board id>, or a link to its feed), the short form (paylocity:<board id>), or the company's own careers page when it links to its Paylocity board.

## `maxJobsPerCompany` (type: `integer`):

Newest jobs first. 0 = no limit. You pay per job delivered, so this also caps the cost per company in each run.

## `maxJobs` (type: `integer`):

The most jobs this run delivers across every entry together (0 = no limit). Also caps the cost of a run.

## `titleKeywords` (type: `array`):

Keep only jobs whose title contains at least one of these words or phrases (not case-sensitive, whole words). Example: engineer, data, sales. Filtered-out jobs are free.

## `excludeTitleKeywords` (type: `array`):

Drop jobs whose title contains any of these words. Example: intern, senior.

## `locationKeywords` (type: `array`):

Keep only jobs whose location, country or remote type mentions one of these. Example: Oslo, Norway, NO, Remote.

## `workplaceTypes` (type: `array`):

Keep only remote, hybrid and/or on-site jobs. Jobs whose workplace type is unknown are dropped when this is set.

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

Keep only jobs published in the last N days. Jobs without a publish date are kept.

## `languages` (type: `array`):

Keep only job ads written in these languages (stated by the job board, or detected from the ad text). Useful for, e.g., English-language jobs in Norway, Germany or the Netherlands. Ads whose language can't be determined (very short ads) are left out.

## `keywordFilter` (type: `array`):

Keep jobs where any of these words is in the title, the company name, the department or the job board's tags. Whole words, any case.

## `seniorities` (type: `array`):

Keep jobs of these levels, read from the title (and the job board's level when it has one). Jobs whose level is unknown are removed when this is set.

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

Keep jobs of these types. Jobs whose type is not stated are removed when this is set.

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

Remove jobs whose highest stated pay is below this, per year (a monthly salary counts 12 times, a weekly 52, a daily 260, an hourly 2,080). Jobs without a salary pass unless "Only jobs with a salary" is on.

## `minSalaryCurrency` (type: `string`):

Optional, e.g. USD or EUR: only salaries in this currency are compared; others count as no salary.

## `requireSalary` (type: `boolean`):

Keep only jobs that state a salary (in the currency above, if one is set).

## `techRolesOnly` (type: `boolean`):

Remove jobs whose title is clearly not a technical role (receptionist, driver, nurse, accountant, recruiter, cashier and similar).

## `postedAfter` (type: `string`):

Keep jobs posted on or after this date (jobs without a date pass).

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

Full ad text, ready for search or AI. Turn off for smaller exports.

## `includeDescriptionHtml` (type: `boolean`):

The original formatted ad, for re-publishing on your own job board.

## `onlyNewJobs` (type: `boolean`):

Return only jobs this monitor has not delivered before, so you never pay twice for a job. Schedule the Actor (e.g. daily) and you pay only for new jobs. Jobs that have closed since they were delivered are listed for free in the run's OUTPUT record.

## `monitorId` (type: `string`):

Keeps separate memories for separate watch lists, e.g. 'nordic-fintech' or 'client-a'. Letters, numbers, - and \_. Only one run per monitor can work at a time; a second one stops immediately instead of charging twice.

## `skipExistingOnFirstRun` (type: `boolean`):

The first time this monitor reads a company (also companies you add later), save its open jobs as the starting point without delivering them (free). From then on you get only newly posted jobs. Turns on monitoring mode.

## `webhookUrl` (type: `string`):

At the end of the run, the delivered jobs are POSTed here as JSON, 50 per request: {runId, monitorId, batch, batches, jobs}.

## `webhookSecret` (type: `string`):

Each request is signed with it: header X-Signature-256 = "sha256=" + HMAC-SHA256 of the body. For receivers made for other tools it is also sent as X-Scraper-Secret (https only).

## `maxConcurrency` (type: `integer`):

How many companies are read at the same time. The default is polite to the job boards; raise it only for very long lists.

## Actor input object example

```json
{
  "companies": [
    "https://recruiting.paylocity.com/Recruiting/Jobs/All/0062c37f-a34c-479c-978c-bd800d23f223"
  ],
  "maxJobsPerCompany": 5,
  "requireSalary": false,
  "techRolesOnly": false,
  "includeDescription": true,
  "includeDescriptionHtml": false,
  "onlyNewJobs": false,
  "monitorId": "default",
  "skipExistingOnFirstRun": false,
  "maxConcurrency": 6
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "companies": [
        "https://recruiting.paylocity.com/Recruiting/Jobs/All/0062c37f-a34c-479c-978c-bd800d23f223"
    ],
    "maxJobsPerCompany": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("notarealgamedev/paylocity-jobs").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 = {
    "companies": ["https://recruiting.paylocity.com/Recruiting/Jobs/All/0062c37f-a34c-479c-978c-bd800d23f223"],
    "maxJobsPerCompany": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("notarealgamedev/paylocity-jobs").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 '{
  "companies": [
    "https://recruiting.paylocity.com/Recruiting/Jobs/All/0062c37f-a34c-479c-978c-bd800d23f223"
  ],
  "maxJobsPerCompany": 5
}' |
apify call notarealgamedev/paylocity-jobs --silent --output-dataset

```

## MCP server setup

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

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/NKUhgwwfCzF22acjn/builds/qC17I4iv2wN4Cez9Q/openapi.json
