{ "openapi": "3.0.1", "info": { "title": "GovernmentJobs Jobs Search Scraper", "description": "Scrape job listings from GovernmentJobs.com (NEOGOV platform), the leading US state, city, and county government job portal. Extract job titles, agencies, locations, salary ranges, job types, and application deadlines for public sector recruitment.", "version": "2.1", "x-build-id": "KdwNf4enaa2Muzgs7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jobsapi~governmentjobs-jobs-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jobsapi-governmentjobs-jobs-search-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/jobsapi~governmentjobs-jobs-search-scraper/runs": { "post": { "operationId": "runs-sync-jobsapi-governmentjobs-jobs-search-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/jobsapi~governmentjobs-jobs-search-scraper/run-sync": { "post": { "operationId": "run-sync-jobsapi-governmentjobs-jobs-search-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": { "mode": { "title": "Mode", "enum": [ "search", "searchMultiple", "single", "multiple", "startUrls", "jobUrls" ], "type": "string", "description": "Search, fetch one job, fetch multiple jobs, or process official start URLs.", "default": "search" }, "query": { "title": "Search keywords", "maxLength": 160, "type": "string", "description": "Keyword phrase used by the official GovernmentJobs listing search.", "default": "software engineer" }, "keyword": { "title": "Keyword alias", "maxLength": 160, "type": "string", "description": "Compatibility alias for query." }, "keywords": { "title": "Keywords alias", "maxLength": 160, "type": "string", "description": "Compatibility alias for query." }, "location": { "title": "Location", "maxLength": 120, "type": "string", "description": "Optional city, state, or ZIP location filter." }, "category": { "title": "Job category", "maxLength": 120, "type": "string", "description": "Optional GovernmentJobs category filter." }, "searchQueries": { "title": "Search queries", "maxItems": 20, "type": "array", "description": "Query objects for searchMultiple mode.", "items": { "type": "object", "additionalProperties": false, "required": [ "query" ], "properties": { "query": { "title": "Query", "description": "One non-empty GovernmentJobs search phrase.", "type": "string", "minLength": 1, "maxLength": 160 }, "location": { "title": "Query location", "description": "Optional location for this query.", "type": "string", "maxLength": 120 }, "category": { "title": "Query category", "description": "Optional category for this query.", "type": "string", "maxLength": 120 } } } }, "queries": { "title": "Queries alias", "maxItems": 20, "type": "array", "description": "Compatibility alias: comma-separated or JSON string-array search queries.", "items": { "type": "string", "minLength": 1, "maxLength": 160 } }, "startUrls": { "title": "Official start URLs", "maxItems": 100, "type": "array", "description": "Official GovernmentJobs /jobs listing URLs or numeric job-detail URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "title": "Official URL", "description": "An HTTPS GovernmentJobs.com /jobs listing or numeric detail URL.", "type": "string" } } } }, "startUrl": { "title": "Listing URL alias", "type": "string", "description": "One official GovernmentJobs.com /jobs listing URL." }, "jobUrl": { "title": "Single job URL", "type": "string", "description": "One official GovernmentJobs.com detail URL containing a numeric posting ID." }, "url": { "title": "Job URL alias", "type": "string", "description": "Compatibility alias for jobUrl." }, "jobUrls": { "title": "Multiple job URLs", "maxItems": 100, "type": "array", "description": "Official GovernmentJobs.com detail URLs containing numeric posting IDs.", "items": { "type": "string" } }, "urls": { "title": "URLs alias", "maxItems": 100, "type": "array", "description": "Compatibility alias for jobUrls.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum complete jobs", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum complete, detail-verified records to write.", "default": 3 }, "maxJobs": { "title": "Maximum jobs alias", "minimum": 1, "maximum": 100, "type": "integer", "description": "Compatibility alias for maxItems." }, "results_wanted": { "title": "Results alias", "minimum": 1, "maximum": 100, "type": "integer", "description": "Compatibility alias for maxItems." }, "maxCandidates": { "title": "Maximum candidates", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum unique listing candidates to enrich.", "default": 20 }, "maxPages": { "title": "Maximum listing pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "Bounded number of official listing pages per search.", "default": 1 }, "timeoutMs": { "title": "Request timeout", "minimum": 5000, "maximum": 120000, "type": "integer", "description": "Timeout for each official HTTPS request in milliseconds.", "default": 20000 }, "timeoutSecs": { "title": "Timeout alias", "minimum": 5, "maximum": 120, "type": "integer", "description": "Compatibility alias for timeoutMs in seconds." }, "maxRequests": { "title": "Maximum requests", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard cap on official listing and detail requests in one run.", "default": 30 }, "maxConcurrency": { "title": "Detail concurrency", "minimum": 1, "maximum": 6, "type": "integer", "description": "Maximum simultaneous official detail requests.", "default": 3 }, "concurrency": { "title": "Concurrency alias", "minimum": 1, "maximum": 6, "type": "integer", "description": "Compatibility alias for maxConcurrency." }, "retries": { "title": "Retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Bounded retries for transient official responses.", "default": 0 }, "includeRawData": { "title": "Include raw source payloads", "type": "boolean", "description": "Include original listing, JobPosting, sections, and application-link payloads.", "default": false }, "maxRequestRetries": { "title": "Retry alias", "minimum": 0, "maximum": 3, "type": "integer", "description": "Compatibility alias for retries." } } }, "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 } } } } } } } } } }