{
  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}