{ "openapi": "3.0.1", "info": { "title": "NY Lobbying Search Scraper", "description": "Search New York State's official Lobbying Search (reports.ethics.ny.gov) - lobbyist/client relationships, subjects lobbied, parties lobbied, source-of-funding, disbursement-of-public-monies, reportable-business-relationship, and coalition-contribution filings.", "version": "1.0", "x-build-id": "QS4X5JIUs1KL230hm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ny-lobbying-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ny-lobbying-search-scraper", "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/crawlerbros~ny-lobbying-search-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ny-lobbying-search-scraper", "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/crawlerbros~ny-lobbying-search-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ny-lobbying-search-scraper", "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": "Search mode", "enum": [ "globalSearch", "subjectsLobbied", "partiesLobbied", "sourceOfFunding", "disbursementOfPublicMonies", "reportableBusinessRelationship", "coalitionContribution" ], "type": "string", "description": "Which NYS Lobbying Search tab to query.", "default": "globalSearch" }, "searchQuery": { "title": "Search name / address", "type": "string", "description": "Individual or organization name (or address) to search for. Leave blank to browse a mode's filters without a name search (all modes).", "default": "" }, "year": { "title": "Filing year", "enum": [ "ALL", "2026", "2025", "2024", "2023", "2022", "2021", "2020", "2019" ], "type": "string", "description": "Restrict results to a filing year (all modes).", "default": "ALL" }, "filerType": { "title": "Filer type (mode=globalSearch)", "enum": [ "ALL", "Lobbyist", "Client", "PC", "Coa" ], "type": "string", "description": "Restrict Global Search to a specific filer category.", "default": "ALL" }, "levelOfGovernment": { "title": "Level of government (mode=globalSearch, disbursementOfPublicMonies)", "enum": [ "ALL", "S", "L", "B" ], "type": "string", "description": "Restrict to State, Municipal, or Both levels of government.", "default": "ALL" }, "filerCategory": { "title": "Filer category (mode=subjectsLobbied, partiesLobbied)", "enum": [ "ALL", "L", "C", "P", "COA" ], "type": "string", "description": "Restrict Subjects/Parties Lobbied search to a specific filer category.", "default": "ALL" }, "subject": { "title": "Lobbying subject (mode=subjectsLobbied)", "enum": [ "ALL", "12", "23", "1", "34", "45", "90", "56", "78", "89", "67", "2", "7", "4", "3", "5", "6", "96", "8", "10", "11", "9", "17", "13", "16", "15", "14", "18", "19", "22", "20", "24", "21", "25", "94", "27", "28", "26", "29", "30", "32", "31", "33", "35", "36", "38", "43", "37", "39", "40", "42", "41", "44", "47", "48", "49", "46", "50", "52", "51", "54", "53", "95", "55", "58", "60", "59", "57", "62", "61", "65", "63", "66", "68", "64", "69", "71", "72", "70", "74", "79", "80", "75", "73", "76", "77", "83", "84", "85", "86", "81", "91", "82", "87" ], "type": "string", "description": "Fine-grained subject-matter category to search within (mode=subjectsLobbied). Sourced live from the site's own 93-value subject taxonomy.", "default": "ALL" }, "period": { "title": "Filing period (mode=subjectsLobbied, disbursementOfPublicMonies)", "enum": [ "ALL", "JF", "MA", "MJ", "JA", "SO", "ND", "JJ", "JD" ], "type": "string", "description": "Restrict to a bi-monthly filing period.", "default": "ALL" }, "filingTypeFilter": { "title": "Filing type (mode=subjectsLobbied, partiesLobbied)", "enum": [ "ALL", "R", "B", "CS" ], "type": "string", "description": "Restrict to a specific filing type.", "default": "ALL" }, "partyType": { "title": "Party lobbied type (mode=partiesLobbied)", "enum": [ "ALL", "NYSE", "NYAS", "SCOM", "ACOM", "EXEC", "AGCY", "CNTY", "CITY", "TOWN", "VILL", "ISNS", "ISID", "ISFD", "ISCD", "ISTD", "ISCH", "IDAN", "PADC" ], "type": "string", "description": "Government body/entity category to search within (mode=partiesLobbied).", "default": "ALL" }, "specificAgency": { "title": "Specific state agency (mode=partiesLobbied, partyType=AGCY)", "enum": [ "ALL", "511NY", "ADIRONDACK PARK AGENCY", "AUTHORITIES BUDGET OFFICE", "BATTERY PARK CITY AUTHORITY", "BOARD OF ELECTIONS", "BRIDGE AUTHORITY", "BUFFALO FISCAL STABILITY AUTHORITY", "CENTRAL PINE BARRENS JOINT PLANNING AND POLICY COMMISSION", "COMMISSION ON ETHICS AND LOBBYING IN GOVERNMENT", "COMMISSION ON JUDICIAL CONDUCT", "CORCRAFT PRODUCTS (DEPARTMENT OF CORRECTIONAL SERVICES, DIVISION OF INDUSTRIES)", "COUNCIL ON CHILDREN AND FAMILIES", "COUNCIL ON THE ARTS", "DEPARTMENT OF AGRICULTURE AND MARKETS", "DEPARTMENT OF EDUCATION", "DEPARTMENT OF HEALTH", "DEPARTMENT OF LABOR", "DEPARTMENT OF MOTOR VEHICLES", "DEPARTMENT OF PUBLIC SERVICE", "DEPARTMENT OF STATE", "DEPARTMENT OF TAXATION AND FINANCE", "DEPARTMENT OF TRANSPORTATION", "DEVELOPMENTAL DISABILITIES PLANNING COUNCIL", "DIVISION OF CONSUMER PROTECTION", "DIVISION OF CRIMINAL JUSTICE SERVICES", "DIVISION OF HOMELAND SECURITY AND EMERGENCY SERVICES", "DIVISION OF HUMAN RIGHTS", "DIVISION OF MILITARY AND NAVAL AFFAIRS", "DIVISION OF STATE POLICE", "DIVISION OF TAX APPEALS AND TAX APPEALS TRIBUNAL", "DIVISION OF THE BUDGET", "DIVISION OF VETERANS' AFFAIRS", "DORMITORY AUTHORITY", "EMPIRE STATE DEVELOPMENT", "ENERGY RESEARCH AND DEVELOPMENT AUTHORITY", "ENVIRONMENTAL FACILITIES CORPORATION", "ERIE COUNTY FISCAL STABILITY AUTHORITY", "FINANCIAL CONTROL BOARD", "GAMING COMMISSION", "GEOGRAPHIC INFORMATION SYSTEMS (GIS) CLEARINGHOUSE", "GOVERNOR'S OFFICE OF EMPLOYEE RELATIONS", "GOVERNOR'S TRAFFIC SAFETY COMMITTEE", "HIGHER EDUCATION SERVICES CORPORATION", "HOMES AND COMMUNITY RENEWAL", "HOUSING FINANCE AGENCY/STATE OF NY MORTGAGE AGENCY (SONYMA)", "HUDSON RIVER VALLEY GREENWAY", "INDEPENDENT REDISTRICTING COMMISSION (NYS) (NYIRC)", "JACOB K. JAVITS CONVENTION CENTER", "JOINT COMMISSION ON PUBLIC ETHICS", "JOINT SECURITY OPERATIONS CENTER", "JUSTICE CENTER FOR THE PROTECTION OF PEOPLE WITH SPECIAL NEEDS", "LIQUIDATION BUREAU", "LIQUOR AUTHORITY, DIVISION OF ALCOHOLIC BEVERAGE CONTROL", "MICRON COMMUNITY ENGAGEMENT COMMITTEE", "MTA INSPECTOR GENERAL", "NASSAU COUNTY INTERIM FINANCE AUTHORITY", "NEW YORK STATE INSURANCE FUND", "NEW YORK STATE LAW REVISION COMMISSION", "NEW YORK STATE OF HEALTH MARKETPLACE", "NYC 311", "NYC DEPARTMENT OF PROBATION", "NYGOV", "NYS CANAL CORPORATION", "NYS COMMISSION OF CORRECTION", "NYS COMMISSION OF CORRECTION (SCOC)", "NYS DEPARTMENT OF CIVIL SERVICE", "NYS DEPARTMENT OF CORRECTIONS AND COMMUNITY SUPERVISION", "NYS DEPARTMENT OF ENVIRONMENTAL CONSERVATION", "NYS DEPARTMENT OF FINANCIAL SERVICES", "NYS FRANCHISE OVERSIGHT BOARD", "NYS METROPOLITAN TRANSPORTATION AUTHORITY", "NYS TEACHERS' RETIREMENT SYSTEM", "NYS TUG HILL COMMISSION", "NYS UNEMPLOYMENT INSURANCE APPEALS BOARD", "OFFICE FOR NEW AMERICANS", "OFFICE FOR PEOPLE WITH DEVELOPMENTAL DISABILITIES", "OFFICE FOR THE AGING", "OFFICE FOR THE PREVENTION OF DOMESTIC VIOLENCE", "OFFICE OF ADDICTION SERVICES AND SUPPORTS", "OFFICE OF ATTORNEY GENERAL", "OFFICE OF CANNABIS MANAGEMENT", "OFFICE OF CHILDREN AND FAMILY SERVICES", "OFFICE OF COUNTER TERRORISM", "OFFICE OF COURT ADMINISTRATION (OCA)", "OFFICE OF EMERGENCY MANAGEMENT", "OFFICE OF FIRE PREVENTION AND CONTROL", "OFFICE OF GENERAL SERVICES", "OFFICE OF INDIGENT LEGAL SERVICES (NYS)", "OFFICE OF INFORMATION TECHNOLOGY SERVICES", "OFFICE OF INTEROPERABLE AND EMERGENCY COMMUNICATIONS (OIEC)", "OFFICE OF MEDICAID INSPECTOR GENERAL", "OFFICE OF MENTAL HEALTH", "OFFICE OF PARKS, RECREATION AND HISTORIC PRESERVATION", "OFFICE OF RENEWABLE ENERGY SITING", "OFFICE OF STATE COMPTROLLER", "OFFICE OF TEMPORARY AND DISABILITY ASSISTANCE", "OFFICE OF THE INSPECTOR GENERAL", "OFFICE OF THE WELFARE INSPECTOR GENERAL", "OFFICE OF VICTIM SERVICES", "OLYMPIC REGIONAL DEVELOPMENT AUTHORITY", "PORT AUTHORITY OF NEW YORK AND NEW JERSEY", "POWER AUTHORITY", "ROOSEVELT ISLAND OPERATING CORPORATION OF THE STATE OF NEW YORK (RIOC)", "SOUTH SHORE ESTUARY COUNCIL", "STATE EMPLOYEES FEDERATED APPEAL (SEFA)", "STATE UNIVERSITY CONSTRUCTION FUND", "STATE UNIVERSITY OF NEW YORK (SUNY)", "THE PUBLIC EMPLOYMENT RELATIONS BOARD (PERB)", "THRUWAY AUTHORITY", "WORKERS COMPENSATION BOARD" ], "type": "string", "description": "Narrow Parties Lobbied search to lobbying activity directed at one specific state agency/authority. Only applied when Party lobbied type = State Agency; ignored otherwise.", "default": "ALL" }, "communicationType": { "title": "Lobbying communication type (mode=partiesLobbied)", "enum": [ "ALL", "D", "G", "B", "M" ], "type": "string", "description": "Restrict to a specific type of lobbying communication.", "default": "ALL" }, "sourceType": { "title": "Source type (mode=sourceOfFunding, coalitionContribution)", "enum": [ "ALL", "S", "M", "N" ], "type": "string", "description": "Restrict to funding sources reported as Single, Multiple, or Not Required to Report.", "default": "ALL" }, "relationshipType": { "title": "Relationship type (mode=reportableBusinessRelationship)", "enum": [ "ALL", "Entity", "SP" ], "type": "string", "description": "Restrict Reportable Business Relationship search to Entity or State Person relationships.", "default": "ALL" }, "employedBy": { "title": "State person employed by (mode=reportableBusinessRelationship)", "enum": [ "ALL", "Assembly", "Exec", "Senate", "Agency" ], "type": "string", "description": "Restrict to state persons employed by a specific government body.", "default": "ALL" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "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 } } } } } } } } } }