# 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/workflows/usajobs
- Handle: `@usajobs`
- Category: [Jobs](https://fous.com/workflows/category/jobs)
- Source website: https://usajobs.gov
- Last verified: Sep 29, 2026
- Fous is not affiliated with USAJOBS.

## Methods

### Search jobs

Operation `search_jobs`, version 1. 1 credit per call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@usajobs","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with USAJOBS?

No. Fous is not affiliated with USAJOBS. This workflow reads the public usajobs.gov website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/grants-gov.md): U.S. federal grant opportunities and application information.
- [Indeed API](https://fous.com/workflows/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/workflows/remote-ok.md): Remote job postings from Remote OK.
- [Google Search API](https://fous.com/workflows/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/workflows/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/workflows/sam-gov.md): U.S. federal contract opportunities and government notices.
- [ZipRecruiter API](https://fous.com/workflows/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/workflows/seek.md): Search open jobs across Australia on SEEK.
- [All Jobs workflows](https://fous.com/workflows/category/jobs)