{
  "openapi": "3.0.1",
  "info": {
    "title": "CV-Library Jobs Scraper - UK Jobs, Salaries & Recruiters",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "zY4aZL9pk2hYy8veY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~cv-library-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-cv-library-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/scrapersdelight~cv-library-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-cv-library-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/scrapersdelight~cv-library-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-cv-library-jobs-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "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).",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "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).",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "CV-Library URLs or job ids",
            "type": "array",
            "description": "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\").",
            "items": {
              "type": "string"
            }
          },
          "distance": {
            "title": "Distance (miles)",
            "minimum": 0,
            "maximum": 750,
            "type": "integer",
            "description": "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.",
            "default": 15
          },
          "radiusKm": {
            "title": "Distance (km)",
            "minimum": 0,
            "maximum": 1200,
            "type": "integer",
            "description": "Radius in kilometres instead of miles (rounded up to whole miles). 0 = use the miles above.",
            "default": 0
          },
          "jobTypes": {
            "title": "Job types",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only these contract types. Empty = all types.",
            "items": {
              "type": "string",
              "enum": [
                "permanent",
                "contract",
                "temporary",
                "part time"
              ],
              "enumTitles": [
                "Permanent",
                "Contract",
                "Temporary",
                "Part time"
              ]
            }
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "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).",
            "default": 0
          },
          "salaryMin": {
            "title": "Minimum salary (GBP)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "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.",
            "default": 0
          },
          "salaryMax": {
            "title": "Maximum salary (GBP)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Highest pay, in the pay period below. 0 = no maximum.",
            "default": 0
          },
          "salaryPeriod": {
            "title": "Salary period",
            "enum": [
              "annum",
              "day",
              "hour"
            ],
            "type": "string",
            "description": "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.",
            "default": "annum"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "salary_desc",
              "salary_asc",
              "distance"
            ],
            "type": "string",
            "description": "Order of the results, as on CV-Library. Distance needs a location.",
            "default": "relevance"
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Keep only jobs CV-Library flags as remote working.",
            "default": false
          },
          "advertiserTypes": {
            "title": "Advertiser types",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only jobs from these advertisers, e.g. direct employers without agencies. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "Direct Employer",
                "Recruitment Agency",
                "Corporate",
                "Advertising Agency"
              ],
              "enumTitles": [
                "Direct employer",
                "Recruitment agency",
                "Corporate",
                "Advertising agency"
              ]
            }
          },
          "titleKeywords": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only jobs whose title contains at least one of these words (case-insensitive), e.g. \"senior\", \"lead\".",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Drop jobs whose title, company or snippet contains any of these, e.g. \"trainee\", \"commission only\".",
            "items": {
              "type": "string"
            }
          },
          "maxApplications": {
            "title": "Max applications",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Keep only jobs with at most this many applications so far, e.g. 10 for low competition. 0 = no limit.",
            "default": 0
          },
          "includeExternalListings": {
            "title": "Include jobs from other sites",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "skipReposts": {
            "title": "Skip reposts",
            "type": "boolean",
            "description": "Skip a job when CV-Library's repost signature matches one already delivered in this run (or, in monitor mode, in an earlier run).",
            "default": false
          },
          "includeDetails": {
            "title": "Include job details",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description format",
            "enum": [
              "all",
              "text",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "Which description fields to fill when details are on: all three, or one of plain text, HTML or Markdown.",
            "default": "all"
          },
          "descriptionMaxLength": {
            "title": "Description max length",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Cut descriptions to this many characters (for LLM prompts or smaller exports). 0 = full length.",
            "default": 0
          },
          "monitorMode": {
            "title": "Monitor mode",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "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": {
            "title": "Include unchanged jobs",
            "type": "boolean",
            "description": "Monitor mode: also deliver jobs seen before and unchanged (changeType UNCHANGED).",
            "default": false
          },
          "emitExpired": {
            "title": "Report expired jobs",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "notifyOnlyChanges": {
            "title": "Notify only on changes",
            "type": "boolean",
            "description": "Monitor mode: send alerts only for NEW, UPDATED and REAPPEARED jobs, and nothing when there are none.",
            "default": false
          },
          "notificationLimit": {
            "title": "Jobs per alert",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "How many jobs each alert lists (the rest are counted).",
            "default": 5
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Post a summary of the delivered jobs to Slack (incoming webhook URL)."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Post a summary to a Discord channel webhook."
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Send a summary through your Telegram bot (with the chat id below)."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "Chat or channel id for the Telegram summary, e.g. \"-1001234567890\"."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp access token",
            "type": "string",
            "description": "WhatsApp Cloud API access token (with the phone number id and recipient below)."
          },
          "whatsappPhoneNumberId": {
            "title": "WhatsApp phone number id",
            "type": "string",
            "description": "Your WhatsApp Cloud API sender phone number id."
          },
          "whatsappTo": {
            "title": "WhatsApp recipient",
            "type": "string",
            "description": "Recipient number in international format, e.g. \"447700900123\"."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST a JSON summary (counts, run and dataset links, first jobs) to any URL."
          },
          "webhookHeaders": {
            "title": "Webhook headers",
            "type": "object",
            "description": "Extra HTTP headers for the webhook, e.g. {\"Authorization\": \"Bearer …\"}."
          },
          "maxResults": {
            "title": "Max jobs",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Most jobs to deliver in this run, across all searches. CV-Library shows at most 10,000 jobs per search. 0 = no limit.",
            "default": 100
          },
          "maxResultsPerSearch": {
            "title": "Max jobs per search",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Most jobs from any one search (keyword x location x category, or URL). 0 = no limit.",
            "default": 0
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Stop each search after this many result pages (up to 250 jobs a page). 0 = no limit.",
            "default": 0
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (16), trimmed for AI agents, MCP and LLM pipelines.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Drop empty fields",
            "type": "boolean",
            "description": "Leave out null, empty-text and empty-list fields from each job.",
            "default": false
          },
          "includeRawData": {
            "title": "Include raw record",
            "type": "boolean",
            "description": "Add CV-Library's own record for each job in a \"raw\" field (search result or job object).",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Job pages read in parallel when details are on.",
            "default": 4
          },
          "minRequestIntervalSecs": {
            "title": "Min seconds between requests",
            "minimum": 0,
            "maximum": 30,
            "type": "number",
            "description": "Space out request starts by at least this many seconds, e.g. 0.25. 0 = no pacing.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "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.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}