{ "openapi": "3.0.1", "info": { "title": "USAJOBS Scraper - US Federal Government Jobs (usajobs.gov)", "description": "Extract US federal government job postings from USAJOBS (usajobs.gov) without an API key. Filter by keyword, location, radius, remote, GS grade, series, hiring path (public, veterans, students), agency and date, and get salary, grade, duties, qualifications, security clearance and apply URL as clea…", "version": "1.0", "x-build-id": "bgk9TBmUWjxggKX2T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/asiajobs~usajobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-asiajobs-usajobs-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/asiajobs~usajobs-scraper/runs": { "post": { "operationId": "runs-sync-asiajobs-usajobs-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/asiajobs~usajobs-scraper/run-sync": { "post": { "operationId": "run-sync-asiajobs-usajobs-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": { "keyword": { "title": "Search keyword", "type": "string", "description": "Search federal jobs by keyword, job title or announcement number, e.g. 'analyst', 'nurse', 'IT specialist'. Leave empty to list all open jobs." }, "location": { "title": "Location", "type": "string", "description": "City and state as USAJOBS writes it, e.g. 'Denver, Colorado' or 'Washington, District of Columbia'. A state alone ('Texas') or a country ('Germany') also works." }, "radius": { "title": "Radius (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Search radius around the location in miles (e.g. 25, 50, 100). Only used with a city location." }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Return only fully remote jobs (\"Anywhere in the U.S.\").", "default": false }, "gradeMin": { "title": "Minimum grade", "minimum": 1, "maximum": 15, "type": "integer", "description": "Lowest pay grade (1-15), e.g. 9 for GS-9. Matches the site's Pay or Experience filter." }, "gradeMax": { "title": "Maximum grade", "minimum": 1, "maximum": 15, "type": "integer", "description": "Highest pay grade (1-15), e.g. 13 for GS-13." }, "minSalary": { "title": "Minimum salary (USD per year)", "minimum": 0, "type": "integer", "description": "Only jobs whose salary range reaches at least this amount per year." }, "series": { "title": "Occupational series codes", "type": "array", "description": "4-digit occupation/series codes, e.g. 2210 (IT Management), 0343 (Management and Program Analysis), 0610 (Nurse), 1102 (Contracting).", "default": [], "items": { "type": "string" } }, "hiringPaths": { "title": "Hiring paths (who can apply)", "type": "array", "description": "Only jobs open to these groups. Leave empty for all.", "items": { "type": "string", "enum": [ "public", "vet", "mspouse", "nguard", "student", "graduates", "fed-competitive", "fed-excepted", "fed-internal-search", "fed-transition", "land", "ses", "disability", "overseas", "native", "peace", "special-authorities" ], "enumTitles": [ "Open to the public", "Veterans", "Military spouses", "National Guard & reserves", "Students", "Recent graduates", "Federal employees - competitive service", "Federal employees - excepted service", "Internal to an agency", "Career transition (CTAP, ICTAP, RPL)", "Land & base management", "Senior executives", "Individuals with disabilities", "Family of overseas employees", "Native Americans", "Peace Corps & AmeriCorps Vista", "Special authorities" ] }, "default": [] }, "agency": { "title": "Agency codes", "type": "array", "description": "USAJOBS agency codes (the a= value in a usajobs.gov search URL), e.g. VATA (Veterans Health Administration), ARCE (Army Corps of Engineers), HSBD (Customs and Border Protection).", "default": [], "items": { "type": "string" } }, "department": { "title": "Department codes", "type": "array", "description": "USAJOBS department codes (the d= value in a search URL), e.g. VA (Veterans Affairs), AR (Army), AF (Air Force), DD (Defense), HS (Homeland Security), TR (Treasury).", "default": [], "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only jobs that opened in the last N days (results are then sorted newest first)." }, "sort": { "title": "Sort", "enum": [ "", "startdate", "enddate", "salary" ], "type": "string", "description": "Sort order of the results.", "default": "" }, "includeDetails": { "title": "Include full job details", "type": "boolean", "description": "Open each job announcement for the full salary range, duties, qualifications, education, security clearance, telework/remote, all locations and more. Turn off for a faster, lighter list.", "default": true }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. USAJOBS works best WITHOUT a proxy (the default); only enable one if you see blocked (403) requests.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }