# USAJOBS API > USAJOBS returns federal job listings and salary details, available as a workflow and API. USAJOBS (USA Jobs) searches federal job listings by required keywords and optional location, salary threshold, and applicant group. Search jobs returns job titles, agencies, locations, pay ranges, dates, and remote or telework details when stated. - Page: https://fous.com/tools/usajobs - Handle: `@usajobs` - Category: [Jobs](https://fous.com/tools/category/jobs) - Source website: https://usajobs.gov - Last verified: Sep 29, 2026 ## Methods ### Search jobs Operation `search_jobs`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. Search USAJOBS federal jobs by keywords, location, salary threshold, and applicant group in website relevance order. Salary ranges may start below the threshold; annual pay or remote status is null when the announcement does not state it. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `keywords` | string | yes | `"analyst"` | Words to search for in federal jobs, such as accountant. | | `location` | string | no | `"remote"` | City, state, or remote, such as Washington, DC or remote. Leave blank to search anywhere. | | `max_results` | integer | no | `5` | Maximum number of jobs to return, such as 25; maximum 100. | | `who_may_apply` | string | no | `"veterans"` | Applicant group to include, such as public; default any. | | `minimum_salary_usd` | number | no | `100000` | Minimum annual pay in USD, such as 100000. Leave at 0 for any salary. | **Input schema** ```json { "type": "object", "required": [ "keywords" ], "properties": { "keywords": { "type": "string", "minLength": 1, "description": "Words to search for in federal jobs, such as accountant.", "examples": [ "analyst", "accountant", "zzqxyzzunfindablezz" ] }, "location": { "type": "string", "default": "", "description": "City, state, or remote, such as Washington, DC or remote. Leave blank to search anywhere.", "examples": [ "remote", "Washington, DC" ] }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum number of jobs to return, such as 25; maximum 100.", "x-fous-developer": true, "examples": [ 5, 3, 2 ] }, "who_may_apply": { "enum": [ "any", "public", "veterans", "students_and_recent_graduates", "federal_employees" ], "type": "string", "default": "any", "description": "Applicant group to include, such as public; default any.", "examples": [ "veterans", "public" ] }, "minimum_salary_usd": { "type": "number", "default": 0, "minimum": 0, "description": "Minimum annual pay in USD, such as 100000. Leave at 0 for any salary.", "examples": [ 100000 ] } }, "additionalProperties": false, "examples": [ { "keywords": "analyst", "location": "remote", "max_results": 5 }, { "keywords": "accountant", "max_results": 3 }, { "keywords": "accountant", "location": "Washington, DC", "max_results": 2, "who_may_apply": "veterans", "minimum_salary_usd": 100000 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `jobs` | array | | | | `jobs[].agency` | string or null | `"Veterans Health Administration"` | | | `jobs[].remote` | boolean or null | `true` | | | `jobs[].job_link` | string | `"https://www.usajobs.gov/job/886004900"` | | | `jobs[].job_title` | string | `"Program Analyst"` | | | `jobs[].locations` | array | | | | `jobs[].open_date` | string or null | `"2026-09-28"` | | | `jobs[].pay_grade` | string or null | `"GS 11"` | | | `jobs[].department` | string or null | `"Department of Veterans Affairs"` | | | `jobs[].closing_date` | string or null | `"2026-10-05"` | | | `jobs[].who_may_apply` | array | | | | `jobs[].salary_currency` | string | `"USD"` | | | `jobs[].telework_eligible` | boolean or null | `false` | | | `jobs[].salary_maximum_usd` | number or null | `121371` | | | `jobs[].salary_minimum_usd` | number or null | `74678` | | **Example input** ```json { "keywords": "analyst", "location": "remote", "max_results": 5 } ``` **Example output** ```json { "jobs": [ { "agency": "Veterans Health Administration", "remote": true, "job_link": "https://www.usajobs.gov/job/886004900", "job_title": "Program Analyst", "locations": [ "Anywhere in the U.S. (remote job)" ], "open_date": "2026-09-28", "pay_grade": "GS 11", "department": "Department of Veterans Affairs", "closing_date": "2026-10-05", "who_may_apply": [ "Internal to an agency", "Career transition (CTAP, ICTAP, RPL)" ], "salary_currency": "USD", "telework_eligible": false, "salary_maximum_usd": 121371, "salary_minimum_usd": 74678 }, { "agency": "Veterans Health Administration", "remote": true, "job_link": "https://www.usajobs.gov/job/885580100", "job_title": "Supervisory Program Analyst", "locations": [ "Anywhere in the U.S. (remote job)" ], "open_date": "2026-09-22", "pay_grade": "GS 13", "department": "Department of Veterans Affairs", "closing_date": "2026-09-28", "who_may_apply": [ "Internal to an agency", "Career transition (CTAP, ICTAP, RPL)" ], "salary_currency": "USD", "telework_eligible": false, "salary_maximum_usd": 172980, "salary_minimum_usd": 106437 } ] } ``` ## Quick start Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data. ```bash curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 180 \ -H "Authorization: Bearer YOUR_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@usajobs", "visibility": "public", "operation": "search_jobs", "version": 1, "input": { "keywords": "analyst", "location": "remote", "max_results": 5 }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. import json import urllib.error import urllib.request api_key = "YOUR_API_KEY" body = json.loads("{\n \"api\": \"@usajobs\",\n \"visibility\": \"public\",\n \"operation\": \"search_jobs\",\n \"version\": 1,\n \"input\": {\n \"keywords\": \"analyst\",\n \"location\": \"remote\",\n \"max_results\": 5\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=180) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. const apiKey = "YOUR_API_KEY"; const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(180_000), body: JSON.stringify({ "api": "@usajobs", "visibility": "public", "operation": "search_jobs", "version": 1, "input": { "keywords": "analyst", "location": "remote", "max_results": 5 }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` ## Use from an AI assistant Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input. - Server URL: `https://api.fous.com/mcp/tools/usajobs` - Authorization: `Authorization: Bearer ` **Tools** - `search_jobs`: Search jobs. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. - `fous_get_run`: the result of a run that was still going, by its `request_id`. Free. Claude Code: ```bash claude mcp add --scope user --transport http fous-usajobs https://api.fous.com/mcp/tools/usajobs --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}" ``` To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt. ## Use cases - Find federal jobs by role and location - Compare listed federal job salary ranges - Identify jobs open to a particular applicant group - Track job closing dates and agencies ## FAQ ### Can I run it with my own inputs? Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant. ### Can I call this USAJOBS tool as an API? Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back. ### How much does it cost? Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit. ### Do I need a USAJOBS account? No. You only need a Fous account. ### How current is the data? Fous gets the data from usajobs.gov when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026. ### Which federal jobs match my keywords and location? Search jobs returns matching listings in website relevance order using required keywords and an optional location. ### Which jobs meet a salary threshold? Search jobs accepts a minimum salary in USD and returns listed salary ranges; a range may start below the threshold. ### Which federal jobs are remote or telework eligible? Search jobs returns remote and telework eligibility details when stated in the announcement. ## Related - [Grants.gov API](https://fous.com/tools/grants-gov.md): U.S. federal grant opportunities and application information. - [Indeed API](https://fous.com/tools/indeed.md): Indeed returns public first-page listings and details for available, unexpired jobs, company employee ratings and CEO approval when available, and typical pay from public salary pages. - [Remote OK API](https://fous.com/tools/remote-ok.md): Remote job postings from Remote OK. - [Google Search API](https://fous.com/tools/google-search.md): Google Search returns public web, image, job, event, related-question, and autocomplete results in Google’s order, with answers and details when available; results may be fewer, omit information, or be empty. - [USAspending API](https://fous.com/tools/usaspending.md): USAspending provides official federal spending data and searchable awards from October 1, 2007 onward; figures and agency account reports may be revised or lag published award updates. - [SAM.gov API](https://fous.com/tools/sam-gov.md): U.S. federal contract opportunities and government notices. - [ZipRecruiter API](https://fous.com/tools/ziprecruiter.md): ZipRecruiter returns up to 100 public job listings per search and U.S. job-title pay ranges and top-paying cities where public salary pages exist. - [SEEK API](https://fous.com/tools/seek.md): Search open jobs across Australia on SEEK. - [All Jobs tools](https://fous.com/tools/category/jobs)