{ "openapi": "3.0.1", "info": { "title": "HigherEdJobs Scraper: Academic & University Listings", "description": "Scrape academic and faculty job postings on HigherEdJobs.com. Get university salary ranges, disciplines, and complete descriptions directly in Excel or Google Sheets. Skip tedious manual institution lists or expensive job board feeds. $1.90 per 1,000 results.", "version": "0.1", "x-build-id": "o3R3hOiabfX3ypCI6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~higheredjobs-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-higheredjobs-com-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/getascraper~higheredjobs-com-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-higheredjobs-com-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/getascraper~higheredjobs-com-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-higheredjobs-com-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional direct category, search, or detailed job page URLs to scrape. If provided, it overrides custom search filters.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keyword": { "title": "Search Keyword", "type": "string", "description": "Search keyword for position titles, departments, or disciplines (e.g. 'computer science', 'dean', 'physics')." }, "category": { "title": "Academic Category", "enum": [ "all", "1", "2", "3" ], "type": "string", "description": "Filter by broad job category (Faculty, Administrative, or Executive positions).", "default": "all" }, "institutionType": { "title": "Institution Type", "enum": [ "all", "1", "2", "3" ], "type": "string", "description": "Filter by university or college type (Public, Private, or 2-Year Community Colleges).", "default": "all" }, "positionType": { "title": "Position Type", "enum": [ "all", "1", "2" ], "type": "string", "description": "Filter by Full-Time or Part-Time status.", "default": "all" }, "remoteOnly": { "title": "Remote Only", "type": "boolean", "description": "If enabled, only listings offering remote work options are included.", "default": false }, "includeDescription": { "title": "Include Full Description", "type": "boolean", "description": "Whether to include full job descriptions (HTML & plain-text). Slower but richer data.", "default": false }, "dateWithinDays": { "title": "Date Within Days", "minimum": 0, "type": "integer", "description": "Only include academic jobs posted within the last N days (0 = any time).", "default": 0 }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of job postings to scrape in total.", "default": 10 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "type": "integer", "description": "Maximum number of parallel requests.", "default": 8 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "type": "integer", "description": "Number of times a request will be retried if it fails.", "default": 3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Detail pages are protected by Imperva WAF and require Apify Proxy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }