# York CVS Jobs Scraper (`memo23/yorkcvs-scraper`) Actor

Scrape yorkcvs.livevacancies.co.uk — Vue SPA hosted by hireful, but NO browser needed. Actor reverse-engineered the public JSON API. Each row: title, salary, location, full description HTML, ISO closing date, region, contract type, hours. JSON or CSV out.

- **URL**: https://apify.com/memo23/yorkcvs-scraper.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** Jobs, Agents, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## York CVS Jobs Scraper

**Scrape the York CVS jobs board at yorkcvs.livevacancies.co.uk — even though it's a Vue SPA.** No browser automation needed. The actor reverse-engineered the hireful SaaS bundle and hits the public JSON API directly with a single HTTP call. Each row carries title, salary, location, full description HTML, ISO closing date, region, contract type, hours, employer brand info, and PDF attachments. JSON or CSV out, no compute charge per run, just per result.

#### How it works

![How York CVS Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-yorkcvs.png)

#### ✨ Why use this scraper?

York CVS hosts its job board through **hireful** — a SaaS Applicant Tracking System with a Vue SPA front-end. Tracking who's hiring at York-area charities? Building a North Yorkshire voluntary-sector dashboard? Want a structured feed without firing up a headless browser?

- 🚀 **No browser, no Playwright.** We reverse-engineered hireful's SPA bundle and found the public JSON API: `https://api.core-easywebats.com/v1/job/all`. The only auth is the `Origin` header — the API maps Origin → company internally.
- ⚡ **One HTTP call, full payload.** The list endpoint returns EVERY job with EVERY field (title, salary, location, full description HTML, ISO closing date, region, contract type, hours, employer brand info, PDF attachments) — no per-job detail fetch needed.
- 🎯 **Two starting points.** The hireful API URL directly, or any `yorkcvs.livevacancies.co.uk` SPA URL (auto-redirected to the API).
- 🆔 **Stable identifiers.** Both `job_number` (sequential) and `id` (UUID) preserved per row.
- 🇬🇧 **York / North Yorkshire focus.** Social prescribers, support workers, project coordinators — charity-sector roles at York-area orgs.
- 📤 **Clean exports.** One row per vacancy with all fields inline. JSON + CSV exported automatically.

#### 🎯 Use cases

| Team | What they build |
|------|-----------------|
| **York-area CVS network** | Cross-borough nonprofit hiring intelligence |
| **Social-care recruiters** | Daily new-vacancy feeds for York charity sector |
| **Researchers** | York labour-market datasets across charity / public-sector roles |
| **Workforce strategy** | Salary intelligence with structured `{currency, min, max}` |
| **ATS / aggregator builders** | hireful-API integration reference (any livevacancies.co.uk tenant works with the same pattern, just swap the Origin header) |

#### 📥 Supported inputs

| URL pattern | Behaviour |
|---|---|
| `https://api.core-easywebats.com/v1/job/all` | **Direct API call** (default) |
| `https://yorkcvs.livevacancies.co.uk/` | **SPA root** — auto-routes to the API call |
| `https://yorkcvs.livevacancies.co.uk/#/jobs/<number>` | **SPA detail URL** — also routes to the full list (and the row matching `<number>` is included) |

Leave `startUrls` empty for the default.

**Not supported:** other hireful tenants (the actor is wired to York CVS's Origin specifically — drop us an email if you want a different tenant).

#### 🔄 How it works

1. **Send GET** to `https://api.core-easywebats.com/v1/job/all` with:
   - `Origin: https://yorkcvs.livevacancies.co.uk`
   - `Referer: https://yorkcvs.livevacancies.co.uk/`
2. **Parse the JSON array** — every job is a complete record (no pagination, no detail fetch).
3. **For each item**, normalise into our standard `JobRecord` shape:
   - Concat `description[].description` blocks → single HTML body
   - Parse `salary` string → `{currency, min, max, raw}`
   - Extract apply email/URL from description body via regex
4. **Push one row per job** to the dataset.

#### ⚙️ Input parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `startUrls` | array | `["https://api.core-easywebats.com/v1/job/all"]` | Hireful API URL or any `yorkcvs.livevacancies.co.uk` URL. Empty = default. |
| `postedWithinHours` | integer | (none) | Only return rows posted in the last N hours (24 = last day, 72 = last 3 days). Empty/0 = all. Ideal for daily monitoring runs that only want fresh postings. |
| `maxItems` | integer | `1000` | Hard cap on rows pushed. |
| `maxConcurrency` / `minConcurrency` | integer | `5` / `1` | Reserved — single-call design. |
| `maxRequestRetries` | integer | `5` | Retries before the API call is given up. |
| `proxy` | object | No proxy | API has no anti-bot — proxy optional. |

#### 📊 Output overview

Each scraped vacancy is one **single dataset row** of `type: "job"`. No detail-page enrichment needed — the hireful list endpoint is the data source AND the detail source.

#### 📦 Output sample

```json
{
  "type": "job",
  "source": "yorkcvs.livevacancies.co.uk",
  "sourceProvider": "hireful",
  "jobId": "22",
  "jobUuid": "160de6e5-b0f9-4b21-bfbb-9c5df157283f",
  "slug": "22",
  "jobUrl": "https://yorkcvs.livevacancies.co.uk/#/jobs/22",
  "apiUrl": "https://api.core-easywebats.com/v1/job/22",
  "title": "Social Prescriber – Respiratory - COPD",
  "description": "<p><strong>Job Role: Social Prescriber</strong></p><p>…</p>",
  "descriptionText": "Job Role: Social Prescriber\nProject: Respiratory - COPD\n…",
  "companyId": "83252488-8c92-49cc-95ea-ecc0ebf13fbc",
  "companyName": null,
  "location": "York",
  "city": "York",
  "county": null,
  "country": "United Kingdom",
  "region": "Yorkshire and the Humber",
  "internalRegion": null,
  "salary": {
    "currency": "GBP",
    "min": 29768,
    "max": 29768,
    "raw": "£29,768"
  },
  "salaryRaw": "£29,768",
  "contractType": null,
  "hours": "37",
  "department": null,
  "positions": "1",
  "categories": [],
  "employmentTypes": [],
  "status": "publish",
  "postedDate": "2026-04-12T09:00:00.000Z",
  "closingDate": "2026-06-02T17:00:00.000Z",
  "modifiedDate": "2026-05-15T14:22:00.000Z",
  "applyType": "email",
  "applyUrl": "https://yorkcvs.livevacancies.co.uk/#/jobs/22",
  "applyEmail": "socialprescribing@yorkcvs.org.uk",
  "externalApplyUrl": null,
  "customApplyUrl": null,
  "brandInfo": { },
  "jobFiles": [],
  "customFields": { "string": {}, "integer": {} },
  "scrapedAt": "2026-05-22T19:42:00.000Z"
}
```

#### 🗂 Key output fields

| Group | Fields |
|---|---|
| **Identifiers** | `type`, `source`, `sourceProvider` (`hireful`), `jobId` (numeric ref), `jobUuid` (hireful UUID), `slug`, `jobUrl`, `apiUrl`, `scrapedAt` |
| **Content** | `title`, `description` (HTML), `descriptionText` (plain) |
| **Dates** | `postedDate` (ISO), `closingDate` (ISO), `modifiedDate` (ISO) |
| **Employer** | `companyId`, `companyName`, `brandInfo` (raw block), `companyLogoUrl` (when in jobFiles) |
| **Location** | `location`, `addressLine1`, `addressLine2`, `city`, `county`, `country`, `region`, `internalRegion` |
| **Compensation** | `salary.{currency, min, max, raw}`, `salaryRaw`, `hours` |
| **Work pattern** | `contractType`, `hours`, `positions`, `department` |
| **Apply flow** | `applyType`, `applyUrl` (SPA URL), `applyEmail`, `externalApplyUrl`, `customApplyUrl` |
| **hireful-specific** | `jobFiles[]` (PDF attachments), `customFields.{string,integer}` (recruiter-defined fields) |

#### ❓ FAQ

**Wait — no browser? How?**
The hireful SaaS bundles a Vue SPA that talks to a public JSON API. The bundle's URL-template strings revealed the API base (`api.core-easywebats.com`) and the list path (`v1/job/all`). The API authenticates by the request's `Origin` header — when we send `Origin: https://yorkcvs.livevacancies.co.uk`, it returns York CVS's jobs.

**Why is `companyName` sometimes null?**
hireful doesn't enforce `company_name` in `brand_info` — it's an optional recruiter-side label. The `description` HTML almost always names the employer in the body. Use `companyId` (UUID) as the stable join key.

**Could you scrape other hireful tenants?**
Yes — every `{tenant}.livevacancies.co.uk` site uses the same API + the same Origin-based auth. Drop us an email to wire up a different tenant.

**Can I scrape private pages or applicant data?**
No. The actor only hits the public job-listing endpoint that any visitor's browser would fetch.

**How do I limit results?**
Set `maxItems`. Currently only 1 vacancy is live; the cap mostly matters for tenants with high volumes.

#### 💬 Support

- For issues or feature requests, please use the **Issues** tab on the actor's Apify Console page.
- Author's website: <https://muhamed-didovic.github.io/>
- Email: <muhamed.didovic@gmail.com>

#### 🛠 Additional services

- Custom output shape, additional fields, or one-off datasets: <muhamed.didovic@gmail.com>
- Build a similar actor for any other `*.livevacancies.co.uk` tenant (one-day turnaround): drop an email.
- For API access (no Apify fee, just usage): <muhamed.didovic@gmail.com>

#### 🔎 Explore more scrapers

See other scrapers at [memo23's Apify profile](https://apify.com/memo23) — covering job boards, real estate, social media, and more.

***

### 🤖 For AI Agents & LLM Apps

Compact reference for AI agents calling this actor via the [Apify MCP server](https://mcp.apify.com) or the Apify API (actor: `memo23/yorkcvs-scraper`).

**Purpose:** Scrape York CVS voluntary-sector job vacancies from the WordPress board at yorkcvs.org.uk/jobs/ (default) and the hireful-powered yorkcvs.livevacancies.co.uk board, returning one structured row per vacancy.

**Minimal input:**

```json
{
  "startUrls": ["https://yorkcvs.org.uk/jobs/"],
  "enrichTaxonomies": true,
  "postedWithinHours": 0,
  "maxItems": 50,
  "maxConcurrency": 5,
  "minConcurrency": 1,
  "maxRequestRetries": 5
}
```

To scrape the hireful board instead, pass a `yorkcvs.livevacancies.co.uk/jobs/` URL in `startUrls`; each URL is auto-routed to the right scraper.

**Output:** one row per vacancy — type, source, sourceProvider, jobId, jobUuid, slug, jobUrl, apiUrl, title, description (HTML), descriptionText, companyId, companyName, location, city, county, country, region, salary {currency, min, max, raw}, salaryRaw, contractType, hours, positions, postedDate, closingDate, modifiedDate, applyType, applyUrl, applyEmail, jobFiles\[], customFields, scrapedAt.

**Behaviors an agent should know:**

- Leave `startUrls` empty (or keep the `yorkcvs.org.uk/jobs/` prefill) to scrape the full WordPress board; pass a `yorkcvs.livevacancies.co.uk` URL to hit the hireful board — routing is automatic per URL.
- Always set `maxItems`; the boards hold up to a few hundred live vacancies, and an uncapped run returns them all.
- `postedWithinHours` filters on each row's posted date; leave it 0/empty because this board keeps listings open for months, so a short window often returns nothing.
- `enrichTaxonomies` (default true) adds decoded taxonomy term names plus the featured image URL via WP-JSON `_embed` with no extra HTTP requests.
- `proxy` is optional — the actor routes through a built-in residential proxy at no extra cost; only override to use your own.
- Billing is per result with no per-run compute charge — see the Pricing tab on the actor page for the exact rate.

***

### ⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by York CVS, hireful, EasyWebats Ltd, or any of their subsidiaries or affiliates. All trademarks mentioned are the property of their respective owners.

The scraper accesses only the publicly available JSON API endpoint that the hireful SPA itself calls — no authenticated endpoints, recruiter-only features, or content behind a login. Users are responsible for ensuring their use complies with yorkcvs.livevacancies.co.uk's Terms of Service, applicable data-protection law (GDPR, CCPA, etc.), and any contractual obligations of their own organisation.

***

### SEO Keywords

york cvs scraper, scrape yorkcvs.livevacancies.co.uk, hireful api scraper, hireful jobs api, livevacancies.co.uk scraper, livevacancies api, easywebats api scraper, york charity jobs scraper, north yorkshire voluntary sector jobs api, Apify york cvs, vue spa scraper without browser, spa scraper without playwright, reverse-engineered job board api, charityjob alternative scraper, communityfirstyorkshire alternative scraper, vassheffield alternative scraper, uk cvs jobs scraper, hireful tenant scraper, ats api scraper, third sector jobs api

# Actor input Schema

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

Supported shapes — WordPress board: `https://yorkcvs.org.uk/jobs/` (full board) or `https://yorkcvs.org.uk/jobs/<slug>/` (single job). Hireful board: `https://yorkcvs.livevacancies.co.uk/jobs/`. Leave empty to scrape the full yorkcvs.org.uk board.

## `enrichTaxonomies` (type: `boolean`):

When enabled (recommended), each job row carries decoded taxonomy term names (e.g. `Hospitality & Tourism`, `Seasonal`) plus the featured image URL. No extra HTTP requests are needed — uses WP-JSON `_embed`.

## `postedWithinHours` (type: `integer`):

Filters on each row's posted date. Set 24 for the last day, 72 for the last 3 days, etc. Leave empty (or 0) to return everything regardless of age (default). Note: this board publishes only a creation date and keeps listings open for months, so a short window often returns nothing — leave empty unless you specifically want fresh postings. Rows whose source has no posted date are always kept.

## `maxItems` (type: `integer`):

Hard cap on rows pushed to the dataset. yorkcvs.livevacancies.co.uk currently has ~200 live jobs — set to 1000+ to scrape everything.

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

Maximum WP-JSON pages fetched in parallel. The endpoint is fast and unrestricted — defaults to 5.

## `minConcurrency` (type: `integer`):

Minimum WP-JSON pages fetched in parallel.

## `maxRequestRetries` (type: `integer`):

Number of retries before a failed WP-JSON request is given up.

## `proxy` (type: `object`):

Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies.

## Actor input object example

```json
{
  "startUrls": [
    "https://yorkcvs.org.uk/jobs/"
  ],
  "enrichTaxonomies": true,
  "maxItems": 1000,
  "maxConcurrency": 5,
  "minConcurrency": 1,
  "maxRequestRetries": 5
}
```

# 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 = {
    "startUrls": [
        "https://yorkcvs.org.uk/jobs/"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/yorkcvs-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 = { "startUrls": ["https://yorkcvs.org.uk/jobs/"] }

# Run the Actor and wait for it to finish
run = client.actor("memo23/yorkcvs-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 '{
  "startUrls": [
    "https://yorkcvs.org.uk/jobs/"
  ]
}' |
apify call memo23/yorkcvs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,memo23/yorkcvs-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/EYqyplVnYLDvVth5p/builds/1tODNW3ujWLQg2eyu/openapi.json