{ "openapi": "3.0.1", "info": { "title": "Czech Company Registry Scraper — ARES B2B Leads", "description": "Scrape ARES — the Czech Republic's official company registry (Ministry of Finance). Get IČO, VAT (DIČ), legal form, CZ-NACE industry, full address, dates & active status. Filter by name, IČO, legal form, NACE, municipality & postcode. No login, no API key.", "version": "1.0", "x-build-id": "SLZpgp73BqqAzgFj9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~czech-company-registry-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-czech-company-registry-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/logiover~czech-company-registry-scraper/runs": { "post": { "operationId": "runs-sync-logiover-czech-company-registry-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/logiover~czech-company-registry-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-czech-company-registry-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": { "obchodniJmeno": { "title": "Company name (obchodní jméno)", "type": "string", "description": "Free-text company name search, mapped to the ARES `obchodniJmeno` param. Leave empty to use the more specific filters below. Example: \"software\", \"technologie\", \"stavební\"." }, "ico": { "title": "IČO (company ID)", "type": "string", "description": "Look up specific companies by Czech business ID (IČO). One 8-digit IČO, or several comma-separated, e.g. \"45274649\" or \"45274649,27082440\"." }, "pravniForma": { "title": "Legal form code (právní forma)", "type": "string", "description": "Restrict to a legal form code, e.g. 112 = s.r.o. (limited company), 121 = a.s. (joint-stock), 101 = sole trader (OSVČ). Comma-separate several. Leave empty for all." }, "czNace": { "title": "CZ-NACE industry code", "type": "string", "description": "Filter by CZ-NACE industry code, e.g. 6201 (computer programming), 7311 (advertising), 4711 (retail). Comma-separate several. Leave empty for all industries." }, "kodObce": { "title": "Municipality code (kód obce)", "minimum": 0, "type": "integer", "description": "Filter by municipality code, e.g. 554782 = Praha, 582786 = Brno, 554821 = Ostrava. Leave empty for the whole country." }, "psc": { "title": "Postcode (PSČ)", "minimum": 0, "type": "integer", "description": "Filter by registered-address postcode (digits only, no space), e.g. 11000 (Praha 1), 60200 (Brno)." }, "nazevObce": { "title": "Municipality name (název obce)", "type": "string", "description": "Filter by municipality name, e.g. \"Praha\", \"Brno\", \"Plzeň\". Use either this or the municipality code." }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many companies. 0 = unlimited (note: ARES hard-caps each query at 1000 results — narrow your filters by municipality / NACE / legal form to cover more).", "default": 200 }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route requests through Apify Proxy (datacenter by default). The ARES API is open, so you can turn this off to go direct, but keeping proxy on is stable and recommended.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Datacenter is plenty for the open ARES API.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }