CV-Library UK Jobs Scraper

Search and export structured UK job listings from CV-Library. The Actor picks the access path automatically — you only supply the search filters.

How access is selected

The Actor tries data sources in order of reliability and falls back automatically:

1. Official Job Search API — used when the CV_LIBRARY_API_KEY secret is configured on the Actor. This is the most reliable path and is not affected by Cloudflare.
2. Public website (browser) — used when the API is unavailable or produced no results. It loads CV-Library's real search pages in a full Chromium browser with a realistic, consistent UK fingerprint, and rotates through proxies in this order:
   • CV_LIBRARY_PROXY_URL (your own proxy, if set) — http://USERNAME:PASSWORD@HOST:PORT (also https://, socks4://, socks5://)
   • Apify residential proxy, GB
   • Apify datacenter proxy (automatic pool)
   • no proxy

CV-Library sits behind Cloudflare bot management. Residential/ISP UK proxies are required for the browser path to load results — datacenter IPs are blocklisted and return an HTTP 403 "Blocked" page. The Actor retries blocked pages with fresh proxy sessions, waits out Cloudflare challenges, and stops with a clear diagnostic instead of fabricating records.

CV-Library states that Job Search API access is not provided as standard and requires a key from its Partner team. Request access through the CV-Library Job Search API documentation, then set the key as the CV_LIBRARY_API_KEY Actor secret. The key is never written to the dataset or SUMMARY.

Example input

{
  "query": "software engineer",
  "location": "Manchester",
  "distanceMiles": 25,
  "categories": ["it"],
  "postedWithinDays": 7,
  "sort": "date",
  "maxResults": 100,
  "includeFullDescription": true
}

Output

Each dataset item represents one job and includes its CV-Library ID, title, canonical URL, description, location, distance, salary, salary details, job types, posted/expiry dates, agency information, and source metadata. The default run exports up to 10 jobs so the standard automated health test completes within five minutes; set maxResults higher for larger searches. The SUMMARY key contains the access mode used, counts, warnings, total matches when provided, and a redacted search URL.

Pricing

This Actor uses pay-per-event pricing. The primary event is $0.003 per unique CV-Library job returned, and the recommended Actor-start event is $0.00005 per run. A result event is charged only after the normalized job is written to the dataset; no-match and validation runs do not incur result charges.

Usage	Result-event cost
1 job	$0.003
100 jobs	$0.30
1,000 jobs	$3.00

Important limitations

• The browser path cannot bypass CV-Library security controls, CAPTCHA, or access restrictions; residential proxies reduce but do not eliminate blocking.
• API results can vary based on CV-Library's current index and access rules.
• Use the service in accordance with CV-Library's API terms and applicable law. This Actor is read-only and does not apply to jobs.

Local development

npm install
npm run validate-schema
npm test

What data does CV-Library UK Jobs Scraper return?

Field	Type	Description
jobId	string	CV-Library job identifier.
title	string	Job title as returned by CV-Library.
jobUrl	string	Canonical CV-Library job listing URL.
applyUrl	string or null	Apply URL when requested or available.
description	string or null	Job description; may be null when not supplied by the API.
location	string or null	Location
distanceMiles	number or null	Distance (miles)
salary	string or null	Salary
salaryDetails	object or null	Salary details
jobTypes	array	Job types
postedAt	string or null	Posted at
expiryDate	string or null	Expiry date
agencyName	string or null	Agency
agencyType	string or null	Agency type
agencyUrl	string or null	Agency URL
logoUrl	string or null	Logo URL
applications	string or null	Applications
searchUrl	string	Redacted API search URL used for this result.
scrapedAt	string	Scraped at
source	string	Source

Use cases

• Build public prospect lists and qualify organizations or professionals before responsible outreach.
• Schedule repeatable collection and export results to downstream workflows.
• Run a one-off research job and export the structured result as JSON, CSV, Excel, XML, or RSS from Apify.
• Schedule the same input to monitor changes over time and send completed datasets to a webhook or integration.
• Feed schema-shaped records into a database, spreadsheet, BI tool, or AI workflow with the source URL retained for verification.

Run CV-Library UK Jobs Scraper with the Apify API

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/cv-library-uk-jobs-scraper').call({
  "query": "software engineer",
  "distanceMiles": 15,
  "sort": "date",
  "maxResults": 10,
  "includeFullDescription": true
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

You can also run the Actor from Apify Console, schedules, webhooks, the REST API, Make, Zapier, n8n, or the hosted Apify MCP server.

Responsible use

Use this Actor only for data you are authorized to access. Follow the target website's terms, robots and access policies, and applicable privacy, database, copyright, anti-spam, and data-protection laws. Do not use it to bypass authentication or other access controls, collect private data, harass people, or make high-impact decisions without independent verification.

Support

When reporting a problem, include the Actor run ID, a redacted input, the expected result, and a small public example URL when applicable. Do not post API tokens, cookies, credentials, or personal data in an issue.