# US Government Jobs API (`aspen-technology-labs-inc/us-government-jobs-api`) Actor Find US government job postings from .gov and .mil source or employer domains by role, location, company, salary, posting age, employment type, remote status, and seniority. - **URL**: https://apify.com/aspen-technology-labs-inc/us-government-jobs-api.md - **Developed by:** [Aspen Technology Labs, Inc.](https://apify.com/aspen-technology-labs-inc) (community) - **Categories:** Jobs, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 job records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## US Government Jobs API - JobsIndex by Aspen Tech Labs Access US government job postings through the JobsIndex API, built by Aspen Tech Labs. This Actor searches jobs whose source URL or employer domain indicates a US government source, including `.gov` and `.mil` domains. The JobsIndex API, built by Aspen Tech Labs, collects over 70K government job postings in the US. Part of a broader index aggregating 11M+ active job listings daily from 300K+ employer source sites globally. The Actor is fixed internally to US public-sector jobs (including local government jobs). Users can narrow the dataset by role keywords, location, salary, company, posting age, employment type, remote status, seniority, and pagination fields. ### Need more or something different? If this actor is working well for you, we'd love a review. For more data, custom feeds, feedback, or any questions, reach out via our [website](https://jobsindex.com/) or [email](mailto:inquiry+apify@aspentechlabs.com). You can also explore [JobMarketPulse](https://jobmarketpulse.com/), our labor and job market intelligence platform. ### Built-In Search Preset This Actor always applies: ```text country = United States what = @(url_source,company_domain)(".gov" OR ".mil") ```` The user-facing `what` field does not replace that preset. Instead, if a user enters `what`, the Actor appends it to the internal government-jobs query. For example, user input: ```json { "what": "police", "region": "Virginia", "size": 5 } ``` is sent to the JobsIndex API as: ```json { "what": "@(url_source,company_domain)(\".gov\" OR \".mil\") AND @(title,title_raw,category,sub_category) (police)", "country": "United States", "region": "Virginia", "size": 5 } ``` If `what` is empty, the Actor sends only the internal government-jobs preset. ### Quick Start ```json { "what": "engineer", "region": "California", "size": 5 } ``` ### Input Parameters | Parameter | Description | Example | |---|---|---| | `salary` | Salary amount or range filter. | `20h-30h` | | `what` | Optional role/category search within US government jobs. The Actor appends this to the internal `.gov`/`.mil` source preset. | `police` | | `where` | Free-text location search. Prefer structured location fields for exact filters. | `Virginia` | | `country` | Fixed preset. Runtime always uses `United States`; changes are ignored. | `United States` | | `region` | State, province, or region. | `California` | | `city` | City filter. | `Sacramento` | | `postal_code` | Postal or ZIP code filter. | `95814` | | `metro_area` | Metropolitan area filter. | `Sacramento-Roseville-Folsom, CA` | | `title` | Job title filter. | `Police Officer` | | `company_name` | Public employer name filter. | `Town of Leesburg, VA` | | `company_domain` | Employer domain filter. | `leesburgva.gov` | | `category` | Job category filter. | `Security` | | `sub_category` | More specific job function or role group. | `Security Officer` | | `industry` | Company industry filter. | `Government` | | `posted` | Relative posting age or ISO date. Empty by default to cover the broader live public jobs index. | `1w` | | `employment_type` | Employment type. | `Full-Time` | | `remote` | Work arrangement filter. Supported values: `remote`, `on-site`, `hybrid`. | `on-site` | | `seniority` | Seniority level. | `Senior` | | `page` | Page number, starting from 0. | `0` | | `size` | Number of results per page. Default 5, min 1, max 100. | `5` | ### Search Behavior The internal government-jobs preset searches across: - `url_source` - `company_domain` When a user provides `what`, the Actor searches that value across: - `title` - `title_raw` - `category` - `sub_category` This keeps user search focused on the role or job family while preserving the government-jobs filter. Examples: ```text what = police what = nurse what = engineer what = software engineer OR data analyst ``` ### Advanced Filters `what` searches role and job-family terms across `title`, `title_raw`, `category`, and `sub_category`. It supports plain-text search and boolean logic. `where` supports plain-text location search, boolean logic, and field-targeted location search. Plain keyword examples: ```text what = police OR public health where = United States ``` For exact role or job metadata matching, use structured fields. For field-targeted location search, prefix the location query with `@field`: ```text title = budget analyst where = @country United States ``` To search a custom group of location fields, use `@(field1,field2) (query)`: ```text what = police OR emergency management where = @(country,region,city,metro_area,county,sub_city) (United States) where = @(city,region,metro_area) (Washington OR Virginia) where = @(city,region,metro_area) (Virginia) ``` #### Structured Filter Precedence The built-in government-jobs preset is always retained. When you use `what` or `where`, avoid sending separate structured filters for the same search unless you want those structured filters to take priority. - For `where`, location fields such as `country`, `region`, `city`, `postal_code`, and `metro_area` take priority and can override or narrow the free-text location query. The Actor always enforces `country = United States`. - For `what`, the Actor appends the user query to its internal `.gov`/`.mil` preset. Structured job filters such as `title`, `company_name`, `company_domain`, `category`, `sub_category`, `industry`, `posted`, `salary`, `employment_type`, `remote`, and `seniority` then take priority and can override or narrow the keyword query. For example, `sub_category = Registered Nurse` takes priority over `what = engineer`. Use `what` and `where` as free-text searches when their corresponding structured filters are not set. Use structured job fields to narrow the government-jobs preset: - `title`, `company_name`, `company_domain` - `category`, `sub_category`, `seniority`, `industry` - `employment_type`, `remote`, `posted`, `salary` - `id` Common location fields for `where`: - `country`, `region`, `city`, `metro_area`, `county`, `sub_city`, `postal_code` ### Location Filtering For precise location matching, use structured filters when possible: - `country` is always enforced as `United States` - `region` - `city` - `postal_code` - `metro_area` Use `where` as a free-text location search when structured location filters are not set. If `where` is provided together with structured location filters, the structured filters take priority and `where` may be ignored or narrowed. ### Limits and Pagination This Actor uses the JobsIndex jobs API. Results are paginated with `page` and `size`. | Parameter | Default | Min | Max | |---|---:|---:|---:| | `page` | 0 | 0 | Depends on `size` and the item cap | | `size` | 5 | 1 | 100 | Invalid `page` or `size` values can return `400 Invalid page or size parameters`. #### Item Caps The maximum number of retrievable jobs depends on the query shape: | Query shape | Max items | Effective max `size` | Over-size behavior | |---|---:|---:|---| | No company filter | 1000 | 100 | Validation error; not silently capped | | Company filter plus another keyword or filter | 20 | 20 | Silent cap with capping metadata | | Company filter only | 5 | 5 | Silent cap with capping metadata | When a company-filtered request asks for `size` greater than the effective cap, the API returns up to the capped number of results instead of erroring. The response metadata includes: - `size_requested` - the original requested `size` - `size_capped_by` - `"company"` for the 5-item cap or `"company|keywords"` for the 20-item cap On uncapped responses, `size_requested` and `size_capped_by` are not present. ### Output Each run stores job records in the default Apify dataset. The dataset schema includes an `Overview` table for the most useful fields and a `Raw data (all fields)` table for the complete JobsIndex record. Example dataset item: ```json { "id": "17494984349364375915", "title": "Police Officer", "company_name": "Town of Leesburg, VA", "company_domain": "leesburgva.gov", "category": "Security", "sub_category": "Security Officer", "country": "United States", "region": "Virginia", "city": "Leesburg", "employment_type": "Full-Time", "remote": "n/a", "posted": "2026-02-20", "url_source": "https://www.governmentjobs.com/careers/leesburgva/jobs/5231856" } ``` Field availability depends on the source job posting. # Actor input Schema ## `salary` (type: `string`): Salary amount/range filter. Format: 1-9 digits followed by y, m, w, d, or h; optional range A-B. Examples: 20h-30h, 35h, 20h-200000y. ## `what` (type: `string`): Optional job search query within US public-sector jobs. The Actor always applies an internal .gov/.mil source filter and appends this value to it. For best results, use role or category keywords such as police, nurse, engineer, analyst, or social worker. ## `where` (type: `string`): Free-text location search. Use only when structured location fields such as country, region, city, postal\_code, or metro\_area are not set; structured fields take priority. Maximum 700 raw URL chars or 500 decoded chars. ## `country` (type: `string`): Fixed preset for this Actor. The runtime always uses United States; changing this value in input is ignored. ## `region` (type: `string`): State, province, or region. Maximum 80 characters. ## `city` (type: `string`): City filter. Maximum 100 characters. ## `postal_code` (type: `string`): Postal or ZIP code. Maximum 20 characters. ## `metro_area` (type: `string`): Metropolitan area filter. Maximum 100 characters. Example: Denver-Aurora-Centennial, CO. ## `title` (type: `string`): Job title filter. Maximum 200 characters. ## `company_name` (type: `string`): Company name filter. Company filters reduce the retrievable item cap; see README. ## `company_domain` (type: `string`): Company website domain in valid DNS form, for example ibm.com. Company filters reduce the retrievable item cap; see README. ## `category` (type: `string`): Job category filter. This narrows the public-sector jobs dataset after the internal .gov/.mil source preset is applied. ## `sub_category` (type: `string`): More specific job function or role within a category. Maximum 100 characters. ## `industry` (type: `string`): Company industry. Maximum 100 characters. Example: Food Products or Hotels and Restaurants. ## `posted` (type: `string`): Relative posting age, such as 1h, 1d, 1w, 1m, or an ISO date: YYYY, YYYY-MM, YYYY-MM-DD. ## `employment_type` (type: `string`): Employment type, for example Full-Time. Comma-separated values are supported; each value can be up to 31 characters. ## `remote` (type: `string`): Work arrangement filter. Supported values: remote, on-site, hybrid. ## `seniority` (type: `string`): Seniority level, for example Junior, Middle, Senior. Comma-separated values are supported; each value can be up to 31 characters. ## `page` (type: `integer`): Page number. Starts from 0. Pagination is capped by query shape: no company filter up to 1000 items, company filter with another filter up to 20 items, company filter only up to 5 items. ## `size` (type: `integer`): Number of results per page. Default 5, min 1, max 100. Effective maximum can be lower for company-filtered queries; see README. ## Actor input object example ```json { "salary": "", "what": "", "where": "", "country": "United States", "region": "", "city": "", "postal_code": "", "metro_area": "", "title": "", "company_name": "", "company_domain": "", "category": "", "sub_category": "", "industry": "", "posted": "", "employment_type": "", "remote": "", "seniority": "", "page": 0, "size": 5 } ``` # Actor output Schema ## `results` (type: `string`): No description ## `meta` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("aspen-technology-labs-inc/us-government-jobs-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("aspen-technology-labs-inc/us-government-jobs-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call aspen-technology-labs-inc/us-government-jobs-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=aspen-technology-labs-inc/us-government-jobs-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Government Jobs API", "description": "Find US government job postings from .gov and .mil source or employer domains by role, location, company, salary, posting age, employment type, remote status, and seniority.", "version": "0.1", "x-build-id": "F5gHfdHQBkivEKoOI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aspen-technology-labs-inc~us-government-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aspen-technology-labs-inc-us-government-jobs-api", "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/aspen-technology-labs-inc~us-government-jobs-api/runs": { "post": { "operationId": "runs-sync-aspen-technology-labs-inc-us-government-jobs-api", "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/aspen-technology-labs-inc~us-government-jobs-api/run-sync": { "post": { "operationId": "run-sync-aspen-technology-labs-inc-us-government-jobs-api", "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": { "salary": { "title": "Salary filter", "type": "string", "description": "Salary amount/range filter. Format: 1-9 digits followed by y, m, w, d, or h; optional range A-B. Examples: 20h-30h, 35h, 20h-200000y.", "default": "" }, "what": { "title": "Job search query", "type": "string", "description": "Optional job search query within US public-sector jobs. The Actor always applies an internal .gov/.mil source filter and appends this value to it. For best results, use role or category keywords such as police, nurse, engineer, analyst, or social worker.", "default": "" }, "where": { "title": "Free-text location query", "type": "string", "description": "Free-text location search. Use only when structured location fields such as country, region, city, postal_code, or metro_area are not set; structured fields take priority. Maximum 700 raw URL chars or 500 decoded chars.", "default": "" }, "country": { "title": "Country", "type": "string", "description": "Fixed preset for this Actor. The runtime always uses United States; changing this value in input is ignored.", "default": "United States" }, "region": { "title": "Region", "type": "string", "description": "State, province, or region. Maximum 80 characters.", "default": "" }, "city": { "title": "City", "type": "string", "description": "City filter. Maximum 100 characters.", "default": "" }, "postal_code": { "title": "Postal code", "type": "string", "description": "Postal or ZIP code. Maximum 20 characters.", "default": "" }, "metro_area": { "title": "Metro area", "type": "string", "description": "Metropolitan area filter. Maximum 100 characters. Example: Denver-Aurora-Centennial, CO.", "default": "" }, "title": { "title": "Job title", "type": "string", "description": "Job title filter. Maximum 200 characters.", "default": "" }, "company_name": { "title": "Company name", "type": "string", "description": "Company name filter. Company filters reduce the retrievable item cap; see README.", "default": "" }, "company_domain": { "title": "Company domain", "type": "string", "description": "Company website domain in valid DNS form, for example ibm.com. Company filters reduce the retrievable item cap; see README.", "default": "" }, "category": { "title": "Category", "type": "string", "description": "Job category filter. This narrows the public-sector jobs dataset after the internal .gov/.mil source preset is applied.", "default": "" }, "sub_category": { "title": "Sub-category", "type": "string", "description": "More specific job function or role within a category. Maximum 100 characters.", "default": "" }, "industry": { "title": "Industry", "type": "string", "description": "Company industry. Maximum 100 characters. Example: Food Products or Hotels and Restaurants.", "default": "" }, "posted": { "title": "Posted time frame", "type": "string", "description": "Relative posting age, such as 1h, 1d, 1w, 1m, or an ISO date: YYYY, YYYY-MM, YYYY-MM-DD.", "default": "" }, "employment_type": { "title": "Employment type", "type": "string", "description": "Employment type, for example Full-Time. Comma-separated values are supported; each value can be up to 31 characters.", "default": "" }, "remote": { "title": "Remote / work arrangement", "enum": [ "", "remote", "on-site", "hybrid" ], "type": "string", "description": "Work arrangement filter. Supported values: remote, on-site, hybrid.", "default": "" }, "seniority": { "title": "Seniority", "type": "string", "description": "Seniority level, for example Junior, Middle, Senior. Comma-separated values are supported; each value can be up to 31 characters.", "default": "" }, "page": { "title": "Page number", "minimum": 0, "type": "integer", "description": "Page number. Starts from 0. Pagination is capped by query shape: no company filter up to 1000 items, company filter with another filter up to 20 items, company filter only up to 5 items.", "default": 0 }, "size": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of results per page. Default 5, min 1, max 100. Effective maximum can be lower for company-filtered queries; see README.", "default": 5 } } }, "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 } } } } } } } } } } ```