{ "openapi": "3.0.1", "info": { "title": "HigherEdJobs Scraper [$1.4/1KšŸ’°] | Academic Jobs | Faculty Data", "description": "Extract faculty, administrative and executive job postings from HigherEdJobs.com ā€” titles, institutions, locations, salaries, categories, deadlines, descriptions and apply links. Built for academic job-market research, salary benchmarking and higher-ed hiring intelligence. $1.40 per 1,000 jobs.", "version": "0.0", "x-build-id": "gDkhFAVa9aAERnuaP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~higheredjobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-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/ahmed_jasarevic~higheredjobs-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-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/ahmed_jasarevic~higheredjobs-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-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", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "HigherEdJobs pages to crawl - search results, category/region listings, or individual job detail pages. The default URL lists today's jobs, 100 per page. For a keyword search use e.g. https://www.higheredjobs.com/search/advanced_action.cfm?Keyword=professor&NumJobs=100", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxRequestsPerCrawl": { "title": "Max requests per crawl", "type": "integer", "description": "Maximum number of pages (listing + detail) the crawler may load. Every job detail page costs one request, so raise this when crawling many jobs.", "default": 200 }, "includeDetails": { "title": "Include job details", "type": "boolean", "description": "When enabled, each job listing is followed to its detail page to capture the full description, apply URL, deadline, and salary. Disable for a much faster listing-only crawl with the basic fields.", "default": true }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of job results to save to the dataset. If not set, no limit is applied.", "default": 10 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Number of pages downloaded in parallel. The crawler runs at this concurrency from the first request instead of slowly ramping up. Values between 10 and 50 are recommended for this site; lower it if you encounter errors or rate limiting.", "default": 25 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy setup for the crawler. HigherEdJobs challenges datacenter IP addresses with an anti-bot page, so the default is Apify Proxy with the UNBLOCKER group. Set useApifyProxy to false to connect directly (only works from residential IPs).", "properties": { "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Whether to route requests through Apify Proxy." }, "apifyProxyGroups": { "title": "Apify Proxy groups", "type": "array", "description": "Apify Proxy groups to rotate through. UNBLOCKER handles anti-bot challenges (recommended). RESIDENTIAL uses residential IP addresses as an alternative. DATACENTER is the cheapest but may be challenged and blocked.", "items": { "type": "string" } }, "apifyProxyCountry": { "title": "Apify Proxy country", "type": "string", "description": "Two-letter country code for the proxy IP address, e.g. US." }, "proxyUrls": { "title": "Custom proxy URLs", "type": "array", "description": "Custom proxy URLs to use instead of Apify Proxy, e.g. http://user:pass@host:port.", "items": { "type": "string" } } }, "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }