# US H-1B & Green Card Sponsor Database (`constructive_calm/visa-sponsor-tracker`) Actor

Search official US Department of Labor H-1B, H-1B1, E-3, and PERM green-card sponsorship filings. Find sponsoring companies, roles, offered salaries, work locations, and approval outcomes from OFLC public disclosure data.

- **URL**: https://apify.com/constructive\_calm/visa-sponsor-tracker.md
- **Developed by:** [Omar Eldeeb](https://apify.com/constructive_calm) (community)
- **Categories:** Lead generation, SEO tools, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## US H-1B & Green Card Sponsor Database

Search official US Department of Labor sponsorship filings for H-1B, H-1B1, E-3, and PERM green-card cases. Find which companies sponsor a role, what they offered, where the job is located, and how filings were decided.

The actor reads the Department of Labor Office of Foreign Labor Certification public disclosure XLSX files, normalizes salary and location fields, and returns clean JSON rows that work well in CSV exports, dashboards, CRM enrichment, research workflows, and LLM pipelines.

### What this actor does

- Finds visa-sponsoring employers for a job title, city, state, salary range, visa type, and fiscal year.
- Checks a specific employer's sponsorship footprint by role, filing count, salary range, and approval outcome.
- Computes salary percentiles for a role and location from real DOL filing data.
- Bulk-exports individual filing rows for downstream analysis.
- Converts hourly, weekly, biweekly, and monthly wages into annual USD for comparison.
- Caches DOL disclosure files for faster repeated runs.
- Supports "new filings only" watermarks for scheduled monitoring.

### Common use cases

| Use case | What you get |
| --- | --- |
| Job seekers | A list of companies that have sponsored your target role in your target location, plus salary ranges and approval history. |
| Recruiters | Sponsor-aware sourcing lists based on role, market, visa type, salary, and filing recency. |
| Employer research | A company-level sponsorship profile by job title, salary range, location, and outcome. |
| Compensation research | Salary percentiles based on real visa filings rather than self-reported surveys. |
| Analysts and journalists | Filtered exports of official filing records for repeatable research. |
| SaaS and automation teams | Structured JSON output for webhooks, APIs, n8n, Zapier, and internal data products. |

### Input options

#### Mode

Choose one of four modes:

| Mode | Description |
| --- | --- |
| `sponsor-finder` | Finds employers sponsoring a role and returns one aggregate row per employer. Scans selected source files fully so rankings are accurate. |
| `company-check` | Looks up one employer and returns role-level aggregates followed by individual filing rows. |
| `salary-lookup` | Returns salary percentile rows for a role and location. Scans selected source files fully so percentiles are accurate. |
| `bulk-export` | Returns individual filing records matching the filters. Best for quick samples because it stops as soon as `maxItems` filings are returned. |

The prefilled marketplace run uses `bulk-export`, H-1B only, the latest fiscal year, and a small `maxItems` value. That keeps Apify quality checks and first-time tests fast. For deeper research, switch to `sponsor-finder`, `company-check`, or `salary-lookup` and broaden the fiscal years or visa types.

#### Filters

| Field | Description |
| --- | --- |
| `role` | Job title keyword such as `software engineer`, `data scientist`, or `registered nurse`. Required for `sponsor-finder` and `salary-lookup`. |
| `employer` | Company name keyword such as `Google`, `Amazon`, or `Infosys`. Required for `company-check`. |
| `city` | Worksite city filter. Leave empty for all cities. |
| `state` | Two-letter US state filter. Leave empty for all states. |
| `visaTypes` | Any combination of `H-1B`, `H-1B1`, `E-3`, and `PERM`. Defaults to `H-1B`; add `PERM` for green-card sponsorship filings. |
| `decisions` | Any combination of `Approved`, `Denied`, and `Withdrawn`. Defaults to `Approved`. |
| `fiscalYears` | US fiscal years such as `2026` or `2025`. Leave empty for the latest fiscal year. Multiple years take longer in aggregate modes because each selected source file is scanned before output rows are limited. |
| `minSalary` | Minimum annualized offered salary in USD. |
| `maxSalary` | Maximum annualized offered salary in USD. |
| `maxItems` | Maximum number of output rows, up to 50,000. In aggregate modes, this limits returned rows after the source files are scanned. |
| `newFilingsOnly` | When enabled, only returns filings newer than the saved watermark for the same input. |

### Example inputs

#### Find sponsors for a role

```json
{
    "mode": "sponsor-finder",
    "role": "software engineer",
    "state": "CA",
    "minSalary": 150000,
    "visaTypes": ["H-1B"],
    "decisions": ["Approved"],
    "fiscalYears": ["2026"],
    "maxItems": 25
}
````

#### Check one company

```json
{
    "mode": "company-check",
    "employer": "Nvidia",
    "fiscalYears": ["2026", "2025"],
    "maxItems": 50
}
```

#### Salary lookup

```json
{
    "mode": "salary-lookup",
    "role": "data scientist",
    "city": "Seattle",
    "state": "WA",
    "fiscalYears": ["2026"]
}
```

#### Bulk export

```json
{
    "mode": "bulk-export",
    "role": "machine learning engineer",
    "minSalary": 200000,
    "fiscalYears": ["2026"],
    "maxItems": 1000,
    "newFilingsOnly": false
}
```

### Output

Every dataset item includes a `type` field. The actor can return three row types.

#### `filing`

Individual DOL filing row. Returned by `bulk-export` and, after aggregates, by `company-check`.

```json
{
    "type": "filing",
    "caseNumber": "I-200-25356-503701",
    "visaType": "H-1B",
    "decision": "Approved",
    "decisionDate": "2025-12-30",
    "filedDate": "2025-12-22",
    "fiscalYear": 2026,
    "employer": "NVIDIA CORPORATION",
    "employerFein": "94-3177549",
    "employerCity": "Santa Clara",
    "employerState": "CA",
    "jobTitle": "Software Engineer",
    "socCode": "15-1252.00",
    "wageOffered": 187574,
    "wageUnit": "year",
    "wageOfferedRaw": 187574,
    "prevailingWage": 173329,
    "prevailingWageLevel": "II",
    "numberOfWorkers": 1,
    "workCity": "Santa Clara",
    "workState": "CA",
    "workZip": "95051",
    "sourceProgram": "LCA",
    "sourceFile": "LCA_Disclosure_Data_FY2026_Q1.xlsx",
    "sourceUrl": "https://www.dol.gov/sites/dolgov/files/ETA/oflc/pdfs/LCA_Disclosure_Data_FY2026_Q1.xlsx",
    "scrapedAt": "2026-05-12T08:09:16.095Z"
}
```

#### `sponsor-aggregate`

Employer or role aggregate row. Returned by `sponsor-finder` and `company-check`.

```json
{
    "type": "sponsor-aggregate",
    "employer": "GOOGLE LLC",
    "role": "software engineer",
    "filings": 333,
    "approved": 333,
    "denied": 0,
    "withdrawn": 0,
    "approvalRate": 100,
    "medianSalary": 198000,
    "p25Salary": 190000,
    "p75Salary": 228000,
    "minSalary": 143000,
    "maxSalary": 380000,
    "topCity": "Mountain View",
    "topState": "CA",
    "visaTypeBreakdown": { "H-1B": 333 },
    "latestFiling": "2025-12-30",
    "earliestFiling": "2025-11-04"
}
```

#### `salary-distribution`

Salary percentile row. Returned by `salary-lookup`.

```json
{
    "type": "salary-distribution",
    "role": "data scientist",
    "city": null,
    "state": "CA",
    "count": 244,
    "p10Salary": 123531,
    "p25Salary": 143701,
    "medianSalary": 174913,
    "p75Salary": 217226,
    "p90Salary": 248976,
    "topEmployer": "GOOGLE LLC",
    "visaTypeBreakdown": { "H-1B": 244 }
}
```

### Pricing

This actor is configured for pay-per-event usage in `.actor/pay_per_event.json`.

| Event | Price | When it is charged |
| --- | --- | --- |
| Actor start | $0.01 | Synthetic start event charged automatically by Apify when a run starts. |
| Visa filing returned | $0.005 | Each individual filing row returned. |
| Employer aggregate returned | $0.002 | Each sponsor aggregate row returned. |
| Salary percentile row | $0.003 | Each salary distribution row returned. |

The first 10 chargeable output events in each run are treated as a free trial inside the actor logic before `Actor.charge()` is called.

### Data source and freshness

The actor reads public disclosure files from the US Department of Labor Office of Foreign Labor Certification performance data page:

https://www.dol.gov/agencies/eta/foreign-labor/performance

DOL publishes new quarterly disclosure data after each fiscal quarter closes. The actor discovers available files from the DOL page at run time and caches both the file index and downloaded XLSX files to reduce repeat downloads.

### Notes and limitations

- H-1B, H-1B1, and E-3 records are sourced from DOL LCA disclosure files.
- PERM green-card sponsorship records are sourced from DOL PERM disclosure files.
- Salary values are normalized to annual USD when DOL publishes hourly, weekly, biweekly, or monthly wage units.
- The actor reads the primary worksite columns exposed in the disclosure file. Some filings may include additional worksites not represented in the primary columns.
- Approval analytics are based on DOL case status values in the disclosure data.

### Legal and responsible use

The source files are public US Government Department of Labor publications. This actor does not infer protected characteristics, identify workers, or add private data. It normalizes public employer, role, salary, location, and decision fields for easier analysis.

Use the data responsibly. Employer outreach, recruiting, and analytics workflows should comply with applicable privacy, anti-spam, employment, and immigration rules.

### FAQ

**How far back does it go?**

H-1B/LCA data is generally available back to FY2014. PERM data goes back further, with older years sometimes published as annual files and newer years as quarterly files.

**Why can the first run be slower?**

Some DOL XLSX files are large. The first run downloads and parses the relevant files, then stores them in a named key-value cache. Later runs against the same files are faster.

**Can I schedule this?**

Yes. For monitoring, schedule a weekly run and set `newFilingsOnly` to `true`. The actor stores a watermark for the same filter set and returns only newer matching filings.

**Can I export the results?**

Yes. Apify datasets can be exported as JSON, CSV, Excel, HTML, RSS, and via API.

**Support**

For issues or feature requests, use the actor's Apify Store listing or contact omar.eldeeb@remotegrowthpartners.com.

# Actor input Schema

## `mode` (type: `string`):

Pick the search style that matches your goal. The prefilled run uses bulk-export because it returns a quick sample of individual filings. sponsor-finder, company-check, and salary-lookup calculate accurate aggregates, so they scan each selected DOL source file before limiting the output rows.

## `role` (type: `string`):

The role you are researching. Examples: software engineer, data scientist, product manager, nurse, mechanical engineer. Matches against the job title in each filing. Required for sponsor-finder and salary-lookup modes.

## `employer` (type: `string`):

Exact or partial company name. Examples: Google, Amazon, Cognizant, Infosys. Required for company-check mode. Optional filter in other modes.

## `city` (type: `string`):

City where the H-1B, E-3, H-1B1, or PERM worker would be employed. Examples: San Francisco, New York, Seattle, Austin. Leave empty for nationwide.

## `state` (type: `string`):

Two-letter US state code where the worker would be employed. Examples: CA, NY, TX, WA. Leave empty for nationwide.

## `visaTypes` (type: `array`):

Which visa programs to include. H-1B is the standard skilled-worker visa. H-1B1 covers Chile/Singapore treaty visas. E-3 covers Australia treaty visas. PERM covers permanent labor certification for green-card sponsorship. The prefilled run uses H-1B only for a fast sample; select PERM or multiple programs when you want broader coverage.

## `decisions` (type: `array`):

Which filing outcomes to include. Approved means certified by DOL, Denied means denied by DOL, and Withdrawn means the employer withdrew the filing. Leave empty to include the default Approved outcome.

## `fiscalYears` (type: `array`):

US fiscal years to include. A fiscal year runs from October 1 of the previous calendar year through September 30. Leave empty for the latest fiscal year only. Selecting multiple years can take several minutes in aggregate modes because each selected DOL file must be scanned before final rankings or percentiles are returned.

## `minSalary` (type: `integer`):

Skip filings with an offered annual salary below this value. 0 means no minimum.

## `maxSalary` (type: `integer`):

Skip filings with an offered annual salary above this value. 0 means no maximum.

## `maxItems` (type: `integer`):

Cap on rows returned. In bulk-export this stops after this many individual filings. In sponsor-finder, company-check, and salary-lookup it caps returned result rows after the selected source files have been scanned for accurate aggregates.

## `newFilingsOnly` (type: `boolean`):

If enabled, the actor remembers the latest filing decision date from your previous run with the same input and only returns filings newer than that. Applies to bulk-export and sponsor-finder modes.

## `proxyConfiguration` (type: `object`):

The US Department of Labor public data portal usually does not require proxies. Leave the default unless your network blocks government XLSX downloads.

## Actor input object example

```json
{
  "mode": "bulk-export",
  "role": "software engineer",
  "employer": "",
  "city": "",
  "state": "",
  "visaTypes": [
    "H-1B"
  ],
  "decisions": [
    "Approved"
  ],
  "fiscalYears": [],
  "minSalary": 0,
  "maxSalary": 0,
  "maxItems": 10,
  "newFilingsOnly": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset of work-visa filings, employer aggregates, and salary distributions.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "bulk-export",
    "role": "software engineer",
    "employer": "",
    "city": "",
    "state": "",
    "visaTypes": [
        "H-1B"
    ],
    "fiscalYears": [],
    "maxItems": 10,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("constructive_calm/visa-sponsor-tracker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "bulk-export",
    "role": "software engineer",
    "employer": "",
    "city": "",
    "state": "",
    "visaTypes": ["H-1B"],
    "fiscalYears": [],
    "maxItems": 10,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("constructive_calm/visa-sponsor-tracker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "bulk-export",
  "role": "software engineer",
  "employer": "",
  "city": "",
  "state": "",
  "visaTypes": [
    "H-1B"
  ],
  "fiscalYears": [],
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call constructive_calm/visa-sponsor-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=constructive_calm/visa-sponsor-tracker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "US H-1B & Green Card Sponsor Database",
        "description": "Search official US Department of Labor H-1B, H-1B1, E-3, and PERM green-card sponsorship filings. Find sponsoring companies, roles, offered salaries, work locations, and approval outcomes from OFLC public disclosure data.",
        "version": "1.0",
        "x-build-id": "euWrvdWwvOhesxsUd"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/constructive_calm~visa-sponsor-tracker/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-constructive_calm-visa-sponsor-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/constructive_calm~visa-sponsor-tracker/runs": {
            "post": {
                "operationId": "runs-sync-constructive_calm-visa-sponsor-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/constructive_calm~visa-sponsor-tracker/run-sync": {
            "post": {
                "operationId": "run-sync-constructive_calm-visa-sponsor-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "What do you want to do?",
                        "enum": [
                            "sponsor-finder",
                            "company-check",
                            "salary-lookup",
                            "bulk-export"
                        ],
                        "type": "string",
                        "description": "Pick the search style that matches your goal. The prefilled run uses bulk-export because it returns a quick sample of individual filings. sponsor-finder, company-check, and salary-lookup calculate accurate aggregates, so they scan each selected DOL source file before limiting the output rows.",
                        "default": "sponsor-finder"
                    },
                    "role": {
                        "title": "Job title or keyword",
                        "type": "string",
                        "description": "The role you are researching. Examples: software engineer, data scientist, product manager, nurse, mechanical engineer. Matches against the job title in each filing. Required for sponsor-finder and salary-lookup modes.",
                        "default": ""
                    },
                    "employer": {
                        "title": "Company name",
                        "type": "string",
                        "description": "Exact or partial company name. Examples: Google, Amazon, Cognizant, Infosys. Required for company-check mode. Optional filter in other modes.",
                        "default": ""
                    },
                    "city": {
                        "title": "Work location city",
                        "type": "string",
                        "description": "City where the H-1B, E-3, H-1B1, or PERM worker would be employed. Examples: San Francisco, New York, Seattle, Austin. Leave empty for nationwide.",
                        "default": ""
                    },
                    "state": {
                        "title": "Work location state",
                        "type": "string",
                        "description": "Two-letter US state code where the worker would be employed. Examples: CA, NY, TX, WA. Leave empty for nationwide.",
                        "default": ""
                    },
                    "visaTypes": {
                        "title": "Visa types to include",
                        "type": "array",
                        "description": "Which visa programs to include. H-1B is the standard skilled-worker visa. H-1B1 covers Chile/Singapore treaty visas. E-3 covers Australia treaty visas. PERM covers permanent labor certification for green-card sponsorship. The prefilled run uses H-1B only for a fast sample; select PERM or multiple programs when you want broader coverage.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "H-1B",
                                "H-1B1",
                                "E-3",
                                "PERM"
                            ],
                            "enumTitles": [
                                "H-1B (skilled-worker visa)",
                                "H-1B1 (Chile/Singapore)",
                                "E-3 (Australia)",
                                "PERM (green card)"
                            ]
                        },
                        "default": [
                            "H-1B"
                        ]
                    },
                    "decisions": {
                        "title": "Filter by decision outcome",
                        "type": "array",
                        "description": "Which filing outcomes to include. Approved means certified by DOL, Denied means denied by DOL, and Withdrawn means the employer withdrew the filing. Leave empty to include the default Approved outcome.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Approved",
                                "Denied",
                                "Withdrawn"
                            ],
                            "enumTitles": [
                                "Approved",
                                "Denied",
                                "Withdrawn"
                            ]
                        },
                        "default": [
                            "Approved"
                        ]
                    },
                    "fiscalYears": {
                        "title": "Fiscal years",
                        "type": "array",
                        "description": "US fiscal years to include. A fiscal year runs from October 1 of the previous calendar year through September 30. Leave empty for the latest fiscal year only. Selecting multiple years can take several minutes in aggregate modes because each selected DOL file must be scanned before final rankings or percentiles are returned.",
                        "items": {
                            "type": "string",
                            "pattern": "^[0-9]{4}$"
                        },
                        "default": []
                    },
                    "minSalary": {
                        "title": "Minimum offered salary (USD/year)",
                        "minimum": 0,
                        "maximum": 10000000,
                        "type": "integer",
                        "description": "Skip filings with an offered annual salary below this value. 0 means no minimum.",
                        "default": 0
                    },
                    "maxSalary": {
                        "title": "Maximum offered salary (USD/year)",
                        "minimum": 0,
                        "maximum": 10000000,
                        "type": "integer",
                        "description": "Skip filings with an offered annual salary above this value. 0 means no maximum.",
                        "default": 0
                    },
                    "maxItems": {
                        "title": "Max items to return",
                        "minimum": 1,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Cap on rows returned. In bulk-export this stops after this many individual filings. In sponsor-finder, company-check, and salary-lookup it caps returned result rows after the selected source files have been scanned for accurate aggregates.",
                        "default": 25
                    },
                    "newFilingsOnly": {
                        "title": "Only return new filings since last run",
                        "type": "boolean",
                        "description": "If enabled, the actor remembers the latest filing decision date from your previous run with the same input and only returns filings newer than that. Applies to bulk-export and sponsor-finder modes.",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "The US Department of Labor public data portal usually does not require proxies. Leave the default unless your network blocks government XLSX downloads.",
                        "default": {
                            "useApifyProxy": false
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
