# CV-Library Jobs Scraper - UK Jobs, Salaries & Recruiters (`scrapersdelight/cv-library-jobs-scraper`) Actor

Scrape CV-Library UK jobs: title, employer or agency, location with coordinates, salary with annual figures, contract type, posted date, applications, apply link, plus full description, recruiter name and phone and company contacts. Filters, job URLs, monitor mode and alerts. No login.

- **URL**: https://apify.com/scrapersdelight/cv-library-jobs-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Jobs, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.80 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does CV-Library Jobs Scraper do?

**CV-Library Jobs Scraper** exports jobs from [CV-Library](https://www.cv-library.co.uk), one of the UK's largest job boards, into a clean table: one row per job with the title, employer or recruitment agency, location with coordinates and distance, salary with CV-Library's annualised figures, contract type, posted date, application count and the apply link. Turn on job details to add the full description, closing date, the recruiter's name and phone number, and the advertiser's website, phone, email and address. Recruiters, job-market analysts, HR-tech teams and lead-generation agencies use it to track who is hiring, where, and at what pay.

*CV-Library scraper · CV-Library jobs API · cv-library.co.uk job export*

- 🔎 **Search like the site does:** keywords x UK locations x categories, with radius, job type, posted-within, salary band and sort order applied by CV-Library itself.
- 📋 **Or paste URLs:** CV-Library search pages (their filters are kept), company job lists, job pages or bare job ids.
- 💷 **Salary you can sort on:** the text as the card shows it, min/max in the advertised period, and CV-Library's own annualised figures for hourly and day-rate jobs.
- 📞 **Recruiter and company contacts:** contact name and phone from the ad, plus website, phone, email and address from the advertiser's CV-Library profile (details on, same price).
- 🏢 **Direct employer or agency:** every row says which, and you can keep only one kind.
- 🔁 **Monitor mode:** only NEW, UPDATED and REAPPEARED jobs on scheduled runs, optional EXPIRED rows, repost detection, and alerts to Slack, Discord, Telegram, WhatsApp or any webhook.
- 🤖 **Compact output** for AI agents and MCP, plus a raw-record option for full fidelity.
- ✅ **No login, no cookies, no API key.**

### What data can you get from CV-Library?

| | | |
|---|---|---|
| 🆔 Job id and URL | 💼 Title | 🏢 Company (`company`, `companyId`) |
| 🧭 Advertiser type (direct employer / agency) | 📍 Location, city, county, region | 🗺️ Latitude and longitude |
| 📏 Distance in miles and km | 🌍 Other locations of the same ad | 💷 Salary text, min, max, period |
| 📈 Annual salary min/max | 📝 Contract type(s) | 🏠 Remote flag |
| ⭐ Featured / premium flags | 👥 Applications so far | ⏳ Low applications / closing soon |
| ⚡ Easy Apply | 🔗 External apply URL + ATS vendor | 🏷️ Categories and category paths |
| 🎯 CV-Library match score | 📅 Posted date, closing date | 📄 Description (text, HTML, Markdown) |
| ☎️ Recruiter name and phone | 🌐 Company website, phone, email, address | 🔁 Monitor change type, first/last seen |

### How to scrape CV-Library with CV-Library Jobs Scraper

1. [Sign up for a free Apify account](https://console.apify.com/sign-up) (the free plan includes monthly credit).
2. Open **CV-Library Jobs Scraper** and click **Try for free**.
3. Type one or more keywords (e.g. `developer`), add UK locations or categories if you want, or paste CV-Library URLs.
4. Set filters and **Max jobs**, and switch on **Include job details** if you need descriptions and contacts.
5. Click **Start**. The prefilled search (`developer`, 20 jobs) finishes in a few seconds.
6. Download the jobs as JSON, CSV, Excel or HTML, or read them through the API.

### ⬇️ Input

| Section | Parameter | Type | Description |
|---|---|---|---|
| What to scrape | `keywords` | array | Job titles or skills, one search each. Empty = every job. Prefilled `["developer"]`. |
| | `locations` | array | UK towns, cities, counties or postcodes. Each keyword runs in each location. |
| | `categories` | array | CV-Library categories, e.g. `it`, `healthcare`, `work from home`. One search each. |
| | `startUrls` | array | Search URLs, company job lists, job URLs or job ids. |
| Filters (applied by CV-Library) | `distance` | integer | Radius in miles, 0-750. Default **15**. |
| | `radiusKm` | integer | Radius in km instead (overrides miles). Default 0. |
| | `jobTypes` | array | permanent, contract, temporary, part time. |
| | `postedWithinDays` | integer | Posted in the last N days. Default 0 (any). |
| | `salaryMin` / `salaryMax` / `salaryPeriod` | integer / string | Pay range per year, day or hour. |
| | `sortBy` | string | relevance, newest, salary high-low / low-high, distance. |
| Refine (before any charge) | `remoteOnly`, `advertiserTypes`, `titleKeywords`, `excludeKeywords`, `maxApplications`, `includeExternalListings`, `skipReposts` | | Filters the run applies itself. Filtered jobs are never charged. |
| Extra data | `includeDetails` | boolean | Job-page fields (description, contacts, closing date…). Same price. Default false. |
| | `descriptionFormat`, `descriptionMaxLength` | | all / text / html / markdown; length cap. |
| Monitoring | `monitorMode`, `monitorStoreName`, `includeUnchanged`, `emitExpired` | | Only new or changed jobs between runs. |
| | `notifyOnlyChanges`, `notificationLimit`, Slack / Discord / Telegram / WhatsApp / webhook fields | | Alerts after the run. |
| Output | `maxResults` | integer | Most jobs per run. Default **100** (prefilled 20). 0 = no limit. |
| | `maxResultsPerSearch`, `maxPagesPerSearch` | integer | Caps per search. |
| | `compact`, `excludeEmptyFields`, `includeRawData` | boolean | Output shape. |
| Advanced | `maxConcurrency`, `minRequestIntervalSecs`, `proxyConfiguration` | | Defaults work; no proxy needed. |

#### Input JSON

```json
{
    "keywords": ["registered nurse", "care assistant"],
    "locations": ["Leeds", "Manchester"],
    "distance": 10,
    "jobTypes": ["permanent"],
    "postedWithinDays": 7,
    "includeDetails": true,
    "maxResults": 300
}
```

#### Use places CV-Library knows

Locations are matched by CV-Library itself. A town, city, county or postcode district works (`Leeds`, `Greater London`, `M1`). If the site does not recognise a place, it silently searches the whole UK instead; this actor detects that, delivers nothing for that search and says so in the run summary, so you never get UK-wide rows labelled as one town. The same goes for a category slug the site does not know.

#### Split very large searches

CV-Library shows at most 10,000 jobs for one search. "all jobs" in the UK is about 86,000, "engineer" about 27,000. Add locations, categories or filters to reach the rest; the run summary warns when a search hits the cap.

### ⬆️ Output

One item per job. A real row from a verified run (`accountant`, details on), shortened:

```json
{
    "jobId": "225686667",
    "url": "https://www.cv-library.co.uk/job/225686667/accountant",
    "title": "Accountant",
    "company": "Baltic Recruitment Services Ltd",
    "advertiserType": "Recruitment Agency",
    "location": "Ilkley, West Yorkshire",
    "latitude": 53.9257254,
    "longitude": -1.824441,
    "contractType": "Permanent",
    "applications": 22,
    "easyApply": true,
    "categories": ["Accountancy & Accounting", "Accountant"],
    "matchScore": 92,
    "postedAt": "2026-10-05T12:59:06Z",
    "expiryDate": "2026-11-04T12:59:06.000Z",
    "contactName": "Siobhan Mitchinson",
    "contactPhone": "01325 808754",
    "companyWebsite": "http://www.balticrecruitment.co.uk/",
    "companyPhone": "01325 731 060",
    "companyEmail": "HQ@balticrecruitment.co.uk",
    "descriptionLength": 4180,
    "industry": "Accountancy & Accounting",
    "employmentType": "FULL_TIME"
}
```

#### Fields and how often they are filled

Measured on three local runs on 2026-10-14: **A** = `accountant`, 100 jobs with details; **B** = `manager` + `sales`, newest first, 240 jobs with details; **C** = `engineer`, 3,000 jobs without details. Distance needs a location: on `nurse` / `care assistant` in Leeds and Manchester it was filled on 84 of 90 jobs (every job with coordinates).

| Field | A | B | C | Notes |
|---|---|---|---|---|
| `jobId`, `url`, `title`, `company`, `location`, `contractType`, `postedAt`, `applyUrl` | 100% | 100% | 100% | |
| `advertiserType` | 100% | 97% | 99% | empty on jobs CV-Library lists from other sites |
| `latitude` / `longitude` | 92% | 95% | 92% | |
| `salaryText`, `salaryMin`, `salaryMax`, `annualSalaryMin/Max` | 82% | 67% | 79% | the rest publish no salary |
| `applications` | 100% | 96% | 99% | |
| `externalApplyUrl` | 18% | 41% | 16% | jobs that send you to the employer's own site |
| `postcode` | 65% | 60% | – | job page only |
| `description` (text, HTML, Markdown), `expiryDate`, `industry`, `employmentType` | 100% | 100% | – | details on |
| `contactName` | 99% | 96% | – | details on |
| `contactPhone` | 63% | 39% | – | details on, as the advertiser types it |
| `salaryAsAdvertised` | 82% | 67% | – | details on |
| `companyWebsite` | 85% | 85% | – | details on |
| `companyPhone` | 75% | 66% | – | details on |
| `companyAddress` | 84% | 80% | – | details on |
| `companyEmail` | 40% | 32% | – | details on |
| `salaryBenefits` | 23% | 26% | – | details on |
| `contractLength` | 17% | 13% | – | contracts and temporary jobs |
| `extractedUrls` / `extractedEmails` | 0% | 2% / 1% | – | CV-Library descriptions rarely carry links |

Every field is listed in the dataset schema; keys are always present (null when CV-Library does not publish the value) unless you turn on `excludeEmptyFields`.

### How can I use CV-Library job data?

- 🎯 **Recruitment agencies:** find direct employers hiring in your niche and town, with the hiring contact and company phone.
- 📊 **Labour-market analysts:** salary ranges by title, region and contract type, with annualised pay for day-rate and hourly roles.
- 🧲 **Lead generation:** companies with many live jobs (`companyJobsCount`) and their website, phone and email.
- 🔔 **Job alerts:** a daily monitor run that posts only new jobs to Slack or Teams through a webhook.
- 🧠 **AI and RAG pipelines:** compact rows or Markdown descriptions for LLM screening and matching.
- 🏷️ **ATS and HR-tech research:** which applicant-tracking systems employers use (`atsVendor`, `applyHost`).

### How much does it cost to scrape CV-Library?

CV-Library Jobs Scraper is priced per job: **$0.0018 per job**, job-page details included, no start fee.

| Jobs | Price |
|---|---|
| 10 | $0.018 |
| 100 | $0.18 |
| 1,000 | $1.80 |
| 10,000 | $18.00 |

Apify's free plan includes monthly credit, enough for thousands of jobs. Duplicates, filtered jobs, unchanged monitor jobs and jobs that vanished before their page was read are never charged, and a run that finds nothing costs nothing.

### Integrations, API, scheduling and MCP

Schedule the actor (daily with monitor mode is the usual set-up), send results to Google Sheets, Slack, Make, Zapier or n8n, or call it from your code with the [Apify API](https://apify.com/scrapersdelight/cv-library-jobs-scraper/api/python) (`apify-client` for Python and JavaScript). AI agents can run it through the [Apify MCP server](https://apify.com/scrapersdelight/cv-library-jobs-scraper/api/mcp).

### More UK job scrapers

- 💼 [Reed.co.uk Jobs Scraper](https://apify.com/scrapersdelight/reed-jobs-scraper) — use it for Reed listings and salaries.
- 🧾 [Totaljobs Scraper](https://apify.com/scrapersdelight/totaljobs-scraper) — Totaljobs listings with company and description.
- 💚 [CharityJob Scraper](https://apify.com/scrapersdelight/charityjob-uk-jobs-scraper) — charity and volunteering roles.
- 🎓 [jobs.ac.uk Academic Jobs Scraper](https://apify.com/scrapersdelight/jobs-ac-uk-academic-jobs-scraper) — university and research posts.

See all our actors on the [ScrapersDelight profile](https://apify.com/scrapersdelight).

### Limits and empty runs

- **10,000 jobs per search** is CV-Library's own cap; split by location, category or filter beyond it.
- **Speed:** a search page brings up to 250 jobs in one request, so 1,000 jobs take a few seconds; with details on, about 4 job pages a second (100 jobs with details ran in ~25 s).
- **Relevance paging repeats a few jobs** (33 repeats in 3,250 listed, 1%); each job is delivered and charged once.
- **Jobs from other sites:** CV-Library mixes in jobs it lists from other job boards and careers pages (ids start with `job.`): 0-3% of rows on national keyword searches, up to a quarter on some local ones (26 of 100 on permanent jobs in Leeds posted in the last 7 days). Turn off `includeExternalListings` to drop them.
- **Not available:** an experience-level filter (CV-Library has none), and CV-Library's separate career-page ("organic") feed, which its search pages exclude and only its internal API serves (that API refuses outside requests).
- **Empty runs:** an unknown keyword, place or category returns no rows and the reason is in the run summary (`RUN_SUMMARY` in the key-value store). Nothing is charged.

### ❓ FAQ

#### How much does CV-Library Jobs Scraper cost?

$0.0018 per job, details included, no start fee: 1,000 jobs cost $1.80. Filtered, duplicate and unchanged jobs are free.

#### How many jobs can CV-Library Jobs Scraper get?

Up to 10,000 per search (CV-Library's cap) and as many searches as you list. "All jobs" in the UK was about 86,000 on 2026-10-14.

#### Can CV-Library Jobs Scraper monitor new jobs on a schedule?

Yes. Turn on monitor mode and schedule the actor: each run delivers only jobs that are NEW since the last run, plus UPDATED and REAPPEARED ones, and optional EXPIRED rows confirmed on the job page. Reposts are flagged with `isRepost` and `repostOfId`.

#### Does CV-Library Jobs Scraper get recruiter phone numbers and emails?

With details on, it returns the contact name (96-99% of jobs) and phone (39-63%) the advertiser put on the ad, and the advertiser's website, phone, email and address from its CV-Library profile.

#### Can I filter CV-Library jobs by salary, contract type or date?

Yes: salary range per year, day or hour, permanent / contract / temporary / part time, posted within N days, distance from a place, category, remote only, advertiser type, title words and maximum applications.

#### Does CV-Library Jobs Scraper need a login, cookies or a CV-Library API key?

No. It reads the same public search and job pages any visitor sees.

#### Can I use CV-Library Jobs Scraper with the Apify API?

Yes, from any language through the Apify API, or with `apify-client` for Python and JavaScript. See the API tab.

#### Can AI agents use CV-Library Jobs Scraper through MCP?

Yes, through the Apify MCP server. Turn on `compact` for smaller rows.

#### Why did CV-Library Jobs Scraper return no results?

The keyword, place or category is unknown to CV-Library (see `RUN_SUMMARY`), or your refine filters removed every job. Try the search on cv-library.co.uk first.

#### Is it legal to scrape CV-Library?

The actor reads publicly available job ads. Review CV-Library's terms and make sure your use complies with applicable law, including the UK GDPR where personal data such as recruiter names is involved. This actor is not affiliated with CV-Library.

#### Your feedback

Found a bug or need a field? Open an issue on the [Issues tab](https://apify.com/scrapersdelight/cv-library-jobs-scraper/issues/open) and we will look at it quickly.

# Actor input Schema

## `keywords` (type: `array`):

Job titles, skills or keywords, one search each, e.g. "developer", "registered nurse", "HGV driver". Leave empty for every job (narrow with a location or category).

## `locations` (type: `array`):

UK towns, cities, counties or postcodes, e.g. "Leeds", "Greater London", "M1". Each keyword is searched in each location. A place CV-Library does not recognise is reported and returns nothing (never UK-wide results).

## `categories` (type: `array`):

CV-Library top-level categories, one search each, e.g. "it", "healthcare", "engineering", "sales", "education", "construction", "work from home". A category the site does not recognise is reported and returns nothing.

## `startUrls` (type: `array`):

Search pages (filters in the URL are kept, e.g. https://www.cv-library.co.uk/nurse-jobs-in-leeds?posted=7), company job lists (/list-jobs/…), job pages (/job/225642251/…) or bare job ids ("225642251").

## `distance` (type: `integer`):

Search radius around each location, in miles: any whole number from 0 (the place itself) to 750. CV-Library's own default is 15. Ignored without a location.

## `radiusKm` (type: `integer`):

Radius in kilometres instead of miles (rounded up to whole miles). 0 = use the miles above.

## `jobTypes` (type: `array`):

Keep only these contract types. Empty = all types.

## `postedWithinDays` (type: `integer`):

Only jobs posted (or refreshed) in the last N days, e.g. 1, 3, 7, 14. 0 = any date (CV-Library keeps jobs live for about 30 days).

## `salaryMin` (type: `integer`):

Lowest pay, in the pay period below, e.g. 40000 per year or 20 per hour. 0 = no minimum. CV-Library filters by its pay bands; the run then checks the exact figure.

## `salaryMax` (type: `integer`):

Highest pay, in the pay period below. 0 = no maximum.

## `salaryPeriod` (type: `string`):

The pay period of the salary filter. Per-year figures are compared against CV-Library's annualised salary, so hourly and daily jobs are included.

## `sortBy` (type: `string`):

Order of the results, as on CV-Library. Distance needs a location.

## `remoteOnly` (type: `boolean`):

Keep only jobs CV-Library flags as remote working.

## `advertiserTypes` (type: `array`):

Keep only jobs from these advertisers, e.g. direct employers without agencies. Empty = all.

## `titleKeywords` (type: `array`):

Keep only jobs whose title contains at least one of these words (case-insensitive), e.g. "senior", "lead".

## `excludeKeywords` (type: `array`):

Drop jobs whose title, company or snippet contains any of these, e.g. "trainee", "commission only".

## `maxApplications` (type: `integer`):

Keep only jobs with at most this many applications so far, e.g. 10 for low competition. 0 = no limit.

## `includeExternalListings` (type: `boolean`):

CV-Library mixes in jobs it lists from other job sites and careers pages (ids like "job.3KHg…"; applying goes to the source). Turn off to keep only jobs advertised on CV-Library itself.

## `skipReposts` (type: `boolean`):

Skip a job when CV-Library's repost signature matches one already delivered in this run (or, in monitor mode, in an earlier run).

## `includeDetails` (type: `boolean`):

Read each job's page: full description (text, HTML, Markdown), closing date, recruiter contact name and phone, salary as advertised, benefits, contract length, postcode, industry, and the advertiser's website, phone, email and address. Same price per job; slower.

## `descriptionFormat` (type: `string`):

Which description fields to fill when details are on: all three, or one of plain text, HTML or Markdown.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters (for LLM prompts or smaller exports). 0 = full length.

## `monitorMode` (type: `boolean`):

Deliver only jobs that are NEW since the last run with the same store, plus UPDATED (content changed) and REAPPEARED ones. With Include job details on, jobs an earlier run delivered without their details come back once with them, as DETAILS. Pairs with a daily schedule.

## `monitorStoreName` (type: `string`):

Named key-value store that remembers delivered jobs, e.g. "leeds-nurse-jobs". Use one name per tracked search set. Empty = "cv-library-monitor".

## `includeUnchanged` (type: `boolean`):

Monitor mode: also deliver jobs seen before and unchanged (changeType UNCHANGED).

## `emitExpired` (type: `boolean`):

Monitor mode: when a fully read search no longer lists a remembered job and its page confirms it expired, deliver it once with changeType EXPIRED.

## `notifyOnlyChanges` (type: `boolean`):

Monitor mode: send alerts only for NEW, UPDATED and REAPPEARED jobs, and nothing when there are none.

## `notificationLimit` (type: `integer`):

How many jobs each alert lists (the rest are counted).

## `slackWebhookUrl` (type: `string`):

Post a summary of the delivered jobs to Slack (incoming webhook URL).

## `discordWebhookUrl` (type: `string`):

Post a summary to a Discord channel webhook.

## `telegramBotToken` (type: `string`):

Send a summary through your Telegram bot (with the chat id below).

## `telegramChatId` (type: `string`):

Chat or channel id for the Telegram summary, e.g. "-1001234567890".

## `whatsappAccessToken` (type: `string`):

WhatsApp Cloud API access token (with the phone number id and recipient below).

## `whatsappPhoneNumberId` (type: `string`):

Your WhatsApp Cloud API sender phone number id.

## `whatsappTo` (type: `string`):

Recipient number in international format, e.g. "447700900123".

## `webhookUrl` (type: `string`):

POST a JSON summary (counts, run and dataset links, first jobs) to any URL.

## `webhookHeaders` (type: `object`):

Extra HTTP headers for the webhook, e.g. {"Authorization": "Bearer …"}.

## `maxResults` (type: `integer`):

Most jobs to deliver in this run, across all searches. CV-Library shows at most 10,000 jobs per search. 0 = no limit.

## `maxResultsPerSearch` (type: `integer`):

Most jobs from any one search (keyword x location x category, or URL). 0 = no limit.

## `maxPagesPerSearch` (type: `integer`):

Stop each search after this many result pages (up to 250 jobs a page). 0 = no limit.

## `compact` (type: `boolean`):

Core fields only (16), trimmed for AI agents, MCP and LLM pipelines.

## `excludeEmptyFields` (type: `boolean`):

Leave out null, empty-text and empty-list fields from each job.

## `includeRawData` (type: `boolean`):

Add CV-Library's own record for each job in a "raw" field (search result or job object).

## `maxConcurrency` (type: `integer`):

Job pages read in parallel when details are on.

## `minRequestIntervalSecs` (type: `number`):

Space out request starts by at least this many seconds, e.g. 0.25. 0 = no pacing.

## `proxyConfiguration` (type: `object`):

Optional. The run reaches CV-Library without a proxy and switches by itself if it is refused. Add your own proxy URLs to use them first.

## Actor input object example

```json
{
  "keywords": [
    "developer"
  ],
  "distance": 15,
  "radiusKm": 0,
  "postedWithinDays": 0,
  "salaryMin": 0,
  "salaryMax": 0,
  "salaryPeriod": "annum",
  "sortBy": "relevance",
  "remoteOnly": false,
  "maxApplications": 0,
  "includeExternalListings": true,
  "skipReposts": false,
  "includeDetails": false,
  "descriptionFormat": "all",
  "descriptionMaxLength": 0,
  "monitorMode": false,
  "includeUnchanged": false,
  "emitExpired": false,
  "notifyOnlyChanges": false,
  "notificationLimit": 5,
  "maxResults": 20,
  "maxResultsPerSearch": 0,
  "maxPagesPerSearch": 0,
  "compact": false,
  "excludeEmptyFields": false,
  "includeRawData": false,
  "maxConcurrency": 4,
  "minRequestIntervalSecs": 0,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per CV-Library job.

## `summary` (type: `string`):

Per-search totals and status, filtered, duplicate and unchanged counts, job pages read, routes used.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "developer"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/cv-library-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["developer"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/cv-library-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "developer"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scrapersdelight/cv-library-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/cv-library-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yexUqDhixTVh9ROdB/builds/zY4aZL9pk2hYy8veY/openapi.json
