# H1B Salary Database API > H1B Salary Database returns H-1B salary filings and salary statistics as a workflow and API. H1B Salary Database searches H-1B labor condition filings by required employer and optional job title, city, and filing year. - Page: https://fous.com/tools/h1b-salary-database - Handle: `@h1b-salary-database` - Category: [Jobs](https://fous.com/tools/category/jobs) - Source website: https://h1bdata.info - Last verified: Sep 29, 2026 ## Methods ### Search salaries Operation `search_salaries`, 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 H-1B labor condition filings by employer, job title, city, and year. Returns salary statistics across all matched filings and up to 1,000 highest-paid records with case status. Employer name matching follows the site’s filed names; alternate spellings may require a more specific name. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `city` | string | no | `"Seattle"` | Optional city, for example Seattle. | | `year` | integer | no | `2025` | Filing year, for example 2025. Defaults to the latest full calendar year. | | `employer` | string | yes | `"Google"` | Company name to search, for example Amazon. | | `job_title` | string | no | `"Data Scientist"` | Optional job title, for example Data Scientist. | | `max_results` | integer | no | `10` | Maximum highest-paid filings to return, for example 100. | **Input schema** ```json { "type": "object", "required": [ "employer" ], "properties": { "city": { "type": "string", "default": "", "description": "Optional city, for example Seattle.", "examples": [ "Seattle" ] }, "year": { "type": "integer", "minimum": 2012, "description": "Filing year, for example 2025. Defaults to the latest full calendar year.", "x-fous-developer": false, "examples": [ 2025 ] }, "employer": { "type": "string", "minLength": 1, "description": "Company name to search, for example Amazon.", "examples": [ "Google", "OpenAI", "Amazon" ] }, "job_title": { "type": "string", "default": "", "description": "Optional job title, for example Data Scientist.", "examples": [ "Data Scientist" ] }, "max_results": { "type": "integer", "default": 100, "maximum": 1000, "minimum": 1, "description": "Maximum highest-paid filings to return, for example 100.", "x-fous-developer": true, "examples": [ 10, 5 ] } }, "additionalProperties": false, "examples": [ { "city": "Seattle", "year": 2025, "employer": "Google", "job_title": "Data Scientist", "max_results": 10 }, { "year": 2025, "employer": "OpenAI", "max_results": 5 }, { "city": "Seattle", "year": 2025, "employer": "Amazon", "job_title": "Data Scientist", "max_results": 5 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `currency` | string | `"USD"` | Salary currency code. | | `salaries` | array | | Highest-paid matching salary filings first. | | `salaries[].employer` | string | `"GOOGLE LLC"` | | | `salaries[].location` | string | `"SEATTLE, WA"` | | | `salaries[].page_url` | string | `"https://h1bdata.info/details.php?id=I-200-25345-477125"` | Public case page. | | `salaries[].job_title` | string | `"DATA SCIENTIST"` | | | `salaries[].start_date` | string or null | `"2026-03-28"` | Employment start date, YYYY-MM-DD. | | `salaries[].base_salary` | number | `200000` | Annual base salary in USD. | | `salaries[].case_status` | string or null | `"Certified"` | Case status, such as Certified or Withdrawn. | | `salaries[].submit_date` | string or null | `"2025-12-11"` | Filing submission date, YYYY-MM-DD. | | `record_count` | integer | `3` | Number of matched salary filings. | | `median_base_salary` | number or null | `178000` | Median annual base salary in USD across all matched filings. | | `average_base_salary` | number or null | `179666.67` | Average annual base salary in USD across all matched filings. | **Example input** ```json { "city": "Seattle", "year": 2025, "employer": "Google", "job_title": "Data Scientist", "max_results": 10 } ``` **Example output** ```json { "currency": "USD", "salaries": [ { "employer": "GOOGLE LLC", "location": "SEATTLE, WA", "page_url": "https://h1bdata.info/details.php?id=I-200-25345-477125", "job_title": "DATA SCIENTIST", "start_date": "2026-03-28", "base_salary": 200000, "case_status": "Certified", "submit_date": "2025-12-11" }, { "employer": "GOOGLE LLC", "location": "SEATTLE, WA", "page_url": "https://h1bdata.info/details.php?id=I-200-25085-804581", "job_title": "DATA SCIENTIST", "start_date": "2025-09-01", "base_salary": 178000, "case_status": "Certified", "submit_date": "2025-03-26" }, { "employer": "GOOGLE LLC", "location": "SEATTLE, WA", "page_url": "https://h1bdata.info/details.php?id=I-200-25010-611433", "job_title": "DATA SCIENTIST", "start_date": "2025-05-02", "base_salary": 161000, "case_status": "Certified", "submit_date": "2025-01-10" } ], "record_count": 3, "median_base_salary": 178000, "average_base_salary": 179666.67 } ``` ## 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": "@h1b-salary-database", "visibility": "public", "operation": "search_salaries", "version": 1, "input": { "city": "Seattle", "year": 2025, "employer": "Google", "job_title": "Data Scientist", "max_results": 10 }, "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\": \"@h1b-salary-database\",\n \"visibility\": \"public\",\n \"operation\": \"search_salaries\",\n \"version\": 1,\n \"input\": {\n \"city\": \"Seattle\",\n \"year\": 2025,\n \"employer\": \"Google\",\n \"job_title\": \"Data Scientist\",\n \"max_results\": 10\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": "@h1b-salary-database", "visibility": "public", "operation": "search_salaries", "version": 1, "input": { "city": "Seattle", "year": 2025, "employer": "Google", "job_title": "Data Scientist", "max_results": 10 }, "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/h1b-salary-database` - Authorization: `Authorization: Bearer ` **Tools** - `search_salaries`: Search salaries. 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-h1b-salary-database https://api.fous.com/mcp/tools/h1b-salary-database --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 - Compare median salaries across an employer’s matching filings - Review highest-paid filings for a job title and city - Track case statuses for matching salary filings - Compare salary statistics across filing years ## 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 H1B Salary Database 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 H1B Salary Database account? No. You only need a Fous account. ### How current is the data? Fous gets the data from h1bdata.info 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. ### What is the median salary across an employer’s filings? Search salaries returns the median annual base salary across all matching filings. ### Which are the highest-paid matching filings? Search salaries returns matching filings ordered by salary, with case status and other filing details. ### How many filings match an employer and year? Search salaries returns the number of matching salary filings. ## Related - [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. - [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. - [PayScale API](https://fous.com/tools/payscale.md): PayScale provides job and location salary research, skill pay effects when published, and employer average base salaries and common jobs where available. - [AmbitionBox API](https://fous.com/tools/ambitionbox.md): AmbitionBox covers company reviews, salaries and jobs, including role pay, experience averages and ratings; verification can limit salary results, and review summaries may be unavailable. - [Levels.fyi API](https://fous.com/tools/levels-fyi.md): Levels.fyi returns published per-level median annual pay, rankings of up to 50 companies by role/location median total pay, and cross-company pay comparisons for 2–10 companies. - [Naukri API](https://fous.com/tools/naukri.md): Search public job listings in India. - [Bureau of Labor Statistics API](https://fous.com/tools/bureau-of-labor-statistics.md): Bureau of Labor Statistics provides latest occupation pay, employment, career outlooks, unemployment, category inflation (up to 24 months’ history), and CPI conversions from January 1913. - [Remote OK API](https://fous.com/tools/remote-ok.md): Remote job postings from Remote OK. - [All Jobs tools](https://fous.com/tools/category/jobs)