{ "openapi": "3.0.1", "info": { "title": "Poland KRS Scraper & Bulk Company Lookup - Court Register", "description": "Bulk lookup of Polish companies, foundations and associations by KRS number from the Ministry of Justice open API: name, legal form, NIP, REGON, address, share capital, PKD, board and shareholders, liquidation, suspension and arrears flags, and struck-off entities with their deletion date.", "version": "0.1", "x-build-id": "fAL4S8olJXRVS3K4I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~poland-krs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-poland-krs-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/neverempty~poland-krs-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-poland-krs-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/neverempty~poland-krs-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-poland-krs-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", "properties": { "krsNumbers": { "title": "KRS numbers", "type": "array", "description": "One KRS number per line: 0000028860, 0000-028-860 and 28860 are the same entity (numbers are zero-padded to 10 digits before they are sent). A number with a decimal point (28860.0, which is what a spreadsheet or pandas writes for a numeric column) is refused with a reason and not charged, because dropping the point would look up 0000288600 - a different company that really exists. Only the KRS number can be looked up; the register's API has no search by name, NIP or REGON. A number given twice is looked up and charged once. Up to 2,000 per run (1,000 with fullExtract) so one run finishes within Apify's default one-hour limit; any beyond that are listed in an uncharged row as not looked up. If left empty, ORLEN S.A. (0000028860) is looked up as an example and the log says so.", "items": { "type": "string" } }, "registry": { "title": "Register", "enum": [ "P", "S" ], "type": "string", "description": "P = register of entrepreneurs (companies, cooperatives, foreign branches); S = register of associations, foundations, other social and professional organisations and public healthcare institutions. A number is in only one of them. If it is not found in the chosen register the other one is tried, and the registry column says where it was found.", "default": "P" }, "fullExtract": { "title": "Also read the full extract (entry history)", "type": "boolean", "description": "When on, the full extract (odpis pełny) is read as well and each row also carries the list of all register entries (number, description, date, court, case number) and the previous names of the entity. This doubles the requests per number and halves the per-run limit to 1,000. The current data is the same either way. Entities struck off the register are always read from the full extract, whatever this setting.", "default": false }, "maxResults": { "title": "Maximum lookups per run", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop after this many KRS numbers have been looked up; the rest are listed in an uncharged row. Capped at 2,000 (1,000 with fullExtract); a value below 1 is treated as 1.", "default": 2000 } } }, "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 } } } } } } } } } }