# Estonia Company Register Scraper (e-Business Register) (`studio-amba/ariregister-ee-scraper`) Actor

Extract Estonian companies from the official e-Business Register open data (ariregister.rik.ee): registry code, name, legal form, VAT number, status, registration date and address for about 380,000 legal entities. No login, no API key.

- **URL**: https://apify.com/studio-amba/ariregister-ee-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Business, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Estonia Company Register Scraper (e-Business Register)

Extract Estonian companies from the official e-Business Register open data at [ariregister.rik.ee](https://ariregister.rik.ee). Each record has the registry code, name, legal form, VAT number, status, date of first registration and address. The register file covers about 380,000 legal entities: private limited companies, public limited companies, sole proprietors, non-profit associations, apartment associations, branches of foreign companies and public bodies. No login, no API key, no proxy.

The Centre of Registers and Information Systems (RIK) publishes the file under the Creative Commons Attribution 4.0 licence and rebuilds it once a day. Every record carries a `source` field with the attribution.

### How to scrape Estonia company register data

The actor downloads the basic-data file that RIK publishes for the e-Business Register, reads it row by row and returns the rows that match your filters. A run takes about 10 to 20 seconds, whatever the filters are, because the file is read in full each time.

#### Look up companies by registry code

Put one or more 8-digit registry codes in **Registry codes**. Example: `10421629`. This is the fastest way to check a list of known companies, for example for KYB or onboarding.

#### Search by name, legal form or location

- **Company name contains** matches part of the name, case-insensitive. `Tallinna` returns every company with Tallinna in its name.
- **Legal forms** accepts the Estonian name or the English name. `Osaühing` and `Private limited company` give the same result.
- **Address contains** matches county, city, district and street. `Tartu`, `Pärnu` and `Harju maakond` all work.
- **Status** takes `R` (entered into the register), `L` (in liquidation) or `N` (in bankruptcy).

#### Find new companies and VAT-registered companies

Set **First registered on or after** to a date like `2026-01-01` to list new companies. Turn on **Only companies with a VAT number** to leave out companies that are not VAT registered. About a third of the companies in the register have a VAT number.

#### Limit the size of a run

**Max results** is a hard cap between 1 and 100,000. The actor stops reading as soon as it has that many matches.

### What data does the Estonia Company Register Scraper extract?

| Field | Description |
|---|---|
| `registryCode` | 8-digit Estonian registry code (registrikood) |
| `name` | Registered company name |
| `legalForm` | Legal form in Estonian, for example Osaühing |
| `legalFormEnglish` | Legal form in English, for example Private limited company |
| `legalFormSubtype` | Legal form subtype where the register gives one |
| `vatNumber` | Estonian VAT number (KMKR), null when the company is not VAT registered |
| `status` | Status code: R, L or N |
| `statusText` | Status as written by the register, in Estonian |
| `firstRegisteredAt` | Date of first entry in the register, YYYY-MM-DD |
| `address` | Full address with county, city, district, street and number |
| `street` | Street and building number |
| `postalCode` | Postal code |
| `locality` | District, city and county |
| `localityCode` | EHAK administrative unit code |
| `country` | Always EE |
| `url` | Company page on ariregister.rik.ee |
| `source` | Data source and licence |
| `scrapedAt` | ISO timestamp of the scrape |

### Example output

```json
{
  "registryCode": "17292875",
  "name": "OÜ Tallinna Pesumaja",
  "legalForm": "Osaühing",
  "legalFormEnglish": "Private limited company",
  "legalFormSubtype": null,
  "vatNumber": "EE102885482",
  "status": "R",
  "statusText": "Registrisse kantud",
  "firstRegisteredAt": "2025-07-31",
  "address": "Harju maakond, Tallinn, Kesklinna linnaosa, Mere pst 8",
  "street": "Mere pst 8",
  "postalCode": "10111",
  "locality": "Kesklinna linnaosa, Tallinn, Harju maakond",
  "localityCode": "0298",
  "country": "EE",
  "url": "https://ariregister.rik.ee/est/company/17292875",
  "source": "ariregister.rik.ee open data (CC BY 4.0)",
  "scrapedAt": "2026-10-20T21:40:00.000Z"
}
```

### Input examples

Look up two companies by registry code:

```json
{ "registryCodes": ["10421629", "11694365"] }
```

New VAT-registered private limited companies in Tartu since the start of 2026:

```json
{
  "legalForms": ["Osaühing"],
  "locationContains": "Tartu",
  "hasVatNumber": true,
  "registeredAfter": "2026-01-01",
  "maxResults": 5000
}
```

Companies in liquidation or bankruptcy:

```json
{ "statuses": ["L", "N"], "maxResults": 10000 }
```

### Use cases

- KYB and onboarding checks against the official register.
- Lead lists of new Estonian companies, filtered by city or legal form.
- Monitoring companies that enter liquidation or bankruptcy.
- Matching a customer or supplier list to registry codes and VAT numbers.
- Enriching Baltic company datasets next to the Latvian and Lithuanian registers.

### How much does it cost?

The actor is billed per result: a small fee per run start and a fee per company returned, less on higher plans. Maximum results per run: 100,000 (set by **Max results**). A run reads the full register file, which takes 10 to 20 seconds and a few cents of compute at most. The usage cost of a run settles after the run has SUCCEEDED, so it does not show on a run that is still in progress.

### Data source and limits

The data is the basic-data open dataset of the Estonian e-Business Register. It lists legal entities currently in the register, with status entered into the register, in liquidation or in bankruptcy. Companies that have been deleted from the register are not in the file. The file is rebuilt once a day, so a change made in the register today shows up in the next day's data.

The dataset holds basic data only. It does not include annual reports, board members, shareholders or beneficial owners. Contact details and business activity codes are not in this dataset either.

If RIK changes the layout of the file, the actor stops with an error that names the missing column instead of returning partial data.

### FAQ

**Is this data official?**
Yes. It comes from the Estonian e-Business Register, run by the Centre of Registers and Information Systems.

**Can I use the data commercially?**
The dataset is published under Creative Commons Attribution 4.0, which allows commercial use with attribution. Each record carries a `source` field with the attribution text. Check the current licence terms at avaandmed.ariregister.rik.ee if you build a product on the data.

**How many companies does it cover?**
About 380,000 legal entities. About 370,000 are entered into the register, about 8,800 are in liquidation and about 700 are in bankruptcy.

**Does a search return companies with a different spelling of the name?**
No. The name filter matches the text as it is written in the register, case-insensitive. Estonian letters such as ä, ö, ü and õ must be typed as they appear in the name.

**Why did my run return nothing?**
The actor read the whole file and found no company that matches all filters. Filters combine with AND, so remove one and run again.

**Does it need a proxy?**
No. The register serves the file to any IP.

### Support

If a field is empty that you expect to be filled, or the register changes its file format, open an issue on the actor page with the run link.

# Actor input Schema

## `nameContains` (type: `string`):

Keep only companies whose name contains this text, case-insensitive. Example: 'Tallinna', 'Bolt', 'pank'.

## `registryCodes` (type: `array`):

Look up specific companies by their 8-digit Estonian registry code. Example: 10421629. Leave empty to search by the other filters. Up to 1,000 codes per run.

## `legalForms` (type: `array`):

Keep only these legal forms, in Estonian or English. Example: 'Osaühing' or 'Private limited company', 'Aktsiaselts' or 'Public limited company', 'Mittetulundusühing' or 'Non-profit association'.

## `statuses` (type: `array`):

Keep only companies with these status codes. R = entered into the register, L = in liquidation, N = in bankruptcy. Leave empty for all.

## `locationContains` (type: `string`):

Keep only companies whose address contains this text, case-insensitive. Matches county, city, district and street. Example: 'Tartu', 'Pärnu', 'Harju maakond'.

## `hasVatNumber` (type: `boolean`):

Off by default. When on, companies without an Estonian VAT (KMKR) number are left out.

## `registeredAfter` (type: `string`):

Keep only companies first entered in the register on or after this date, format YYYY-MM-DD. Example: 2025-01-01 for new companies.

## `registeredBefore` (type: `string`):

Keep only companies first entered in the register on or before this date, format YYYY-MM-DD.

## `maxResults` (type: `integer`):

Hard cap on the number of companies returned (1 to 100,000). The actor stops as soon as it has this many matches. The cost of a run is this number times the per-result price.

## `proxyConfiguration` (type: `object`):

Not required. The register serves its open data file to any IP. The field is accepted so that saved inputs from other actors keep working.

## Actor input object example

```json
{
  "nameContains": "Tallinna",
  "hasVatNumber": false,
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 = {
    "nameContains": "Tallinna",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/ariregister-ee-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 = {
    "nameContains": "Tallinna",
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/ariregister-ee-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 '{
  "nameContains": "Tallinna",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/ariregister-ee-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/ariregister-ee-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/ZybZtaIt4AHtltKK5/builds/SY2CcBw9Omfmlvc2v/openapi.json
