{ "openapi": "3.0.1", "info": { "title": "Poland KRZ National Debtor Registry Scraper", "description": "Search Polish National Debtor Registry (KRZ) for bankruptcy, restructuring & enforcement proceedings. No public API exists — only programmatic access. 9 search modes. MGBI alternative without subscription. KYC/AML compliance. Pay per use.", "version": "1.0", "x-build-id": "nRwk8I1z1YdEyD7wY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/regdata~krz-debtor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-regdata-krz-debtor-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/regdata~krz-debtor-scraper/runs": { "post": { "operationId": "runs-sync-regdata-krz-debtor-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/regdata~krz-debtor-scraper/run-sync": { "post": { "operationId": "run-sync-regdata-krz-debtor-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": { "searchMode": { "title": "Search Mode", "enum": [ "entity", "person", "soleTrader", "signature", "announcements", "shareholders", "bankruptcyEstate", "advisors", "proceedingDetails" ], "type": "string", "description": "What to search for. 'entity' = companies by name/KRS/NIP. 'person' = natural persons by PESEL/NIP. 'soleTrader' = sole traders by name/identifier. 'signature' = by court case signature. 'announcements' = court announcements. 'shareholders' = partners in personal companies. 'bankruptcyEstate' = assets for sale from bankruptcy estates. 'advisors' = licensed restructuring advisors. 'proceedingDetails' = deep-dive into a specific proceeding.", "default": "entity" }, "entityName": { "title": "Entity/Company Name", "type": "string", "description": "Company name, business name, or advisor surname (partial match). Used for entity, soleTrader, announcements, shareholders, bankruptcyEstate, and advisors modes." }, "identifier": { "title": "Identifier (KRS/NIP/REGON/PESEL)", "type": "string", "description": "Entity identifier: KRS (10 digits), NIP, REGON. For persons: PESEL or NIP. For advisors: license number." }, "caseSignature": { "title": "Case Signature (Sygnatura)", "type": "string", "description": "Court case signature in format: CODE/REPERTORY/NUMBER/YEAR (e.g., WA1M/GU/223/2021). Used for signature and announcements modes." }, "proceedingId": { "title": "Proceeding ID", "type": "string", "description": "Internal proceeding UUID (from a previous entity/person search result). Used for proceedingDetails mode to get full case info." }, "estateType": { "title": "Estate Asset Type", "enum": [ "", "nieruchomosc", "ruchomosc", "prawo-majatkowe", "naleznosc", "srodek-pieniezny" ], "type": "string", "description": "Filter bankruptcy estate by asset type. Only used in bankruptcyEstate mode.", "default": "" }, "advisorCity": { "title": "Advisor City", "type": "string", "description": "Filter restructuring advisors by city. Only used in advisors mode." }, "dateFrom": { "title": "Date From", "type": "string", "description": "Start date for announcement search (YYYY-MM-DD). Only used in announcements mode." }, "dateTo": { "title": "Date To", "type": "string", "description": "End date for announcement search (YYYY-MM-DD). Only used in announcements mode." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of results to return. Default: 100. Set to 0 for unlimited.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Required. KRZ is behind an Incapsula WAF that blocks datacenter IPs and direct connections, so a residential or 4G proxy is needed. Apify Residential (PL) is used by default and works on PAID plans (any group you pick is forced to RESIDENTIAL). FREE plans do not include Residential proxy: in that case paste your own Polish residential/4G proxy under 'Custom proxies' - it works on any plan. If neither is available the run ends with a clear message instead of failing.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } } } }, "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 } } } } } } } } } }