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)

{
  "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:

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

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

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

Scrape a specific search-results URL:

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

Daily feed (run on a schedule):

{
  "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 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