{ "openapi": "3.0.1", "info": { "title": "Georgia Secretary of State Business Search Scraper", "description": "Search Georgia's eCorp business registry by name, control number, registered agent or officer. Get status and good-standing flag, addresses, registered agent, officers and whether the annual registration is filed, due or late.", "version": "0.1", "x-build-id": "368rlfHEoASTkhvZ2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lautarodelgado~georgia-sos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lautarodelgado-georgia-sos-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/lautarodelgado~georgia-sos-scraper/runs": { "post": { "operationId": "runs-sync-lautarodelgado-georgia-sos-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/lautarodelgado~georgia-sos-scraper/run-sync": { "post": { "operationId": "run-sync-lautarodelgado-georgia-sos-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": [ "searchTerms" ], "properties": { "searchType": { "title": "Search by", "enum": [ "businessName", "controlNumber", "registeredAgent", "officer" ], "type": "string", "description": "Which Georgia eCorp search to use: business name, control number, registered agent name, or officer name.", "default": "businessName" }, "searchTerms": { "title": "Search terms", "minItems": 1, "type": "array", "description": "One or more business names, control numbers, agent names or officer names to look up. Georgia ignores punctuation and spaces when matching, so \"coca cola\" and \"Coca-Cola\" find the same entities.", "items": { "type": "string" } }, "nameMatch": { "title": "Name matching", "enum": [ "startsWith", "contains", "exact" ], "type": "string", "description": "How eCorp matches names (business name, agent and officer searches). 'Starts with' lists entities whose name begins with your term, 'Contains' finds the term anywhere in the name, 'Exact' needs the full name. Ignored for control number searches.", "default": "startsWith" }, "maxResultsPerSearch": { "title": "Max results per search term", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many entities for each search term (the portal lists 25 per page). Free-plan runs are capped at 10 results per run.", "default": 25 }, "activeOnly": { "title": "Active entities only", "type": "boolean", "description": "Skip dissolved, administratively dissolved, revoked and withdrawn entities.", "default": false }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Open each entity's detail page to get formation date, jurisdiction, registered agent address, officers and the last annual registration year. Turn off to get only what the list shows (name, control number, type, principal office address, agent name, status), which is faster.", "default": true }, "includeFilings": { "title": "Include filing history", "type": "boolean", "description": "Also read each entity's filing history: every annual registration with its filing date, plus all other filings (formation, amendments, address changes). Adds one to three requests per entity and needs 'Fetch full details'.", "default": false }, "proxyFallback": { "title": "Retry blocked connections another way", "type": "boolean", "description": "When Cloudflare challenges the connection, the Actor retries on a new IP and, if needed, switches to a direct connection or Apify residential IPs (only if your account has them). Turn off to stay on exactly the proxy you configured.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Georgia's portal sits behind Cloudflare, which blocks the shared Apify datacenter proxies. Leave this empty: the Actor connects directly and switches to Apify residential IPs by itself if it gets challenged. Set a residential proxy here only if you want to force it." } } }, "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 } } } } } } } } } }