CV-Library Jobs Scraper

Pull live UK job postings from CV-Library at scale — titles, companies, locations, salaries, job types, posted dates, and full descriptions, with every salary parsed into structured min, max, currency, and pay period. Search by keyword and location or paste CV-Library URLs, and get a clean dataset of 20 fields per job. Built for recruiters, job-market analysts, and lead-generation teams who need fresh UK hiring data without copy-pasting listings one page at a time.

Why This Scraper?

• Parsed salary, not just raw text — every job ships the original salary string plus a structured salaryMin, salaryMax, salaryCurrency, and salaryPeriod (annum, day, hour, week, or month), so you can sort, filter, and average without writing your own parser.
• 20 structured fields per job — including job ID, company name, company profile URL, company logo, location, ISO posted date, direct apply link, and the source search URL each result came from.
• Description in both plain text and HTML — description for clean analysis and descriptionHtml to keep the original markup, on the same record.
• Multi-keyword search in one run — pass a whole list of job titles and each runs its own search, with a shared results budget across all of them.
• Four job-type filters — Permanent, Contract, Temporary, and Part-Time, applied to exactly CV-Library's real employment taxonomy.
• Salary band and remote-only filters — keep only jobs within a GBP minimum and maximum, or only roles that read as remote, hybrid, or work-from-home.
• Search radius from this-area-only up to 100 miles — eight named distance bands around any town, city, county, or postcode, plus a posted-since window (today, last 3, 7, or 14 days).
• Paste a CV-Library search URL or a single job URL — re-scrape one exact posting by its job link, or hand over a fully-filtered search page and the actor respects the filters baked into it.
• Automatic deduplication by job ID — the same listing shown across several pages or keyword searches is returned once, even when your searches overlap.

Use Cases

Recruitment & Talent Sourcing

• Build candidate-facing job feeds for a niche, location, or salary band
• Source live vacancies for a specialist desk across multiple job titles at once
• Track which companies are actively hiring for a given role
• Pull direct apply links to route candidates straight to the application

Market & Salary Research

• Benchmark salary ranges by role and region using parsed min/max values
• Measure hiring volume for a skill across UK cities and counties
• Compare permanent vs. contract vs. temporary demand over time
• Map remote and hybrid availability by job title

Lead Generation

• Build prospect lists of companies posting roles in your target market
• Capture hiring-company names and profile links for outreach
• Identify employers expanding in a specific town or postcode
• Spot agencies and direct employers recruiting for the same role

Competitor & Job-Board Monitoring

• Watch a competitor's open roles by company name
• Monitor newly posted jobs with the today / last-3-days window
• Track how long roles stay live by re-running a saved search
• Audit your own postings against the wider CV-Library market

Getting Started

Simple Keyword Search

Just a job title and a location:

{
    "keywords": ["software engineer"],
    "location": "London",
    "maxResults": 100
}

Keyword Search with Filters

Add a radius, a job type, a salary floor, and a posted-since window:

{
    "keywords": ["registered nurse", "healthcare assistant"],
    "location": "Manchester",
    "distance": "30",
    "jobType": ["permanent"],
    "salaryMin": 30000,
    "postedSince": "7",
    "maxResults": 250
}

Advanced — Paste CV-Library URLs

Mix a fully-filtered search page with a single job link to re-scrape one exact posting:

{
    "startUrls": [
        "https://www.cv-library.co.uk/software-engineer-jobs-in-london",
        "https://www.cv-library.co.uk/job/123456789/Senior-Software-Engineer"
    ],
    "includeDescription": true,
    "onlyUniqueJobs": true,
    "maxResults": 500
}

Input Reference

Search

Parameter	Type	Default	Description
keywords	string[]	["software engineer"]	Job titles, skills, or keywords to search for. Each keyword runs its own search. Leave empty if you only want to use URLs.
location	string	"London"	Town, city, county, or postcode to search around. Applied to every keyword search.
distance	select	Within 15 miles	Search radius around the location: This area only, or within 5, 10, 15, 20, 30, 50, or 100 miles.
startUrls	string[]	[]	Paste full CV-Library search or individual job URLs. Filters baked into a pasted search page are respected. Mix with keyword search.

Filters

Salary, job-type, and remote filters refine the jobs you receive after collection — they are not re-applied to jobs reached via a pasted URL.

Parameter	Type	Default	Description
jobType	select[]	[] (all)	Keep only these employment types: Permanent, Contract, Temporary, Part-Time.
salaryMin	integer	—	Keep only jobs offering at least this annual salary (GBP). Jobs with no stated salary are kept.
salaryMax	integer	—	Keep only jobs offering up to this annual salary (GBP). Jobs with no stated salary are kept.
postedSince	select	Any time	Only jobs posted within: Today, Last 3 days, Last 7 days, or Last 14 days.
remoteOnly	boolean	false	Keep only jobs that read as remote, hybrid, or work-from-home.

Output & Limits

Parameter	Type	Default	Description
includeDescription	boolean	true	Fetch the full job description plus detail-page metadata (apply link, exact posted date). Turn off for lighter, faster records.
onlyUniqueJobs	boolean	true	Return each job once even if it appears across several pages or searches. Deduplicates by job ID.
maxResults	integer	100	Cap on the total jobs returned across all searches and URLs. Use 0 for unlimited.

Output

Each job is one flat row. Here's a representative result with full descriptions enabled:

{
    "jobId": "123456789",
    "title": "Senior Software Engineer",
    "url": "https://www.cv-library.co.uk/job/123456789/Senior-Software-Engineer",
    "companyName": "Acme Recruitment Ltd",
    "companyUrl": "https://www.cv-library.co.uk/list-jobs/123456/Acme-Recruitment",
    "companyLogo": "https://www.cv-library.co.uk/logos/123456.png",
    "location": "London",
    "salary": "£60,000 - £75,000 per annum",
    "salaryMin": 60000,
    "salaryMax": 75000,
    "salaryCurrency": "GBP",
    "salaryPeriod": "annum",
    "jobType": "Permanent",
    "isRemote": true,
    "postedDate": "2026-06-15",
    "description": "We are looking for a Senior Software Engineer to join our growing team...",
    "descriptionHtml": "<p>We are looking for a Senior Software Engineer to join our growing team...</p>",
    "applyUrl": "https://www.cv-library.co.uk/job/apply/123456789",
    "searchUrl": "https://www.cv-library.co.uk/software-engineer-jobs-in-london",
    "scrapedAt": "2026-06-18T14:30:00Z"
}

Core Fields

Field	Type	Description
jobId	string	CV-Library job ID — used as the deduplication key.
title	string	Job title.
url	string	Canonical CV-Library job posting URL.
location	string	Job location as shown on CV-Library.
jobType	string	Employment type: Permanent, Contract, Temporary, or Part-Time.
isRemote	boolean	Whether the posting reads as remote, hybrid, or work-from-home.
postedDate	string	Posting date (ISO format where available).

Company

Field	Type	Description
companyName	string	Hiring company or recruiter name.
companyUrl	string	Link to the company's CV-Library profile, if present.
companyLogo	string	Company logo image URL, if present.

Salary

Field	Type	Description
salary	string	Raw salary text (e.g. "£60,000 - £75,000 per annum").
salaryMin	number	Parsed minimum salary.
salaryMax	number	Parsed maximum salary.
salaryCurrency	string	Parsed currency (typically GBP).
salaryPeriod	string	Parsed pay period: annum, day, hour, week, or month.

Description & Meta

Field	Type	Description
description	string	Plain-text job description (when descriptions are enabled).
descriptionHtml	string	Original HTML job description (when descriptions are enabled).
applyUrl	string	Direct apply link for the posting.
searchUrl	string	The search or start URL this job was found under (provenance).
scrapedAt	string	ISO-8601 timestamp the row was collected.

Tips for Best Results

• Start small to validate — set maxResults to 50 on your first run to confirm the data matches what you need, then scale up.
• Keep keywords specific — the salary, job-type, and remote filters are applied to the matched results rather than narrowed at the search, so a precise keyword like "registered nurse" returns cleaner results than a broad one like "nurse".
• Re-scrape one posting by its job URL — paste a single https://www.cv-library.co.uk/job/... link to pull exactly that job as one row, ideal for refreshing a saved listing.
• Turn off descriptions for fast bulk scans — set includeDescription to false when you only need titles, companies, locations, salaries, and links; turn it on for full text and apply links.
• Widen the radius on thin markets — outside major cities, a 30 or 50-mile radius pulls far more matches than this-area-only.
• Use a list of keywords for breadth — one run can cover several job titles at once and share a single results budget across them.
• Pasted search URLs carry their own filters — build a fully-filtered search on CV-Library, copy the URL into startUrls, and the actor honors exactly what you set on the site.

Pricing

From $4.00 per 1,000 results — undercuts comparable CV-Library actors on the market, and your salary, job-type, and remote filters are included at no extra cost. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.48	$0.45	$0.43	$0.40
1,000	$4.80	$4.50	$4.25	$4.00
10,000	$48.00	$45.00	$42.50	$40.00
100,000	$480.00	$450.00	$425.00	$400.00

A "result" is one job row in your output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate recruitment research, labour-market analysis, and lead generation using publicly available job postings. You are responsible for complying with applicable laws and CV-Library's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and handle any personal data in line with UK GDPR and other applicable data-protection regulations.