{ "openapi": "3.0.1", "info": { "title": "HigherEdJobs Scraper", "description": "Scrape HigherEdJobs.com - the largest US job board for faculty, administrative, and executive positions in higher education. Search by keyword, category, region, position type, and institution type, or fetch full job details by job ID.", "version": "1.0", "x-build-id": "YwPiNgPMep4mAGgu7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~higheredjobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-higheredjobs-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~higheredjobs-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-higheredjobs-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~higheredjobs-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-higheredjobs-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", "byJobId" ], "type": "string", "description": "What to fetch.", "default": "search" }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text search across job title, institution, and location (mode=search). Supports \"quoted phrases\"." }, "onlyTitle": { "title": "Search job titles only", "type": "boolean", "description": "Restrict the keyword search to job titles only, instead of title + institution + location.", "default": false }, "jobCategories": { "title": "Job categories", "type": "array", "description": "Filter to one or more HigherEdJobs job categories.", "items": { "type": "string", "enum": [ "141", "42", "14", "219", "15", "36", "212", "270", "271", "16", "272", "17", "213", "18", "22", "177", "37", "211", "163", "161", "175", "173", "159", "160", "162", "172", "21", "217", "23", "179", "35", "214", "205", "25", "274", "275", "276", "277", "278", "206", "279", "280", "281", "282", "148", "283", "27", "143", "29", "30", "31", "218", "32", "150", "33", "34", "220", "39", "24", "149", "174", "38", "215", "28", "40", "216", "273", "284", "41", "43", "1", "164", "243", "244", "245", "246", "247", "248", "249", "250", "251", "252", "253", "254", "4", "207", "50", "51", "52", "54", "140", "53", "123", "49", "57", "58", "45", "256", "285", "228", "255", "44", "183", "203", "144", "229", "46", "47", "286", "48", "130", "132", "152", "129", "131", "128", "133", "59", "62", "63", "64", "226", "68", "69", "166", "227", "72", "184", "73", "67", "180", "71", "75", "110", "111", "113", "114", "115", "116", "117", "146", "118", "120", "121", "126", "122", "260", "230", "197", "155", "201", "167", "124", "196", "125", "127", "262", "287", "151", "193", "259", "200", "288", "105", "289", "136", "185", "153", "263", "221", "208", "264", "138", "134", "77", "78", "156", "81", "82", "83", "76", "139", "199", "204", "88", "89", "90", "91", "209", "92", "222", "261", "169", "93", "202", "96", "157", "97", "265", "181", "137", "154", "223", "135", "210", "98", "99", "100", "101", "102", "290", "103", "170", "182", "104", "106", "107", "108", "190", "187", "292", "189", "224", "188", "266", "168", "195", "198", "225", "257", "258", "192", "267", "268", "191", "291", "74" ], "enumTitles": [ "Admin - Academic Advising", "Admin - Administrative Assistants", "Admin - Admissions and Enrollment", "Admin - Adult and Continuing Education Programs", "Admin - Alumni Relations", "Admin - Arts and Museum Administration", "Admin - Assessment, Accreditation, and Compliance", "Admin - Athletics - Athletic Administration", "Admin - Athletics - Athletic Trainers", "Admin - Athletics - Coaching", "Admin - Athletics - Recreation Services", "Admin - Broadcasting, Radio, and Television", "Admin - Bursar and Student Accounts", "Admin - Business and Financial Services", "Admin - Career Development and Services", "Admin - Child Care and Youth Programs", "Admin - Communications, Marketing, and Public Affairs", "Admin - Information Technology - Database Administrator", "Admin - Information Technology - IT Manager/Director", "Admin - Information Technology - IT Support and Training", "Admin - Information Technology - Multimedia and Audiovisual", "Admin - Information Technology - Network/System Administrator", "Admin - Information Technology - Software Engineer/Programmer", "Admin - Information Technology - Web Developer", "Admin - Information Technology - Other IT", "Admin - Conference and Events Administration", "Admin - Counseling and Psychological Services", "Admin - Curriculum Design", "Admin - Development and Fundraising", "Admin - Disability and Accessibility Services", "Admin - Diversity, Equity, and Inclusion Services", "Admin - Economic and Business Development", "Admin - Executive Assistants", "Admin - Extension and Outreach", "Admin - Facilities - Custodial and Housekeeping", "Admin - Facilities - Grounds and Landscaping", "Admin - Facilities - Mail and Print Services", "Admin - Facilities - Maintenance and Trades", "Admin - Facilities - Manager/Director", "Admin - Facilities - Occupational and Environmental Safety", "Admin - Facilities - Planning, Design, and Project Management", "Admin - Facilities - Sustainability", "Admin - Facilities - Transportation and Parking", "Admin - Facilities - Other", "Admin - Faculty Affairs", "Admin - Farming and Agriculture", "Admin - Financial Aid", "Admin - Food Services", "Admin - Health and Medical Services", "Admin - Human Resources", "Admin - Institutional Research and Planning", "Admin - Instructional Technology and Design", "Admin - International Programs and Services", "Admin - Laboratory and Research", "Admin - Legal Affairs", "Admin - Libraries", "Admin - Online and Distance Education Programs", "Admin - Police and Public Safety", "Admin - Publications and Editing", "Admin - Registrars", "Admin - Religious and Spiritual Life", "Admin - Residence Life and Housing", "Admin - Sales", "Admin - Sponsored Programs, Grants, and Contracts", "Admin - Student Affairs and Services", "Admin - Tutors and Learning Resources", "Admin - Veteran and Military Services", "Admin - Veterinary Services", "Admin - Volunteer Programs and Service Learning", "Admin - Other Administrative Positions", "Executive - Academic Vice Presidents and Provosts", "Executive - Administrative Vice Presidents", "Executive - Deans - Agriculture", "Executive - Deans - Business", "Executive - Deans - Communications", "Executive - Deans - Education", "Executive - Deans - Engineering", "Executive - Deans - Fine and Applied Arts", "Executive - Deans - Health Sciences", "Executive - Deans - Law", "Executive - Deans - Liberal Arts", "Executive - Deans - Medicine", "Executive - Deans - Science", "Executive - Deans - Other", "Executive - Presidents and Chancellors", "Executive - Other Executive", "Faculty - Agriculture - Agricultural Economics and Agribusiness", "Faculty - Agriculture - Animal Science", "Faculty - Agriculture - Entomology", "Faculty - Agriculture - Environmental Science, Ecology, and Forestry", "Faculty - Agriculture - Extension", "Faculty - Agriculture - Food Science", "Faculty - Agriculture - Horticulture and Landscape Architecture", "Faculty - Agriculture - Plant and Soil Science", "Faculty - Agriculture - Veterinary Medicine", "Faculty - Agriculture - Other", "Faculty - Business - Accounting", "Faculty - Business - Business Administration", "Faculty - Business - Business Analytics", "Faculty - Business - Business Law", "Faculty - Business - Entrepreneurship", "Faculty - Business - Finance", "Faculty - Business - Hospitality and Tourism", "Faculty - Business - Human Resources", "Faculty - Business - Information Systems and Technology", "Faculty - Business - International Business", "Faculty - Business - Management", "Faculty - Business - Marketing and Sales", "Faculty - Business - Real Estate", "Faculty - Business - Other Business", "Faculty - Communications - Broadcast Journalism", "Faculty - Communications - Journalism", "Faculty - Communications - Media and Communication Studies", "Faculty - Communications - Public Relations and Advertising", "Faculty - Communications - Radio, Television, and Film", "Faculty - Communications - Speech and Public Speaking", "Faculty - Communications - Other Communications", "Faculty - Education - Adult and Workforce Education Instructors", "Faculty - Education - Counselor Education", "Faculty - Education - Curriculum and Instruction", "Faculty - Education - Edu. Admin and Leadership (study of)", "Faculty - Education - Educational Psychology", "Faculty - Education - Higher Education (study of)", "Faculty - Education - Instructional Technology and Design", "Faculty - Education - Reading and Literacy", "Faculty - Education - School Psychology", "Faculty - Education - Special Education", "Faculty - Education - Teacher Education", "Faculty - Education - Teacher Education - Early Childhood", "Faculty - Education - Teacher Education - Elementary", "Faculty - Education - Teacher Education - Middle School", "Faculty - Education - Teacher Education - Secondary Education", "Faculty - Education - Other Education (study of)", "Faculty - Engineering - Aerospace", "Faculty - Engineering - Agricultural", "Faculty - Engineering - Biological and Biomedical Engineering", "Faculty - Engineering - Chemical", "Faculty - Engineering - Civil and Environmental", "Faculty - Engineering - Computer Engineering", "Faculty - Engineering - Electrical", "Faculty - Engineering - Industrial and Manufacturing", "Faculty - Engineering - Mechanical", "Faculty - Engineering - Other Engineering", "Faculty - Fine and Applied Arts - Architecture", "Faculty - Fine and Applied Arts - Art", "Faculty - Fine and Applied Arts - Art History", "Faculty - Fine and Applied Arts - Dance", "Faculty - Fine and Applied Arts - Digital Arts", "Faculty - Fine and Applied Arts - Fashion and Textile Design", "Faculty - Fine and Applied Arts - Graphic Design", "Faculty - Fine and Applied Arts - Industrial Design", "Faculty - Fine and Applied Arts - Interior Design", "Faculty - Fine and Applied Arts - Music", "Faculty - Fine and Applied Arts - Photography", "Faculty - Fine and Applied Arts - Theatre", "Faculty - Fine and Applied Arts - Other Fine and Applied Arts", "Faculty - Health Sciences - Athletic Training", "Faculty - Health Sciences - Biostatistics", "Faculty - Health Sciences - Communication Sciences and Disorders", "Faculty - Health Sciences - Health Education and Promotion", "Faculty - Health Sciences - Health Information Technology", "Faculty - Health Sciences - Healthcare Administration", "Faculty - Health Sciences - Human Anatomy and Physiology", "Faculty - Health Sciences - Kinesiology, Exercise Science, and Phys Ed", "Faculty - Health Sciences - Neuroscience", "Faculty - Health Sciences - Nursing", "Faculty - Health Sciences - Nutrition and Dietetics", "Faculty - Health Sciences - Occupational Therapy", "Faculty - Health Sciences - Physical Therapy", "Faculty - Health Sciences - Public and Environmental Health", "Faculty - Health Sciences - Recreation and Leisure Studies", "Faculty - Health Sciences - Sport Management", "Faculty - Health Sciences - Other Health Sciences", "Faculty - Law and Legal Studies", "Faculty - Liberal Arts - American Studies", "Faculty - Liberal Arts - Anthropology", "Faculty - Liberal Arts - Criminal Justice", "Faculty - Liberal Arts - Economics", "Faculty - Liberal Arts - English and Literature", "Faculty - Liberal Arts - English as Second Language", "Faculty - Liberal Arts - Ethnic and Multicultural Studies", "Faculty - Liberal Arts - History", "Faculty - Liberal Arts - Human Development and Family Studies", "Faculty - Liberal Arts - Humanities", "Faculty - Liberal Arts - Linguistics", "Faculty - Liberal Arts - Philosophy", "Faculty - Liberal Arts - Political Science", "Faculty - Liberal Arts - Psychology", "Faculty - Liberal Arts - Public Administration and Policy", "Faculty - Liberal Arts - Religious Studies and Theology", "Faculty - Liberal Arts - Security Studies", "Faculty - Liberal Arts - Sign Language", "Faculty - Liberal Arts - Social Work", "Faculty - Liberal Arts - Sociology", "Faculty - Liberal Arts - Urban Studies and Planning", "Faculty - Liberal Arts - Women's and Gender Studies", "Faculty - Liberal Arts - World Languages and Literatures", "Faculty - Liberal Arts - Other Liberal Arts", "Faculty - Medicine - Chiropractic", "Faculty - Medicine - Dentistry", "Faculty - Medicine - Medical Research", "Faculty - Medicine - Pharmacy and Pharmacology", "Faculty - Medicine - Physician Assistant", "Faculty - Medicine - Physicians", "Faculty - Medicine - Other Medicine", "Faculty - Science - Astronomy and Astrophysics", "Faculty - Science - Biochemistry and Molecular Biology", "Faculty - Science - Biology", "Faculty - Science - Chemistry", "Faculty - Science - Computer Science", "Faculty - Science - Data Science", "Faculty - Science - Geography", "Faculty - Science - Geology, Earth Sciences, and Oceanography", "Faculty - Science - Library and Information Science", "Faculty - Science - Mathematics", "Faculty - Science - Physics", "Faculty - Science - Statistics", "Faculty - Science - Other Science", "Faculty - Technical and Career - Automotive Tech and Heavy Equipment", "Faculty - Technical and Career - Aviation", "Faculty - Technical and Career - CDL and Driver Education", "Faculty - Technical and Career - Construction and Building Trades", "Faculty - Technical and Career - Cosmetology", "Faculty - Technical and Career - Culinary Arts", "Faculty - Technical and Career - Dental Hygienists and Assistants", "Faculty - Technical and Career - Diagnostic Imaging and Radiography", "Faculty - Technical and Career - Electronics and Electrical Trades", "Faculty - Technical and Career - Fire Science", "Faculty - Technical and Career - Massage Therapy", "Faculty - Technical and Career - Medical Assistants", "Faculty - Technical and Career - Medical Billing and Coding", "Faculty - Technical and Career - Paramedics and EMTs", "Faculty - Technical and Career - Respiratory Care", "Faculty - Technical and Career - Surgical Technology", "Faculty - Technical and Career - Telecommunications", "Faculty - Technical and Career - Welding", "Faculty - Technical and Career - Other Technical and Career" ] }, "default": [] }, "region": { "title": "Region", "enum": [ "", "1", "2", "11", "3", "4", "13", "6", "5", "7", "8", "12", "9", "10" ], "type": "string", "description": "Filter to a broad geographic region.", "default": "" }, "subRegions": { "title": "States / provinces", "type": "array", "description": "Filter to one or more specific states/provinces (works best combined with a matching Region).", "items": { "type": "string", "enum": [ "18", "51", "62", "52", "37", "19", "59", "60", "61", "63", "49", "50", "41", "1", "7", "8", "20", "21", "53", "54", "42", "25", "26", "30", "31", "13", "22", "2", "64", "55", "9", "3", "27", "32", "23", "33", "43", "34", "44", "65", "4", "10", "38", "11", "66", "75", "14", "35", "56", "67", "68", "69", "28", "39", "70", "47", "12", "71", "57", "72", "5", "73", "24", "36", "15", "40", "45", "6", "58", "16", "48", "17", "29", "46", "74" ], "enumTitles": [ "Alabama", "Alaska", "Alberta", "American Samoa", "Arizona", "Arkansas", "Armed Forces Americas", "Armed Forces Europe/Other", "Armed Forces Pacific", "British Columbia", "California, Northern", "California, Southern", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Guam", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Manitoba", "Marshall Islands", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Brunswick", "New Hampshire", "New Jersey", "New Mexico", "New York", "Newfoundland and Labrador", "Non US or Canada", "North Carolina", "North Dakota", "Northern Mariana Islands", "Northwest Territories", "Nova Scotia", "Nunavut", "Ohio", "Oklahoma", "Ontario", "Oregon", "Pennsylvania", "Prince Edward Island", "Puerto Rico", "Quebec", "Rhode Island", "Saskatchewan", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virgin Islands", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "Yukon" ] }, "default": [] }, "positionTypes": { "title": "Position type", "type": "array", "description": "Full-time and/or adjunct/part-time positions. Leave empty for both.", "items": { "type": "string", "enum": [ "1", "2" ], "enumTitles": [ "Full-Time", "Adjunct/Part-Time" ] }, "default": [] }, "institutionTypes": { "title": "Institution type", "type": "array", "description": "Type of hiring institution. Leave empty for all types.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "Four-Year/Advanced Degree (B.A., M.A., and/or Ph.D.)", "Two-Year/Community College (Associate Degree)", "Outside Higher Education" ] }, "default": [] }, "remoteTypes": { "title": "Location type", "type": "array", "description": "On-location and/or online/remote positions. Leave empty for both.", "items": { "type": "string", "enum": [ "1", "2" ], "enumTitles": [ "Location Bound", "Online/Remote" ] }, "default": [] }, "sortBy": { "title": "Sort by", "enum": [ "4", "1", "2", "3", "5", "6" ], "type": "string", "description": "Sort order for search results.", "default": "1" }, "priorityOnly": { "title": "Priority listings only", "type": "boolean", "description": "Only emit jobs the employer marked as a priority upgrade (mode=search).", "default": false }, "jobIds": { "title": "Job IDs (mode=byJobId)", "type": "array", "description": "HigherEdJobs numeric job codes, e.g. `179509399`. Found in the search results or in a job's URL as `JobCode=...`.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Datacenter proxy used only as a fallback if higheredjobs.com's anti-bot briefly rate-limits this Actor's IP. Free AUTO group; no residential proxy is used or needed.", "default": { "useApifyProxy": true } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records (mode=search).", "default": 50 } } }, "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 } } } } } } } } } }