# 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:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.00 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 lightweight to run. It charges $0.04 per run (start fee, based on its 4 GB memory allocation) plus $0.012 per result scraped. 100 results costs about $1.24; 1,000 results about $12.04. A run's usage cost only settles after it reports SUCCEEDED.

### 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"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/ares-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rhkZMVCz5sfcLpTcf/builds/lJ94Xx5KODPn0Y18e/openapi.json