{ "openapi": "3.0.1", "info": { "title": "Czech Company Data API: ARES Register Search", "description": "Czech companies from the official ARES register (Ministry of Finance). Search by name, ICO, legal form, NACE code, tax office or address. Returns ICO, VAT id, address, legal form, dates, register status. CC BY 4.0.", "version": "0.1", "x-build-id": "jQSw9LvOlBedG3rn2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/smoked_drift~czech-company-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-smoked_drift-czech-company-data", "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/smoked_drift~czech-company-data/runs": { "post": { "operationId": "runs-sync-smoked_drift-czech-company-data", "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/smoked_drift~czech-company-data/run-sync": { "post": { "operationId": "run-sync-smoked_drift-czech-company-data", "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": { "name": { "title": "Company name", "type": "string", "description": "Full or partial company name as registered, e.g. 'Asseco' or 'Stavebni'." }, "ico": { "title": "ICO numbers", "type": "array", "description": "Czech company identification numbers, 8 digits, e.g. 27074358. The fastest and most precise path.", "items": { "type": "string" } }, "legalForm": { "title": "Legal form codes", "type": "array", "description": "Czech legal form codes: 121 for a.s. (joint stock), 112 for s.r.o. (limited), 101 for sole trader, 421 for a foreign entity branch.", "items": { "type": "string" } }, "naceCodes": { "title": "CZ-NACE codes", "type": "array", "description": "Czech NACE activity codes, e.g. 62010 for computer programming, 41200 for building construction.", "items": { "type": "string" } }, "taxOffice": { "title": "Tax office codes", "type": "array", "description": "Czech tax office code, e.g. 451 for the Prague tax office.", "items": { "type": "string" } }, "addressText": { "title": "Address contains", "type": "string", "description": "Free-text match on the registered address, e.g. 'Praha' or 'Brno'." }, "municipalityCode": { "title": "Municipality code", "type": "string", "description": "Czech municipality code (kodObce), e.g. 554782 for Prague." }, "districtCode": { "title": "District code", "type": "string", "description": "Czech district code (kodOkresu)." }, "regionCode": { "title": "Region code", "type": "string", "description": "Czech region code (kodKraje)." }, "postalCode": { "title": "Postcode", "type": "string", "description": "Czech postcode, e.g. 14000." }, "sort": { "title": "Sort", "enum": [ "ICO_VZESTUPNE", "ICO_SESTUPNE", "OBCHODNI_JMENO_VZESTUPNE", "OBCHODNI_JMENO_SESTUPNE", "DATUM_VZNIKU_VZESTUPNE", "DATUM_VZNIKU_SESTUPNE" ], "type": "string", "description": "Order of the results." }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Rows per request. Leave at the default unless you are debugging.", "default": 100 }, "maxItems": { "title": "Maximum companies", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on returned companies. ARES refuses any single query whose result set exceeds 1000 records, so slice by name, region or legal form to go deeper.", "default": 1000 } } }, "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 } } } } } } } } } }