CV-Library UK Jobs Scraper - Salary & Contract Type

CV-Library UK Jobs Scraper

Scrape CV-Library UK job listings by keyword, location and distance, up to 10,000 jobs per search. Every job comes with its title, company, location with map coordinates, salary range and period, contract type, posted date, full description, job page and apply link. No login or API key. Export to CSV, JSON, Excel, or XML.

CV-Library's official API needs registration and rate-limits you. This Actor reads the same search data the CV-Library website uses, filtered exactly as on the site, and returns each job in one fixed schema. It is the fastest way to get UK job market data into your spreadsheet or database.

Who uses it	What they scrape CV-Library for
Market researchers	Which skills and job titles are in demand across UK regions this week
Recruitment agencies	Monitor competitor job postings and salary benchmarks
Job boards and aggregators	Build a live feed of CV-Library listings for your own site
Data analysts	Collect structured job data for labour market analysis
Job seekers	Track new openings matching their criteria without manual searching

What it does

This Actor searches CV-Library by keyword and location and returns each job as a flat row.

• 🔍 Keyword search: any job title, skill or company, like 'developer' or 'nurse'.
• 📍 Location and distance: a UK town, city, county or postcode, such as 'London', 'Leeds' or 'M1 1AE', within 1 to 100 miles. Leave it empty to search the whole UK.
• 🗂 Filters: contract type (permanent, contract, temporary) and sort order (relevance, newest first, distance).
• 📄 Full description: each job is opened to add the full description, the apply link and the contract length. Turn fetchDetails off for a faster run with the search snippet only.
• 💷 Structured salary: minimum, maximum, currency and period (hour, day, month, year), plus CV-Library's annualised figures.
• 📁 Multiple export formats: CSV, JSON, Excel, or XML.

Output fields

Field	Example
title	Scala Developer
company (also employer)	BrightBox Group
location, city, region, postalCode	England, Bunhill, London, null
latitude, longitude	51.5229834, -0.0933551
salaryText (also salary)	£450/day
salaryMin, salaryMax, salaryCurrency, salaryInterval	450, 450, GBP, day
salaryAnnualMin, salaryAnnualMax, hasSalary, salarySource	117321.3, 117321.3, Yes, board-structured
employmentType (also contractType), contractLength	Contract, 3 months
isRemote, workArrangement	Yes, Remote
datePosted	2026-09-23T16:08:09.000Z
jobUrl (also url, sourceUrl), applyUrl, applyMethod	https://www.cv-library.co.uk/job/225642251/scala-developer
descriptionText, descriptionHtml, descriptionSnippet	Full text of the advert
jobId, uid, requisitionId	225642251, cv-library:225642251, BH-4652
companyId, companyLogo (also imageUrl), advertiserType	297886, logo URL, Direct Employer
category, applications, isFeatured, listingType	[IT, Development], 3, No, direct
source, sourceType, ats, country, countryCode, schemaVersion, scrapedAt	cv-library, job-board, null, United Kingdom, GB, jobs-1

Fields that CV-Library does not show for a job are null, for example the salary when the advertiser hides it. The row follows the shared ParseForge jobs schema (jobs-1), so it lines up with our other jobs Actors.

What you can do with CV-Library data

📈 Track UK job market trends.

A market researcher runs the Actor weekly for 'data scientist' across major UK cities and charts salary and demand changes.

🏢 Monitor competitor postings.

A recruitment agency scrapes CV-Library for their niche and compares their own listings against competitor salaries and locations.

🌐 Build a job aggregator.

A developer feeds CV-Library listings into their own job board, refreshing daily to keep listings current.

📊 Analyse regional demand.

A policy analyst collects all 'nurse' jobs by postcode area to map healthcare staffing shortages.

Why choose this scraper

	What you get
No API key	Reads the public search data without registration or OAuth
Fixed schema	Every job returns the same fields, ready for analysis
UK focus	Built for CV-Library, one of the UK's largest job boards
Fair billing	Only real job rows are charged. Error rows are free

How it compares

This Actor focuses on CV-Library only, with a simple keyword and location interface, while the competitors below either cover multiple job boards or add advanced features like incremental tracking.

Feature	ParseForge	Jobs Board Scraper: Indeed, Reed, Adzuna, RemoteOK & More	CV-Library [💰$1.5] - UK job listings	CV-Library Jobs Scraper
Scrapes CV-Library	Yes	Yes	Yes	Yes
Keyword, location and distance filters	Yes	Yes	Not listed	Not listed
Returns salary	Yes, min, max and period	Yes	Yes	Yes
Returns apply URL	Yes	Yes	Not listed	Yes
Incremental tracking of new and changed jobs	Not listed	Not listed	Yes	Not listed
Scrapes multiple job boards	Not listed	Yes	Not listed	Not listed

Configure the run

Set a keyword, a location, or both, and a maximum number of listings. The Input tab lists every parameter.

A first run with the defaults:

{
 "query": "developer",
 "location": "london",
 "maxItems": 10
}

Newest permanent nursing jobs within 10 miles of a Manchester postcode:

{
 "query": "nurse",
 "location": "M1 1AE",
 "radius": 10,
 "contractType": "permanent",
 "sortBy": "date",
 "maxItems": 200
}

Input	Default	What it does
query	developer	Keyword. Empty lists every job in the location
location	london	UK town, city, county or postcode. Empty searches the whole UK
radius	15	Miles around the location
contractType	any	any, permanent, contract or temporary
sortBy	relevance	relevance, date (newest first) or distance
includeExternalListings	false	Adds the jobs CV-Library pulls in from company career sites, which its main results list hides
fetchDetails	true	Full description, apply link and contract length
maxItems	10	Up to 10,000 per search, which is CV-Library's own limit

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 10,000 results per search.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the CV-Library UK Jobs Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to CV-Library through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/cv-library-uk-jobs-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check the keyword and the location. CV-Library only knows UK places. Try a broader keyword, a larger radius, or leave the location empty. When nothing matches, the dataset gets one row with an error message, and that row is not charged.

The run stops before reaching maxItems.

It stops when CV-Library has no more jobs for the search. CV-Library returns at most 10,000 jobs for one search, so split a larger pull by location or keyword.

Some jobs have no salary.

Many advertisers hide the salary. The salary fields are then null and hasSalary is "No".

I see an error row about HTTP 403.

CV-Library blocks many IP addresses. The Actor rotates proxy sessions and moves to UK residential IPs on its own when the default proxy is blocked. If a run still fails, run it again, or set the proxy to RESIDENTIAL with country GB. Error rows are never charged.

FAQ

Question	Answer
Do I need a CV-Library API key?	No. The Actor reads the same public search data as the CV-Library website.
What data does each job include?	Title, company, location with coordinates, salary range and period, contract type, posted date, full description, job page and apply link. See Output fields above.
Can I filter by both keyword and location?	Yes. Set a keyword, a location, or both. With both empty, the Actor returns jobs across the UK.
How many jobs can I scrape in one run?	Up to 10,000 per search, which is the most CV-Library returns for one query.
What output formats are supported?	CSV, JSON, Excel, or XML, straight from the Apify dataset.
Is this legal?	Review CV-Library's terms of service and make sure your use complies with them and with applicable laws. The Actor only accesses publicly available data.
Can I schedule this Actor to run automatically?	Yes. Set up a schedule in Apify to run it daily or weekly, sorted by newest first.
Does it handle pagination?	Yes. It pages through the results 100 at a time until it reaches maxItems or the end of the results.
Am I charged for failed runs?	Every run pays the platform start fee. Job rows are charged, error rows are not.
Can I scrape a specific job URL?	Not yet. The Actor works from a keyword and location search.

Next step

Each row carries the fields that these ParseForge jobs Actors take as input:

• The same search on Indeed. Put title into searchQuery of Indeed Jobs Scraper with country set to GB. You get 44 fields per job, including the full description, salary range and employer size.
• Every open role at that employer, from its own ATS. Take employer, find the company's careers page (Workday, Greenhouse, Lever, iCIMS, Ashby and 16 more ATS are supported) and paste it into careerSiteUrls of Career Site Jobs Scraper. It returns everything the employer lists on its own site, including roles never posted on CV-Library, with salary and a geocoded location.
• Company rating and salary estimate. Put employer into companyName of Glassdoor Jobs Scraper to get that employer's Glassdoor rating, salary estimates and its other open roles.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by CV-Library Ltd. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.