{
"openapi": "3.0.1",
"info": {
"title": "Illinois SOS Business Search - LLCs, Corps & Agents",
"description": "Search the Illinois Secretary of State business register by company name or file number, or list newly organized Illinois LLCs and corporations by date. Status, type, dates, registered agent, managers and officers. No API key needed.",
"version": "0.1",
"x-build-id": "vN9TBAxn4BqVKv0Co"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/regdata~illinois-sos-business-search/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-regdata-illinois-sos-business-search",
"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/regdata~illinois-sos-business-search/runs": {
"post": {
"operationId": "runs-sync-regdata-illinois-sos-business-search",
"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/regdata~illinois-sos-business-search/run-sync": {
"post": {
"operationId": "run-sync-regdata-illinois-sos-business-search",
"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",
"properties": {
"mode": {
"title": "What to do",
"enum": [
"search",
"newFilings"
],
"type": "string",
"description": "Search looks up the company names or Illinois file numbers you list. New filings lists the LLCs and corporations organized in Illinois between two dates (the last 13 months) - schedule it daily with \"Only entities not delivered before\" for a feed.",
"default": "search"
},
"searchQueries": {
"title": "Search queries",
"type": "array",
"description": "Company names or 8-digit Illinois file numbers, one per line. A name matches every entity whose name contains all its words (\"LLC\", \"Inc\" and similar endings are ignored, except that an exact full name is listed first).",
"items": {
"type": "string"
}
},
"maxResultsPerQuery": {
"title": "Max results per query",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "Most entities kept per query (default 50, so a broad word does not bring thousands of records). 0 = up to 1,000.",
"default": 50
},
"entityFamilies": {
"title": "Entity types",
"type": "array",
"description": "Leave empty for both.",
"items": {
"type": "string",
"enum": [
"llc",
"corporation"
],
"enumTitles": [
"LLCs",
"Corporations (incl. not-for-profit and foreign)"
]
}
},
"onlyActive": {
"title": "Only active entities",
"type": "boolean",
"description": "Keep only entities in good standing or reinstated.",
"default": false
},
"dateFrom": {
"title": "Organized from",
"type": "string",
"description": "New filings only. YYYY-MM-DD. Default: 7 days ago. The last 13 months are available."
},
"dateTo": {
"title": "Organized to",
"type": "string",
"description": "New filings only. YYYY-MM-DD, inclusive. Default: today."
},
"onlyNewSinceLastRun": {
"title": "Only entities not delivered before",
"type": "boolean",
"description": "New filings only. Skips entities this feed already delivered, so a daily schedule with a 7-day window catches late-registered filings exactly once.",
"default": false
},
"stateStoreName": {
"title": "Feed memory store name",
"type": "string",
"description": "New filings only. Key-value store in your Apify account that remembers what was delivered. Use a different name for each independent feed.",
"default": "illinois-sos-search-state"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}