{
  "openapi": "3.0.1",
  "info": {
    "title": "H1B Visa Sponsor Lookup (US & UK Sponsor Licence, No Login)",
    "description": "Find out which companies sponsor H-1B visas: certified H1B and E-3 filings by year, denials, top job titles with median wage and wage level, PERM green-card cases and UK sponsor licence status. Official US and UK government data, no login. No match is free. $2.50 per 1,000 records.",
    "version": "0.2",
    "x-build-id": "tLmkn0wKZOhzCXOQc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/locaihost~visa-sponsors/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-locaihost-visa-sponsors",
        "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/locaihost~visa-sponsors/runs": {
      "post": {
        "operationId": "runs-sync-locaihost-visa-sponsors",
        "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/locaihost~visa-sponsors/run-sync": {
      "post": {
        "operationId": "run-sync-locaihost-visa-sponsors",
        "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": [
          "companies"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "employers",
              "jobs"
            ],
            "type": "string",
            "description": "Employers: one sponsorship profile per company (H-1B, PERM, UK licence). Jobs: live openings from the company's careers board, each annotated with sponsorship evidence.",
            "default": "employers"
          },
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "One per line. Employers mode: a company name (Google, Tata Consultancy Services) or domain (microsoft.com). Jobs mode: a board name (airbnb), careers-board URL (jobs.lever.co/spotify) or ats:token (ashby:ramp). Up to 500.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many records (employer profiles or jobs). 0 = no limit. Free-plan runs stop at 50 records.",
            "default": 0
          },
          "nameMappings": {
            "title": "Name mappings (optional)",
            "type": "array",
            "description": "Pin a company to exact legal filing names, one per line: Company = Legal name | Other legal name. Example: Meta = Meta Platforms, Inc. Mapped companies match only those names (US and UK), no fuzzy matching.",
            "items": {
              "type": "string"
            }
          },
          "minMatchScore": {
            "title": "Minimum name-match score",
            "minimum": 0.6,
            "maximum": 1,
            "type": "number",
            "description": "0.6–1. 1 = exact legal name only (after removing Inc/LLC/Ltd). 0.8 also includes entities that start with the name plus up to two words (Deloitte Consulting, Amazon Web Services). Every match is listed with its score. Jobs mode always matches board names strictly (exact name, a built-in alias or your name mapping); near-misses are listed as possibleMatches only.",
            "default": 0.8
          },
          "includeUk": {
            "title": "Include UK sponsor licence",
            "type": "boolean",
            "description": "Look the company up in the UK Home Office register of licensed sponsors (rating, routes, town).",
            "default": true
          },
          "ukRegisterSource": {
            "title": "UK register source",
            "enum": [
              "live",
              "bundled"
            ],
            "type": "string",
            "description": "Live downloads today's register from gov.uk (about 11 MB). Bundled uses the snapshot shipped with the Actor (dated in the output).",
            "default": "live"
          },
          "maxJobTitles": {
            "title": "Job titles per employer",
            "minimum": 1,
            "maximum": 40,
            "type": "integer",
            "description": "Employers mode: how many top H-1B job titles (with wage percentiles) to return.",
            "default": 15
          },
          "benchmarkTitles": {
            "title": "Employers mode: salary benchmark titles (optional)",
            "type": "array",
            "description": "Job titles to benchmark, e.g. Software Engineer, Data Scientist. The job-title list then shows only the employer's filed H-1B titles that are similar to these, each with its wage-level mix (I–IV) and median wage. Leave empty for the most-filed titles. Up to 50.",
            "items": {
              "type": "string"
            }
          },
          "titleKeywords": {
            "title": "Jobs mode: title contains",
            "type": "array",
            "description": "Keep jobs whose title contains ANY of these words, e.g. engineer, data, designer.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Jobs mode: locations",
            "type": "array",
            "description": "Keep jobs whose location contains ANY of these, e.g. New York, London, US, GB, Remote.",
            "items": {
              "type": "string"
            }
          },
          "departments": {
            "title": "Jobs mode: departments",
            "type": "array",
            "description": "Keep jobs whose department or team contains ANY of these, e.g. Engineering.",
            "items": {
              "type": "string"
            }
          },
          "postedWithinDays": {
            "title": "Jobs mode: posted within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Only jobs posted in the last N days. 0 = any age.",
            "default": 0
          },
          "remoteOnly": {
            "title": "Jobs mode: fully remote only",
            "type": "boolean",
            "description": "Only jobs marked fully remote.",
            "default": false
          },
          "onlyWithSponsorEvidence": {
            "title": "Jobs mode: only jobs with sponsorship evidence",
            "type": "boolean",
            "description": "Skip jobs whose employer has no H-1B/PERM filings and no UK sponsor licence.",
            "default": false
          },
          "minSponsorScore": {
            "title": "Jobs mode: minimum evidence score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Skip jobs whose sponsorship-evidence score (0–100, from past filings) is below this. 0 = keep every job. For US jobs, filings for other titles score at most 40, so above 40 means the employer has filed for similar titles. UK jobs at a licensed sponsor score 50 or more.",
            "default": 0
          },
          "includeDescription": {
            "title": "Jobs mode: include full description",
            "type": "boolean",
            "description": "Plain-text job description (contact details removed). Off = smaller, faster exports.",
            "default": 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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}