{ "openapi": "3.0.1", "info": { "title": "Estonia e-Business Register Scraper", "description": "Search Estonia's e-Business Register (ariregister.rik.ee / e-äriregister) by company name, registry code, or VAT number. Get legal form, address, VAT status, board members, shareholders, beneficial owners, EMTAK activity codes, and annual report history.", "version": "1.0", "x-build-id": "JxIzQ0HjyLvYQAJS9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~estonia-e-business-register-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-estonia-e-business-register-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~estonia-e-business-register-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-estonia-e-business-register-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~estonia-e-business-register-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-estonia-e-business-register-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": "Mode", "enum": [ "search", "byRegCode" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Company name, registry code, or VAT number. Matches Estonia's official Autocomplete service (same one used by the ariregister.rik.ee search box).", "default": "Swedbank" }, "regCodes": { "title": "Registry codes (mode=byRegCode)", "type": "array", "description": "Estonian company registry codes (6-9 digits), e.g. `10060701`.", "default": [], "items": { "type": "string" } }, "statuses": { "title": "Status filter (mode=search)", "uniqueItems": true, "type": "array", "description": "Restrict search results to one or more registration statuses. Empty = no filter. Applied client-side; the upstream Autocomplete service mainly surfaces active/liquidating entities.", "items": { "type": "string", "enum": [ "R", "L", "N", "K" ], "enumTitles": [ "Entered into the register (active)", "In liquidation", "In bankruptcy", "Deleted" ] }, "default": [] }, "legalFormIds": { "title": "Legal form filter (mode=search)", "uniqueItems": true, "type": "array", "description": "Restrict search results to one or more legal forms. Empty = no filter. Applied client-side.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "10", "11", "12", "17", "18", "20", "21", "22", "23", "24", "25", "26" ], "enumTitles": [ "Public limited company (AS)", "General partnership (TÜ)", "Sole trader (FIE)", "Limited partnership (UÜ)", "Private limited company (OÜ)", "Commercial co-operative (TÜH)", "Non-profit association (MTÜ)", "Foundation (SA)", "Branch of a foreign company (FIL)", "European Economic Interest Grouping (EEIG)", "European Company (SE)", "European Cooperative Society (SCE)", "European grouping of territorial cooperation (TKR)", "Agency of the Executive or other state institution (TRAS)", "Legal person in public law / constitutional institution (AVOIG)", "Agency of local authority (KOVAS)", "Apartment association (KÜ)", "Land improvement association (MPÜ)", "Political party (ERAK)", "Trade union (AMETÜ)" ] }, "default": [] }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on emitted records. Note: mode=search is capped at 10 by the upstream Autocomplete service regardless of this value.", "default": 10 } } }, "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 } } } } } } } } } }