# H1BData API: Search H-1B salary filings

> Searches H-1B labor condition filings by employer, job title, city and year. Returns salary statistics across all matched filings and the highest-paid filings with case status.

Unofficial. Not affiliated with or endorsed by H1BData.

- Page: https://fous.com/methods/h1bdata.info/search-salaries
- Method: `h1bdata.info/search_salaries`, version 1
- Website: h1bdata.info
- Returns: record count, median and average base salary, top-paid filings with case status
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `city` | string | no | `"Seattle"` | Optional city, for example Seattle. Default "". |
| `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. Default "". |
| `max_results` | integer | no | `10` | Maximum highest-paid filings to return, for example 100. Default 100. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "city": "Seattle",
  "year": 2025,
  "employer": "Google",
  "job_title": "Data Scientist",
  "max_results": 10
}
```

Its 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
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"h1bdata.info/search_salaries","input":{"city":"Seattle","year":2025,"employer":"Google","job_title":"Data Scientist","max_results":10}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the median base salary for Google software engineer H-1B filings in Mountain View for 2024?
- Show me the top paid H-1B filings from Infosys in Bangalore... actually for Dallas in 2023, with case status
- How much do Meta data scientists earn on H-1B filings in Menlo Park, 2025 median and average?
- Pull the highest-paid labor condition filings for Tata Consultancy Services, year 2022, limit 50 results
- Average base salary across H-1B filings for Deloitte product managers in New York during 2024, with the top 20 paid filings and their case statuses

## Input schema

```json
{
  "type": "object",
  "required": [
    "employer"
  ],
  "properties": {
    "city": {
      "type": "string",
      "default": "",
      "description": "Optional city, for example Seattle."
    },
    "year": {
      "type": "integer",
      "minimum": 2012,
      "description": "Filing year, for example 2025. Defaults to the latest full calendar year."
    },
    "employer": {
      "type": "string",
      "minLength": 1,
      "description": "Company name to search, for example Amazon."
    },
    "job_title": {
      "type": "string",
      "default": "",
      "description": "Optional job title, for example Data Scientist."
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum highest-paid filings to return, for example 100."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "record_count",
    "median_base_salary",
    "average_base_salary",
    "currency",
    "salaries"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "description": "Salary currency code."
    },
    "salaries": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "employer",
          "job_title",
          "base_salary",
          "location",
          "submit_date",
          "start_date",
          "case_status",
          "page_url"
        ],
        "properties": {
          "employer": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "page_url": {
            "type": "string",
            "description": "Public case page."
          },
          "job_title": {
            "type": "string"
          },
          "start_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Employment start date, YYYY-MM-DD."
          },
          "base_salary": {
            "type": "number",
            "description": "Annual base salary in USD."
          },
          "case_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Case status, such as Certified or Withdrawn."
          },
          "submit_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Filing submission date, YYYY-MM-DD."
          }
        }
      },
      "description": "Highest-paid matching salary filings first."
    },
    "record_count": {
      "type": "integer",
      "description": "Number of matched salary filings."
    },
    "median_base_salary": {
      "type": [
        "number",
        "null"
      ],
      "description": "Median annual base salary in USD across all matched filings."
    },
    "average_base_salary": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average annual base salary in USD across all matched filings."
    }
  }
}
```

## See more

- [PayScale API: Get salary for a job title](https://fous.com/methods/payscale.com/get-salary.md): Gets typical pay for a job title from PayScale research pages. You can narrow it to a country and a city.
- [BLS API: Get occupation wages](https://fous.com/methods/bls.gov/get-occupation-wages.md): Finds the latest published BLS pay and employment for an occupation in the US, a state, or a metro area, and compares it with the national median.
- [Indeed API: Get salary for a job title](https://fous.com/methods/indeed.com/get-salary.md): Finds the typical pay for a job title in the United States or a U.S. city or state on Indeed's public salary pages, with the number of reported salaries, the last update date, and the top-paying cities and companies when shown.
- [ZipRecruiter API: Get salary for a job title](https://fous.com/methods/ziprecruiter.com/get-salary.md): Looks up ZipRecruiter's salary page for a job title in the United States or one US state and returns typical pay, the percentile range and the top-paying cities. Only salary pages that exist publicly are returned.
- [AmbitionBox API: Get company salaries](https://fous.com/methods/ambitionbox.com/get-company-salaries.md): Gets annual salaries by role at an Indian company from AmbitionBox, ordered by number of reports, plus annual averages by experience band when a job title is supplied.
- [PayScale API: Get company pay](https://fous.com/methods/payscale.com/get-company-pay.md): Shows an employer's average annual base salary and its common jobs, with salary ranges, from PayScale public research pages.
- [Naukri API: Search jobs](https://fous.com/methods/naukri.com/search-jobs.md): Finds open public Naukri job listings by keywords, with optional city and experience filters, in Naukri's search order. Undisclosed salaries have no numeric range.
- [BLS API: Get occupation outlook](https://fous.com/methods/bls.gov/get-occupation-outlook.md): Finds the best-matching Occupational Outlook Handbook profile for a job title and returns its pay, entry requirements, jobs and 10-year outlook.
