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