# ARES Scraper - Czech Republic Company Registry Data (`studio-amba/ares-scraper`) Actor Scrape Czech company data from ARES (Administrativni registr ekonomickych subjektu). Search by company name or ICO number. Extract registration details, addresses, NACE codes, VAT numbers, and legal forms. Official Ministry of Finance API, no login required. - **URL**: https://apify.com/studio-amba/ares-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ARES Scraper - Czech Republic Company Registry Extract structured company data from ARES (Administrativni registr ekonomickych subjektu), the Czech Republic's official business register operated by the Ministry of Finance. Search by company name or look up specific companies by their ICO (identification number). Returns registration details, addresses, VAT numbers, NACE activity codes, and legal forms — all from official government sources. ### How to scrape ARES data 1. Go to this actor's page on the [Apify Store](https://apify.com/store). 2. Click **Try for free** to open the actor in Apify Console. 3. Enter a company name (e.g., `skoda`) or an ICO number (e.g., `00177041`). 4. Click **Start** and wait for the run to finish. 5. Download your data as JSON, CSV, or Excel from the **Dataset** tab. No login, cookies, or API keys required. The actor calls the official ARES REST API directly. ### Input parameters | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQuery` | String | No | Company name to search for (e.g., `skoda`, `ceska posta`) | | `ico` | String | No | 8-digit ICO number for direct lookup. Comma-separated for multiple. | | `city` | String | No | Filter results by city (e.g., `Praha`, `Brno`) | | `legalForm` | String | No | Filter by legal form code (e.g., `112` for s.r.o., `121` for a.s.) | | `czNace` | String | No | Filter by CZ-NACE economic activity code | | `activeOnly` | Boolean | No | Exclude dissolved companies (default: false) | | `maxResults` | Integer | No | Maximum results to return (default: 50, max: 1000) | | `proxyConfiguration` | Object | No | Proxy settings (Czech residential recommended) | Either `searchQuery` or `ico` must be provided. If neither is set, the actor searches for `"prague"` as a default. ### Output Each company record contains: | Field | Type | Example | |-------|------|---------| | `companyName` | String | `"Skoda Auto a.s."` | | `ico` | String | `"00177041"` | | `dic` | String | `"CZ00177041"` | | `legalForm` | String | `"Akciova spolecnost (a.s.)"` | | `legalFormCode` | String | `"121"` | | `registrationDate` | String | `"1990-11-20"` | | `dissolutionDate` | String | `""` (empty if active) | | `status` | String | `"active"` or `"dissolved"` | | `address` | String | `"tr. Vaclava Klementa 869, Mlada Boleslav II, 29301 Mlada Boleslav"` | | `street` | String | `"tr. Vaclava Klementa"` | | `houseNumber` | String | `"869"` | | `city` | String | `"Mlada Boleslav"` | | `district` | String | `"Mlada Boleslav"` | | `region` | String | `"Stredocesky kraj"` | | `postalCode` | String | `"29301"` | | `country` | String | `"Ceska republika"` | | `naceActivities` | Array | `["29100", "45200", "471"]` | | `primarySource` | String | `"ros"` | | `financialOffice` | String | `"013"` | | `lastUpdated` | String | `"2026-06-05"` | | `url` | String | ARES detail page URL | | `scrapedAt` | String | ISO 8601 timestamp | ### Example output ```json { "companyName": "Skoda Auto a.s.", "ico": "00177041", "dic": "CZ00177041", "legalForm": "Akciova spolecnost (a.s.)", "legalFormCode": "121", "registrationDate": "1990-11-20", "dissolutionDate": "", "status": "active", "address": "tr. Vaclava Klementa 869, Mlada Boleslav II, 29301 Mlada Boleslav", "street": "tr. Vaclava Klementa", "houseNumber": "869", "city": "Mlada Boleslav", "district": "Mlada Boleslav", "region": "Stredocesky kraj", "postalCode": "29301", "country": "Ceska republika", "naceActivities": ["29100", "45200", "471", "47740", "69200"], "primarySource": "ros", "financialOffice": "013", "lastUpdated": "2026-06-05", "url": "https://ares.gov.cz/ekonomicke-subjekty/00177041", "scrapedAt": "2026-06-09T12:00:00.000Z" } ```` ### What is ARES? ARES (Administrativni registr ekonomickych subjektu) is the Administrative Register of Economic Entities maintained by the Czech Ministry of Finance. It aggregates data from multiple source registers: - **ROS** (Registr osob) - Register of Persons - **VR** (Verejne rejstriky) - Public Registers (Commercial Register) - **RES** (Registr ekonomickych subjektu) - Register of Economic Entities - **RZP** (Registr zivnostenskeho podnikani) - Trade Register - **DPH** - VAT Register The ARES API is publicly available at `https://ares.gov.cz` and returns JSON responses without authentication. ### Tips for effective searching - **Specific queries work best.** The ARES API rejects searches that return more than 1,000 total results. If your query is too broad (e.g., just `"auto"`), narrow it with filters or use a more specific name. - **ICO lookup is fastest.** If you know the company's 8-digit ICO number, use the `ico` field for direct lookup — no search limitations apply. - **Combine filters.** Use `legalForm` to restrict results to specific company types (e.g., `112` for s.r.o. / LLC, `121` for a.s. / joint-stock). - **City filtering is client-side.** The `city` filter is applied after the API returns results, so the underlying search must still return fewer than 1,000 results. - **Czech diacritics are optional.** You can search for `skoda` instead of `Skoda` — the API handles it. ### Cost estimate This actor uses the official ARES REST API (no browser rendering), making it very lightweight. Approximate costs: - **~0.001 compute units per company** (API-based, no browser overhead) - **1,000 companies for approximately $0.05** at standard Apify pricing ### Limitations - The ARES API rejects search queries that would return more than 1,000 total results. Use specific names or filters. - Rate limiting: the Ministry of Finance may throttle requests exceeding 500 queries per minute. - Data accuracy depends on the source registers maintained by Czech government agencies. - NACE codes are returned as raw codes without descriptions. See the Czech Statistical Office for code definitions. - This actor scrapes publicly available data. No login or authentication is required. ### Use cases - **Business intelligence**: Research Czech companies, competitors, or potential partners - **Due diligence**: Verify company registration, legal form, and active status - **Lead generation**: Find companies by industry (NACE code) and location - **Market research**: Analyze company registrations by region, legal form, or activity - **Compliance**: Verify VAT registration numbers (DIC) for Czech trading partners # Actor input Schema ## `searchQuery` (type: `string`): Search for companies by name. Czech diacritics are supported (e.g., 'skoda', 'ceska posta'). The ARES API rejects queries returning more than 1,000 results — use specific terms or combine with filters below. ## `ico` (type: `string`): Look up one or more companies by their 8-digit ICO number. Separate multiple ICOs with commas (e.g., '00177041, 25820524'). When set, this takes priority — the actor fetches each company directly. ## `city` (type: `string`): Filter results to a specific city (e.g., 'Praha', 'Brno', 'Ostrava'). Applied after search, so the search query must still return fewer than 1,000 total results. ## `legalForm` (type: `string`): Filter by legal form code. Applied server-side via the ARES API. ## `czNace` (type: `string`): Filter by economic activity code (e.g., '6201' for software development, '4711' for retail). See https://www.czso.cz/csu/czso/klasifikace\_ekonomickych\_cinnosti\_cz\_nace for codes. ## `activeOnly` (type: `boolean`): When enabled, dissolved or inactive companies are excluded from results. ## `maxResults` (type: `integer`): Maximum number of companies to return. The ARES API allows up to 1,000 results per search query. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. Czech proxies recommended for best results. ## Actor input object example ```json { "searchQuery": "prague consulting", "activeOnly": false, "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CZ" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "prague consulting", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CZ" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/ares-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "prague consulting", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CZ", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/ares-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "prague consulting", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CZ" } }' | apify call studio-amba/ares-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/ares-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ARES Scraper - Czech Republic Company Registry Data", "description": "Scrape Czech company data from ARES (Administrativni registr ekonomickych subjektu). Search by company name or ICO number. Extract registration details, addresses, NACE codes, VAT numbers, and legal forms. Official Ministry of Finance API, no login required.", "version": "0.0", "x-build-id": "ljRasF2Pg5PJg7y6d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~ares-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-ares-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/studio-amba~ares-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-ares-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/studio-amba~ares-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-ares-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": { "searchQuery": { "title": "Search Query (Company Name)", "type": "string", "description": "Search for companies by name. Czech diacritics are supported (e.g., 'skoda', 'ceska posta'). The ARES API rejects queries returning more than 1,000 results — use specific terms or combine with filters below." }, "ico": { "title": "ICO (Identification Number)", "type": "string", "description": "Look up one or more companies by their 8-digit ICO number. Separate multiple ICOs with commas (e.g., '00177041, 25820524'). When set, this takes priority — the actor fetches each company directly." }, "city": { "title": "City Filter", "type": "string", "description": "Filter results to a specific city (e.g., 'Praha', 'Brno', 'Ostrava'). Applied after search, so the search query must still return fewer than 1,000 total results." }, "legalForm": { "title": "Legal Form", "enum": [ "", "101", "112", "121", "141", "301", "706", "801" ], "type": "string", "description": "Filter by legal form code. Applied server-side via the ARES API." }, "czNace": { "title": "CZ-NACE Activity Code", "type": "string", "description": "Filter by economic activity code (e.g., '6201' for software development, '4711' for retail). See https://www.czso.cz/csu/czso/klasifikace_ekonomickych_cinnosti_cz_nace for codes." }, "activeOnly": { "title": "Active Companies Only", "type": "boolean", "description": "When enabled, dissolved or inactive companies are excluded from results.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of companies to return. The ARES API allows up to 1,000 results per search query.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration. Czech proxies recommended for best results." } } }, "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 } } } } } } } } } } ```