CV-Library UK Jobs Scraper

Free-plan limit: Apify free-plan users receive at most 5 delivered records per run. Paid users may use the Actor’s configured result limit.

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. These are the current Apify Store event prices:

Event	Price (USD)	When it is charged
cv-library-job	$0.003	CV-Library job returned — Charged for each unique CV-Library job successfully written to the dataset.
apify-actor-start	$0.00005	Actor Start — Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). — Charged once per run.

Apify platform usage for this Actor run is included alongside the event prices above; no separate per-run platform-usage fee is passed to users.

This covers Apify platform usage for this Actor run. Other Apify products or usage outside this Actor run may still follow your account plan.

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