{ "openapi": "3.0.1", "info": { "title": "US Federal Government Jobs Search", "description": "Search current US federal government job openings through the USAJOBS Search API. Filter by keyword, location, occupational series, pay grade, salary, remote work and posting date. One clean row per opening, without agency contacts or free-text descriptions. Needs your own free USAJOBS API key.", "version": "0.1", "x-build-id": "j9ceQfxU3ch1BxQA9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/iocodo~us-federal-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-iocodo-us-federal-jobs", "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/iocodo~us-federal-jobs/runs": { "post": { "operationId": "runs-sync-iocodo-us-federal-jobs", "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/iocodo~us-federal-jobs/run-sync": { "post": { "operationId": "run-sync-iocodo-us-federal-jobs", "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": { "apiKey": { "title": "USAJOBS API key", "type": "string", "description": "Your own USAJOBS API key. It is free: request it at https://developer.usajobs.gov/apirequest/ and USAJOBS e-mails it to you. The key is stored as a secret input and is never written to the results." }, "apiEmail": { "title": "E-mail registered with the key", "type": "string", "description": "The e-mail address you gave USAJOBS when you requested the key. USAJOBS asks for it with every request." }, "keywords": { "title": "Keywords", "type": "array", "description": "One per line. Each keyword is a separate search, and an opening found by several keywords is returned once. USAJOBS looks for the words anywhere in the announcement, synonyms included. Leave empty for one search without a keyword.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional. One per line, in the form USAJOBS uses: city, then state name, for example Atlanta, Georgia or Washington DC, District of Columbia. All locations are searched together. Leave empty for the whole country and abroad.", "items": { "type": "string" } }, "radiusMiles": { "title": "Radius around the locations (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Optional. Also include openings within this many miles of each location. Needs at least one location." }, "jobCategoryCodes": { "title": "Occupational series", "type": "array", "description": "Optional. Four-digit OPM series codes, one per line, for example 2210 (information technology management) or 0830 (mechanical engineering). Keep the leading zero.", "items": { "type": "string" } }, "payGradeLow": { "title": "Lowest pay grade", "minimum": 1, "maximum": 15, "type": "integer", "description": "Optional. Beginning grade of the jobs to find, 1 to 15. Grades follow the General Schedule; USAJOBS derives a grade from the salary for other pay plans." }, "payGradeHigh": { "title": "Highest pay grade", "minimum": 1, "maximum": 15, "type": "integer", "description": "Optional. Ending grade of the jobs to find, 1 to 15. Use it together with the lowest grade to set a range." }, "minSalary": { "title": "Minimum salary (USD)", "minimum": 0, "type": "integer", "description": "Optional. USAJOBS works in salary bands of 25,000 dollars and applies the minimum from the start of its band, so 60,000 starts at 50,000." }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "When on, only openings that USAJOBS marks as remote are returned.", "default": false }, "teleworkOnly": { "title": "Telework eligible only", "type": "boolean", "description": "When on, only openings marked telework eligible are kept. USAJOBS has no search filter for this, so the Actor reads more pages to fill the limit. Remote jobs are not always marked telework eligible.", "default": false }, "postedWithinDays": { "title": "Posted within the last days", "minimum": 0, "maximum": 60, "type": "integer", "description": "Optional. Only openings posted in the last 0 to 60 days. Use 1 on a daily schedule to get just the new openings." }, "whoMayApply": { "title": "Who may apply", "enum": [ "all", "public", "status" ], "type": "string", "description": "Which openings to search. USAJOBS gives most keys only the openings that are open to the public. The status option needs a key that USAJOBS has authorised for it.", "default": "all" }, "maxResults": { "title": "Maximum openings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit of openings returned in total, across all keywords. USAJOBS returns at most 10,000 rows for one search.", "default": 500 } } }, "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 } } } } } } } } } }