{ "openapi": "3.0.1", "info": { "title": "Jobs.ac.uk Academic Jobs Scraper", "description": "Scrape jobs.ac.uk - the UK's leading academic & higher-education job board. Search by keyword/location, browse by discipline, filter by contract type, hours, salary band, workplace and sector, or fetch specific job URLs.", "version": "1.0", "x-build-id": "NieeLKIlw8lcRHgAu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~jobs-ac-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-jobs-ac-uk-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/crawlerbros~jobs-ac-uk-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-jobs-ac-uk-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/crawlerbros~jobs-ac-uk-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-jobs-ac-uk-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrls" ], "type": "string", "description": "What to fetch.", "default": "search" }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text search terms (job title, skill, employer name). Leave empty to browse by discipline/filters only." }, "location": { "title": "Location", "type": "string", "description": "UK town/city, region, or country text to filter jobs by (e.g. `London`, `Manchester`, `Scotland`). Matched as a case-insensitive substring against each job's advertised location - jobs.ac.uk's own distance-radius search requires a browser-only autocomplete widget with no free server-side equivalent, so this is a text match rather than a precise mile radius." }, "locationFacet": { "title": "Location region/country filter (exact match)", "type": "string", "description": "A single jobs.ac.uk location facet, as a real working server-side filter (unlike `location`/`distanceMiles` above). Use a continent (`Europe`), country (`United Kingdom`, `Ireland`, `United States`), UK nation (`England`, `Scotland`, `Wales`, `Northern Ireland`) or UK county/city-region (`Greater London`, `Oxfordshire`, `Greater Manchester`, `Cambridgeshire`, etc.) - free text is auto-slugified (e.g. `Greater London` -> `greater-london`). Only ONE value is honored meaningfully: jobs.ac.uk ANDs multiple location facets together, and since a job only has one location, combining two different regions always yields 0 results - so pass a single region per run. An unrecognized value simply yields 0 results rather than erroring." }, "distanceMiles": { "title": "Search radius (miles) - advisory only", "minimum": 0, "maximum": 250, "type": "integer", "description": "Sent to jobs.ac.uk alongside `location`, but the site only honors a mile-radius when `location` was resolved through its browser-side autocomplete widget (not available to a server-side scraper), so this has no effect on which jobs are returned. Kept for forward-compatibility only; use a broader/narrower `location` string to widen or narrow results instead.", "default": 0 }, "sortOrder": { "title": "Sort by", "enum": [ "relevance", "datePlaced", "closingDate" ], "type": "string", "description": "Result ordering.", "default": "relevance" }, "academicDisciplines": { "title": "Academic disciplines", "type": "array", "description": "Filter to one or more academic subject areas.", "items": { "type": "string", "enum": [ "agriculture-food-and-veterinary", "architecture-building-and-planning", "biological-sciences", "business-and-management-studies", "computer-sciences", "creative-arts-and-design", "economics", "education-studies-inc-tefl", "engineering-and-technology", "health-and-medical", "historical-and-philosophical-studies", "information-management-and-librarianship", "languages-literature-and-culture", "law", "mathematics-and-statistics", "media-and-communications", "physical-and-environmental-sciences", "politics-and-government", "psychology", "social-sciences-and-social-care", "sport-and-leisure" ], "enumTitles": [ "Agriculture, Food & Veterinary", "Architecture, Building & Planning", "Biological Sciences", "Business & Management Studies", "Computer Sciences", "Creative Arts & Design", "Economics", "Education Studies (inc. TEFL)", "Engineering & Technology", "Health & Medical", "Historical & Philosophical Studies", "Information Management & Librarianship", "Languages, Literature & Culture", "Law", "Mathematics & Statistics", "Media & Communications", "Physical & Environmental Sciences", "Politics & Government", "Psychology", "Social Sciences & Social Care", "Sport & Leisure" ] }, "default": [] }, "academicSubDisciplines": { "title": "Academic sub-disciplines", "type": "array", "description": "Filter to one or more narrower academic sub-fields (e.g. Cyber Security within Computer Sciences). Independent of `academicDisciplines` -- can be used alone or combined.", "items": { "type": "string", "enum": [ "agriculture", "food-science", "forestry", "veterinary-science", "architecture-and-building", "urban-and-rural-planning", "biochemistry", "biology", "botany", "genetics", "microbiology", "molecular-biology-and-biophysics", "other-biological-sciences", "zoology", "accountancy-and-finance", "business-studies", "hospitality-and-leisure", "human-resources-management", "management", "marketing", "other-business-and-management-studies", "real-estate-management", "artificial-intelligence", "computer-science", "cyber-security", "information-systems", "software-engineering", "design", "fine-art", "music", "other-creative-arts", "performing-arts", "education-studies-education", "research-methods", "teacher-training", "tefl-tesol", "aerospace-engineering", "biotechnology", "chemical-engineering", "civil-engineering", "electrical-and-electronic-engineering", "maritime-technology", "mechanical-engineering", "metallurgy-and-minerals-technology", "other-engineering", "production-engineering-and-manufacturing", "anatomy-physiology-and-pathology", "medical-technology", "medicine-and-dentistry", "nursing", "nutrition", "pharmacology-toxicology-and-pharmacy", "archaeology", "history", "history-of-art", "philosophy", "theology-and-religious-studies", "curatorial-studies", "information-science", "librarianship", "other-information-management-and-librarianship", "classics", "cultural-studies", "languages", "linguistics", "literature", "mathematics", "statistics", "communication-studies", "journalism", "media-studies", "publishing", "chemistry", "environmental-sciences", "geography", "geology", "materials-science", "ocean-sciences", "other-physical-sciences", "physics-and-astronomy", "anthropology", "human-and-social-geography", "other-social-sciences", "social-policy", "social-work", "sociology", "sports-and-leisure-management", "sports-coaching", "sports-science" ], "enumTitles": [ "Agriculture", "Food Science", "Forestry", "Veterinary Science", "Architecture & Building", "Urban & Rural Planning", "Biochemistry", "Biology", "Botany", "Genetics", "Microbiology", "Molecular Biology & Biophysics", "Other Biological Sciences", "Zoology", "Accountancy & Finance", "Business Studies", "Hospitality & Leisure", "Human Resources Management", "Management", "Marketing", "Other Business & Management Studies", "Real Estate Management", "Artificial Intelligence", "Computer Science", "Cyber Security", "Information Systems", "Software Engineering", "Design", "Fine Art", "Music", "Other Creative Arts", "Performing Arts", "Education Studies", "Research Methods", "Teacher Training", "TEFL/TESOL", "Aerospace Engineering", "Biotechnology", "Chemical Engineering", "Civil Engineering", "Electrical & Electronic Engineering", "Maritime Technology", "Mechanical Engineering", "Metallurgy & Minerals Technology", "Other Engineering", "Production Engineering & Manufacturing", "Anatomy, Physiology & Pathology", "Medical Technology", "Medicine & Dentistry", "Nursing", "Nutrition", "Pharmacology, Toxicology & Pharmacy", "Archaeology", "History", "History of Art", "Philosophy", "Theology & Religious Studies", "Curatorial Studies", "Information Science", "Librarianship", "Other Information Management & Librarianship", "Classics", "Cultural Studies", "Languages", "Linguistics", "Literature", "Mathematics", "Statistics", "Communication Studies", "Journalism", "Media Studies", "Publishing", "Chemistry", "Environmental Sciences", "Geography", "Geology", "Materials Science", "Ocean Sciences", "Other Physical Sciences", "Physics & Astronomy", "Anthropology", "Human & Social Geography", "Other Social Sciences", "Social Policy", "Social Work", "Sociology", "Sports & Leisure Management", "Sports Coaching", "Sports Science" ] }, "default": [] }, "nonAcademicDisciplines": { "title": "Professional / non-academic disciplines", "type": "array", "description": "Filter to one or more professional-services job families (HE administration, IT, HR, etc.).", "items": { "type": "string", "enum": [ "administrative", "estates-and-facilities-management", "finance-and-procurement", "fundraising-alumni-bids-and-grants", "health-wellbeing-and-care", "hospitality-retail-conferences-and-events", "human-resources", "international-activities", "it-services", "laboratory-clinical-and-technician", "legal-compliance-and-policy", "library-services-data-and-information-management", "pr-marketing-sales-and-communication", "project-management-and-consulting", "senior-management", "sports-and-leisure", "student-services", "sustainability", "web-design-and-development", "other" ], "enumTitles": [ "Administrative", "Estates & Facilities Management", "Finance & Procurement", "Fundraising, Alumni, Bids & Grants", "Health, Wellbeing & Care", "Hospitality, Retail, Conferences & Events", "Human Resources", "International Activities", "IT Services", "Laboratory, Clinical & Technician", "Legal, Compliance & Policy", "Library Services, Data & Information Management", "PR, Marketing, Sales & Communication", "Project Management & Consulting", "Senior Management", "Sports & Leisure", "Student Services", "Sustainability", "Web Design & Development", "Other" ] }, "default": [] }, "jobTypes": { "title": "Postgraduate study type", "type": "array", "description": "Restrict to Masters or PhD study opportunities instead of staff jobs.", "items": { "type": "string", "enum": [ "masters", "phds" ], "enumTitles": [ "Masters", "PhDs" ] }, "default": [] }, "hoursTypes": { "title": "Hours", "type": "array", "description": "Filter by working hours.", "items": { "type": "string", "enum": [ "full-time", "part-time" ], "enumTitles": [ "Full time", "Part time" ] }, "default": [] }, "contractTypes": { "title": "Contract type", "type": "array", "description": "Filter by contract type.", "items": { "type": "string", "enum": [ "permanent", "fixed-term-contract", "temporary" ], "enumTitles": [ "Permanent", "Fixed-term contract", "Temporary" ] }, "default": [] }, "workplaceTypes": { "title": "Workplace", "type": "array", "description": "Filter by remote/hybrid/on-site working arrangement.", "items": { "type": "string", "enum": [ "hybrid", "remote", "on-site" ], "enumTitles": [ "Hybrid", "Remote", "On-site" ] }, "default": [] }, "salaryBands": { "title": "Salary band", "type": "array", "description": "Filter by advertised annual salary band (GBP).", "items": { "type": "string", "enum": [ "up-to-9999", "10000-14999", "15000-19999", "20000-24999", "25000-29999", "30000-39999", "40000-49999", "50000-59999", "60000-69999", "70000-79999", "80000-89999", "90000-99999", "over-100000" ], "enumTitles": [ "Up to £9,999", "£10,000 - £14,999", "£15,000 - £19,999", "£20,000 - £24,999", "£25,000 - £29,999", "£30,000 - £39,999", "£40,000 - £49,999", "£50,000 - £59,999", "£60,000 - £69,999", "£70,000 - £79,999", "£80,000 - £89,999", "£90,000 - £99,999", "Over £100,000" ] }, "default": [] }, "employerSectors": { "title": "Employer sector", "type": "array", "description": "Filter by type of hiring organisation.", "items": { "type": "string", "enum": [ "charity-not-for-profit", "commercial-organisations", "further-education", "public-sector", "science-and-research-organisations", "universities-higher-education-institutions" ], "enumTitles": [ "Charity / not-for-profit", "Commercial organisations", "Further education", "Public sector", "Science & research organisations", "Universities / higher education institutions" ] }, "default": [] }, "qualificationTypes": { "title": "PhD qualification type", "type": "array", "description": "For postgraduate study listings: restrict by qualification type.", "items": { "type": "string", "enum": [ "integrated-masters-doctorate", "international-doctorate", "phd", "professional-doctorate" ], "enumTitles": [ "Integrated Masters + Doctorate", "International Doctorate", "PhD", "Professional Doctorate" ] }, "default": [] }, "fundingTypes": { "title": "PhD funding type", "type": "array", "description": "For postgraduate study listings: restrict by funding eligibility.", "items": { "type": "string", "enum": [ "eu-students", "international-students", "self-funded-students", "uk-students" ], "enumTitles": [ "EU students", "International students", "Self-funded students", "UK students" ] }, "default": [] }, "jobUrls": { "title": "Job URLs (mode=byUrls)", "type": "array", "description": "Direct jobs.ac.uk job posting URLs to fetch, e.g. `https://www.jobs.ac.uk/job/DSI921/senior-statistical-analyst`.", "default": [], "items": { "type": "string" } }, "fetchFullDescription": { "title": "Fetch full job description", "type": "boolean", "description": "Visit each job's detail page to include the full description, structured salary, employment type and closing date. Slower but much richer output. Always on for mode=byUrls.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 25 } } }, "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 } } }, "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 } } } } } } } } } }