# CV-Library Scraper (`unfenced-group/cv-library-scraper`) Actor

Scrape job listings from CV-Library.co.uk, one of the UK's largest job boards. Returns title, company, parsed salary, contract type, full description, industry, geo-coordinates and company details. Filter by keyword, location, radius, salary and date. No API key required.

- **URL**: https://apify.com/unfenced-group/cv-library-scraper.md
- **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community)
- **Categories:** Jobs, Automation, Developer tools
- **Stats:** 33 total users, 7 monthly users, 89.9% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

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

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

## CV-Library Scraper

![CV-Library Scraper](https://api.apify.com/v2/key-value-stores/ClElVyZWvQgPQIuDL/records/cv-library-scraper)

Scrape job listings from cv-library.co.uk, one of the UK's largest job boards, into a clean and consistent structure ready for analysis, job boards, recruiting tools and market research. Search by keyword, location, radius, salary, contract type and date, or paste search URLs. No API key required.

***

### Why this scraper?

#### Built for the United Kingdom

A dedicated British scraper, not a global tool with a country dropdown. Search, locations and currency (GBP) are tuned for cv-library.co.uk.

#### Full job records

Every listing returns title, company, location, contract type, parsed salary, posting date and a direct listing URL. Turn on full details to add the complete job description in HTML, plain text and Markdown.

#### Structured salary

Salary is parsed into minimum, maximum, currency and pay period where the employer publishes it, in GBP. Missing salaries are returned as `null`, never guessed.

#### Geo and location data

With full details on, each listing carries city, region, postcode, latitude and longitude taken directly from the source, ready for mapping and filtering.

#### Company and classification fields

Hiring company name, company ID, company page URL and logo, plus industry, employment type, direct-apply flag and job expiry date.

#### Repost and change detection

Every record carries `isRepost` and `changeStatus`, so scheduled feeds return genuinely new jobs instead of duplicates.

***

### Input parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `searchQuery` | string | `"developer"` | Job title, keywords, or skills. Example: "software developer". Leave empty to browse all jobs. |
| `location` | string | (empty) | City, town, postcode, or county. Example: "London", "M1 1AA", "West Yorkshire". |
| `distance` | integer | (empty) | Search radius around the location, in miles. Example: 15. |
| `maxResults` | integer | `5` | Maximum number of job listings to return. |
| `fetchDetails` | boolean | `false` | ON: opens each job page for the full description, structured salary, industry, employment type, geo-coordinates, region, postcode, expiry date and company logo. OFF: list-level fields only (faster, fewer requests). |
| `contractType` | string | (any) | Filter by contract type: permanent, contract, temporary, part-time, apprenticeship. |
| `daysOld` | integer | (empty) | Only return listings posted within this many days. CV-Library supports 1, 3, 7 or 14 days; other values round up to the nearest band. |
| `salaryFrom` | integer | (empty) | Only return jobs with an annual salary at or above this amount, in GBP. Example: 40000. |
| `salaryTo` | integer | (empty) | Only return jobs with an annual salary at or below this amount, in GBP. Example: 80000. |
| `skipReposts` | boolean | `false` | Skip job IDs already returned in previous runs (90-day deduplication window). Useful for daily incremental feeds. |
| `startUrls` | array | (empty) | Optional list of CV-Library search-result URLs to scrape directly instead of building a search from the fields above. |
| `proxyConfiguration` | object | (none) | Optional. CV-Library is scraped from Apify's datacenter IPs without a proxy by default. |

***

### Output schema

#### Always present (every record)

| Field | Type | Description |
|---|---|---|
| `id` | string | Unique listing ID from the source. |
| `url` | string | Direct link to the listing. |
| `applyUrl` | string | Direct application link. |
| `title` | string | Job title as published. |
| `company` | string | Hiring company name. |
| `companyId` | string | CV-Library company ID (null when the listing has no company page). |
| `companyUrl` | string | Link to the company's jobs page on CV-Library. |
| `location` | string | Location as displayed on the listing. |
| `city` | string | City of the position. |
| `country` | string | Country code (GB). |
| `contractType` | string | Normalised contract type: permanent, contract, temporary, part-time or apprenticeship. |
| `salaryRaw` | string | Salary text exactly as published (null when the employer hides it). |
| `salaryMin` | number | Minimum salary parsed from the listing (null if not published). |
| `salaryMax` | number | Maximum salary parsed from the listing (null if not published). |
| `salaryCurrency` | string | Currency code of the salary (e.g. GBP). |
| `salaryPeriod` | string | Pay period: YEAR, MONTH, WEEK, DAY or HOUR. |
| `publishDate` | string | Publish date (YYYY-MM-DD). |
| `publishDateISO` | string | Publish date as an ISO 8601 timestamp. |
| `isFeatured` | boolean | Whether the listing is a featured/promoted result. |
| `source` | string | Always `cv-library.co.uk`. |
| `scrapedAt` | string | ISO timestamp when this record was scraped. |
| `summary` | string | One-line title, company, location and salary summary. |
| `contentHash` | string | Stable hash of listing identity, used for repost and change detection. |
| `isRepost` | boolean | `true` when this job ID was seen in a previous run (90-day window). |
| `changeStatus` | string | `NEW` or `UNCHANGED` compared to the previous time this job was seen. |
| `originalPublishDate` | string | First-seen publish date (present on reposts). |
| `originalUrl` | string | First-seen listing URL (present on reposts). |

#### Added when `fetchDetails` is `true`

| Field | Type | Description |
|---|---|---|
| `descriptionHtml` | string | Full job description as HTML. |
| `descriptionText` | string | Full job description as plain text. |
| `descriptionMarkdown` | string | Full job description as Markdown. |
| `industry` | string | Industry / sector (e.g. IT, Medical). |
| `employmentType` | string | Employment type from structured data (e.g. FULL\_TIME, PART\_TIME). |
| `contractLength` | string | Contract length for contract and temporary roles (e.g. "6 Months"); null for permanent roles. |
| `region` | string | Region / county of the position. |
| `postcode` | string | Postcode of the position (when published). |
| `latitude` | number | Latitude of the position. |
| `longitude` | number | Longitude of the position. |
| `expiryDate` | string | Date the listing expires (YYYY-MM-DD). |
| `directApply` | boolean | `true` when the job can be applied to directly on CV-Library. |
| `companyLogo` | string | URL of the hiring company's logo. |

Fields the source does not publish for a given job are returned as `null` rather than invented.

#### Example record (`fetchDetails: true`)

```json
{
  "id": "225264382",
  "url": "https://www.cv-library.co.uk/job/225264382/integration-developer",
  "applyUrl": "https://www.cv-library.co.uk/job/225264382/integration-developer/apply",
  "title": "Integration Developer",
  "company": "Orbit Group",
  "companyId": "283820",
  "companyUrl": "https://www.cv-library.co.uk/list-jobs/283820/orbit-group-jobs",
  "location": "Coventry",
  "city": "Binley",
  "region": "England",
  "postcode": "CV3 2SU",
  "country": "GB",
  "latitude": 52.40065,
  "longitude": -1.44129,
  "contractType": "permanent",
  "employmentType": "FULL_TIME",
  "contractLength": null,
  "industry": "IT",
  "salaryRaw": "£63,342 - £69,000 per annum",
  "salaryMin": 63342,
  "salaryMax": 69000,
  "salaryCurrency": "GBP",
  "salaryPeriod": "YEAR",
  "publishDate": "2026-06-18",
  "publishDateISO": "2026-06-18T10:03:19.000Z",
  "expiryDate": "2026-07-18",
  "directApply": false,
  "companyLogo": "https://www.cv-library.co.uk/api/media/file/companylogo-201021-big.gif",
  "isFeatured": false,
  "source": "cv-library.co.uk",
  "scrapedAt": "2026-07-10T07:44:15.986Z",
  "descriptionText": "We're building thriving communities as one of the UK's largest housing groups...",
  "summary": "Integration Developer · Orbit Group · Coventry · £63,342 - £69,000 per annum",
  "contentHash": "ae6b9c562d445237",
  "isRepost": false,
  "changeStatus": "NEW"
}
```

***

### Examples

**Search for warehouse operative roles in Manchester:**

```json
{
  "searchQuery": "warehouse operative",
  "location": "Manchester",
  "distance": 15,
  "maxResults": 100
}
```

**Contract IT roles above £400/day, with full descriptions:**

```json
{
  "searchQuery": "developer",
  "location": "London",
  "contractType": "contract",
  "fetchDetails": true,
  "maxResults": 100
}
```

**Scrape a specific search-results URL:**

```json
{
  "startUrls": [
    { "url": "https://www.cv-library.co.uk/nurse-jobs?l=Leeds" }
  ],
  "maxResults": 200
}
```

**Daily feed (run on a schedule):**

```json
{
  "searchQuery": "warehouse operative",
  "daysOld": 1,
  "skipReposts": true,
  "maxResults": 500
}
```

Schedule this input to run once a day in the Apify Scheduler — each run returns only jobs posted in the last 24 hours, skipping anything already seen.

***

### 💰 Pricing

**$2 per 1,000 results** — you only pay for successfully retrieved listings. Failed retries are never charged.

| Results | Cost |
|---|---|
| 100 | ~$0.20 |
| 1,000 | ~$2 |
| 10,000 | ~$20 |
| 100,000 | ~$200 |

Subscription tiers lower the rate further, down to $1.20 per 1,000 at the highest tier. Use the **Max Items** cap in the input to control your spend exactly.

***

### Performance

| Run size | Typical time (list only) | Typical time (full details) |
|---|---|---|
| 100 results | under 1 minute | 2–4 minutes |
| 1,000 results | 2–4 minutes | 20–35 minutes |

Full details opens one extra page per job, so it is slower but returns the complete description and all structured fields.

***

### Known limitations

- Salary is only returned when the employer publishes it — many listings carry `null` salary fields.
- Region, postcode, latitude, longitude, industry, employment type, expiry date and description require `fetchDetails: true`.
- `contractLength` is only populated for contract and temporary roles; permanent roles return `null`.
- Listings can be removed by the source at any time, so a small share of URLs may expire shortly after scraping.

***

### Technical details

- **Source:** cv-library.co.uk — United Kingdom job listings
- **Push notifications:** get new results delivered to Telegram, Discord, Slack, WhatsApp or any webhook the moment a scheduled run finds them
- **Method:** HTTP-only, no proxy required; structured data parsed from each listing's JSON-LD
- **Coverage:** everything the public search exposes, filterable via the input parameters above
- **Retry:** automatic retry on network errors with exponential backoff
- **No personal data:** the scraper never returns recruiter names, personal emails or personal phone numbers

***

### Rate this actor

If this scraper does its job, a short review on the **Reviews** tab helps other users find it. Something not working? Open an issue on the **Issues** tab instead — issues get fixed.

***

### Need a custom scraper?

**[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free.

If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio.

**Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl)

# Actor input Schema

## `searchQuery` (type: `string`):

Job title, keywords, or skills to search for on CV-Library. Leave empty to browse all jobs. Example: "software developer".

## `location` (type: `string`):

City, town, postcode, or county to search within. Example: "London", "M1 1AA", "West Yorkshire".

## `distance` (type: `integer`):

Search radius around the location, in miles. Only applies when a location is set. Example: 15.

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

Maximum number of job listings to return. Example: 100.

## `fetchDetails` (type: `boolean`):

ON: opens each job page for the full description, salary breakdown, industry, employment type, geo-coordinates, region, postcode, expiry date and company logo. OFF: returns list-level fields only (faster, fewer requests).

## `contractType` (type: `string`):

Filter by contract type. Leave as "Any" for no filter.

## `daysOld` (type: `integer`):

Only return listings posted within this many days. CV-Library supports 1, 3, 7, or 14 days; other values are rounded up to the nearest band. Leave empty for no limit. Example: 7.

## `salaryFrom` (type: `integer`):

Only return jobs with an annual salary at or above this amount, in GBP. Example: 40000.

## `salaryTo` (type: `integer`):

Only return jobs with an annual salary at or below this amount, in GBP. Example: 80000.

## `skipReposts` (type: `boolean`):

Skip job IDs already returned in previous runs of this actor (90-day deduplication window). Useful for daily incremental feeds.

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

Optional list of CV-Library search-result URLs to scrape directly instead of building a search from the fields above. Use a browser to build the search on cv-library.co.uk, then paste the resulting URL here.

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

Optional. CV-Library is scraped from Apify's datacenter IPs without a proxy by default. Only set a proxy if you need one; residential GB IPs may be rate-limited by Cloudflare.

## `telegramToken` (type: `string`):

Bot token from @BotFather, e.g. '110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw'. Requires Telegram chat ID below.

## `telegramChatId` (type: `string`):

Chat or channel ID the bot posts to, e.g. '-1001234567890'. Get it from @userinfobot.

## `discordWebhookUrl` (type: `string`):

Discord channel webhook, e.g. 'https://discord.com/api/webhooks/%E2%80%A6'. Channel settings → Integrations → Webhooks.

## `slackWebhookUrl` (type: `string`):

Slack incoming webhook, e.g. 'https://hooks.slack.com/services/%E2%80%A6'.

## `whatsappPhoneNumberId` (type: `string`):

Meta Cloud API phone number ID, e.g. '106540352242922'. Requires access token and recipient below.

## `whatsappAccessToken` (type: `string`):

Meta Cloud API access token for the WhatsApp Business account.

## `whatsappTo` (type: `string`):

Recipient phone number in international format, e.g. '31612345678'.

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

Any HTTPS endpoint. Receives a JSON POST with site, query, result counts and the newest items, e.g. 'https://example.com/hooks/jobs'.

## `webhookHeaders` (type: `object`):

Optional extra HTTP headers for the webhook request, e.g. {"Authorization": "Bearer abc123"}.

## `notificationLimit` (type: `integer`):

Maximum number of results shown in a notification message. Default 10, cap 25.

## `notifyOnlyChanges` (type: `boolean`):

Only send a notification when the run found new or changed items. Applies when incremental tracking is active; full runs with results always notify.

## Actor input object example

```json
{
  "searchQuery": "software developer",
  "location": "London",
  "distance": 15,
  "maxResults": 100,
  "fetchDetails": true,
  "contractType": "permanent",
  "daysOld": 7,
  "salaryFrom": 40000,
  "salaryTo": 80000,
  "skipReposts": false,
  "startUrls": [],
  "proxyConfiguration": {},
  "notificationLimit": 10,
  "notifyOnlyChanges": 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 = {
    "searchQuery": "developer",
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("unfenced-group/cv-library-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 = {
    "searchQuery": "developer",
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("unfenced-group/cv-library-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 '{
  "searchQuery": "developer",
  "maxResults": 100
}' |
apify call unfenced-group/cv-library-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,unfenced-group/cv-library-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/HhpEA2sjjkVdJ8YDi/builds/yH6KIrE6km4o2uTRE/openapi.json