USAJOBS API

Search US federal jobs and pull full USAJOBS announcements, salaries and grades as clean JSON.

The API.SH USAJOBS API returns US federal government job announcements as structured JSON. Search current jobs by keyword and place with the site's filters for agency, department, occupational series, GS grade, schedule, appointment type, hiring path, travel, clearance, remote, telework, relocation and salary range. Open any announcement for every section, from duties and qualifications to how to apply, or read the announcements feed filtered by agency, series and open or close dates.

Get a free API key Try it in the playground

3 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Search USAJOBS federal jobs

GET https://api.api.sh/usajobs/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the USAJOBS API

Federal job boards and alerts

Run searches by series, grade and location and send new announcements to job seekers, veterans or students.

/search

Federal pay research

Collect salary ranges, pay plans and grades by agency and occupational series to compare federal pay.

/search /announcements

Hiring trend tracking

Read the announcements feed by agency, department and opening dates to follow which agencies are hiring and for what roles.

/announcements

Resume and qualification tools

Pull the duties, requirements, qualifications and required documents from an announcement so a tool can match a resume against them.

/job

Remote and telework job lists

Filter for remote or telework-eligible positions and list them with salary, grade and closing date.

/search

USAJOBS data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

USAJOBS API endpoints and prices

Every USAJOBS endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Search USAJOBS federal jobs

/usajobs/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places2

USAJOBS announcements feed /usajobs/v1/announcements	$1 · $2 PAYG 1 credit
USAJOBS job announcement /usajobs/v1/job	$1 · $2 PAYG 1 credit

Call the USAJOBS API

Search USAJOBS federal jobs: GET https://api.api.sh/usajobs/v1/search

curl "https://api.api.sh/usajobs/v1/search?q=nurse" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/usajobs/v1/search",
    params={"q": "nurse"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/usajobs/v1/search");
url.searchParams.set("q", "nurse");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/usajobs/v1/search", "q", "nurse")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "USAJOBS" and "Search USAJOBS federal jobs".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for USAJOBS data

Public data only: no USAJOBS login, cookies or account needed
One key and one response shape for USAJOBS and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official USAJOBS API

Yes. USAJOBS offers a free official API through its developer portal: you request an API key with your email and send it with your registered email in request headers. API.SH needs no key request or special headers, returns full announcement sections as HTML and text, and uses the same JSON format as its other job sites.

Instead of maintaining a USAJOBS scraper or an Apify actor, use one API.SH key for USAJOBS and other job boards, with fixed per-call pricing.

USAJOBS API questions

What USAJOBS data can I get?+

Federal job search with every site filter and facet counts (/usajobs/v1/search), one announcement with salary, grades, telework, clearance and every section from duties to how to apply (/usajobs/v1/job), and the announcements feed filtered by agency, series and dates (/usajobs/v1/announcements).

How much does the USAJOBS API cost?+

Every USAJOBS endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /usajobs/v1/announcements at 1 credit each.

Is there an official USAJOBS API?+

Yes. The USAJOBS developer portal offers a free API with a key requested by email. API.SH is an alternative when you want results right away with one key, full announcement text and one JSON format across job sources.

Do I need a USAJOBS API key or login?+

No. You use your API.SH key only. No USAJOBS account, login or USAJOBS API key is needed, and hiring-office contact people are left out.

Can I filter by GS grade, series and salary?+

Yes. Search takes grade, series, salary_min and salary_max along with agency, department, schedule, appointment, hiring_path, clearance, remote and telework, and returns facet_counts for each option.

Can I use it from Python?+

Yes. Use the Python SDK or any HTTP client: call /usajobs/v1/search with q and location, and pass next_page back as page for the next 25 results.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /usajobs/v1/search with q and location, then open a result with /usajobs/v1/job. Docs are at https://api.sh/docs, with JS and Python SDKs, Google Sheets, Zapier, Make, n8n and the MCP server at https://api.sh/mcp.