# Ireland Company Register Scraper (CRO) (`studio-amba/cro-ie-scraper`) Actor

Extract Irish companies from the official Companies Registration Office (CRO) open data: company number, name, status, type, registration and dissolution dates, annual return and accounts dates, address and Eircode for about 830,000 companies. No login, no API key.

- **URL**: https://apify.com/studio-amba/cro-ie-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

## Ireland Company Register Scraper (CRO)

Extract Irish companies from the official open data of the Companies Registration Office (CRO) at [opendata.cro.ie](https://opendata.cro.ie/dataset/companies). Each record has the company number, name, status, company type, registration date, dissolution date, annual return and accounts dates, registered address and Eircode. The file covers about 830,000 companies: about 324,000 active (status Normal) and the rest dissolved, struck off or in liquidation. No login, no API key, no proxy.

The CRO publishes the Company Records file under the Creative Commons Attribution 4.0 licence and rebuilds it every day. Every record carries a `source` field with the attribution text the CRO asks for.

### How to scrape Ireland company register data

The actor downloads the daily Company Records file from the CRO open data portal, reads it row by row and returns the rows that match your filters. A run takes about 10 to 30 seconds, because the file is read in full on every run.

#### Look up companies by company number

Put one or more CRO company numbers in **Company numbers**. Example: `104547` (Ryanair DAC). This is the fastest way to check a list of known companies, for example for KYB, supplier onboarding or CRM clean-up.

#### Search by company name

**Company name contains** matches part of the name, case-insensitive. Results are ranked:

1. The text is a whole word of the name (`Tesco` finds TESCO IRELAND LIMITED).
2. A word of the name starts with the text.
3. The text only occurs inside a word.

Within each group, active companies (status Normal) come first.

#### Filter by status, type, address and date

- **Company status** keeps companies whose status starts with one of your values. `Normal` gives active companies only. Other values: `Dissolved`, `Liquidation`, `Strike Off Listed`, `Struck Off`, `Examinership`, `Receivership`, `Administration`.
- **Company types** keeps companies whose type contains one of your values: `LTD`, `DAC`, `CLG`, `PLC`, `ULC`, `External company`.
- **Address contains** matches the registered address and the Eircode: `Cork`, `Dublin 2`, `Galway`, `D02`.
- **Registered on or after** and **Registered on or before** take a date in the form `YYYY-MM-DD`.

#### Limit the size of a run

**Max results** is a hard cap between 1 and 100,000.

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

| Field | Description |
|---|---|
| `companyNumber` | CRO company number |
| `name` | Registered company name |
| `status` | Company status, for example Normal, Dissolved, Liquidation |
| `statusCode` | CRO status code |
| `statusDate` | Date the current status took effect |
| `isActive` | True when the status is Normal |
| `companyType` | Company type, for example LTD - Private Company Limited by Shares |
| `companyTypeCode` | CRO company type code |
| `registeredAt` | Registration date, YYYY-MM-DD |
| `dissolvedAt` | Dissolution date, null for companies not dissolved |
| `lastAnnualReturnDate` | Date of the last annual return |
| `nextAnnualReturnDate` | Next annual return date (NARD) |
| `lastAccountsDate` | Made-up date of the last accounts filed |
| `address` | Registered office address on one line |
| `addressLines` | Registered office address lines as filed |
| `eircode` | Eircode, where the CRO has it |
| `naceCode` | NACE Rev. 2 activity code, where the CRO has it |
| `principalObjectCode` | Principal object code as filed |
| `nameEffectiveDate` | Date the current name took effect |
| `typeEffectiveDate` | Date the current company type took effect |
| `country` | Always IE |
| `url` | CRO open data dataset page |
| `source` | Data source and licence attribution |
| `scrapedAt` | ISO timestamp of the scrape |

### Example output

```json
{
  "companyNumber": "633425",
  "name": "RYANAIR FINANCE DESIGNATED ACTIVITY COMPANY",
  "status": "Normal",
  "statusCode": 1151,
  "statusDate": null,
  "isActive": true,
  "companyType": "DAC - Designated Activity Company (limited by shares)",
  "companyTypeCode": 1150,
  "registeredAt": "2018-09-05",
  "dissolvedAt": null,
  "lastAnnualReturnDate": "2025-12-31",
  "nextAnnualReturnDate": "2026-12-31",
  "lastAccountsDate": "2025-03-31",
  "address": "THE CONCOURSE BUILDING, LAKEVIEW DRIVE, AIRSIDE BUSINESS PARK SWORDS CO. DUBLIN, SWORDS,DUBLIN",
  "addressLines": ["THE CONCOURSE BUILDING", "LAKEVIEW DRIVE", "AIRSIDE BUSINESS PARK SWORDS CO. DUBLIN", "SWORDS,DUBLIN"],
  "eircode": "K67NY94",
  "naceCode": "6499.0",
  "principalObjectCode": null,
  "nameEffectiveDate": "2026-05-25",
  "typeEffectiveDate": "2026-05-25",
  "country": "IE",
  "url": "https://opendata.cro.ie/dataset/companies",
  "source": "CRO open data (opendata.cro.ie), Contains Irish Public Sector Data licensed under CC BY 4.0",
  "scrapedAt": "2026-11-14T10:54:34.498Z"
}
```

### Input examples

Look up two companies by company number:

```json
{ "companyNumbers": ["104547", "19542"] }
```

Active companies in Cork registered since the start of 2026:

```json
{
  "statuses": ["Normal"],
  "addressContains": "Cork",
  "registeredAfter": "2026-01-01",
  "maxResults": 5000
}
```

Companies in liquidation or examinership:

```json
{ "statuses": ["Liquidation", "Examinership"], "maxResults": 10000 }
```

### Use cases

- KYB and onboarding checks against the official Irish register.
- Lead lists of new Irish companies, filtered by county or company type.
- Monitoring companies that move into liquidation, examinership or strike-off.
- Matching a customer or supplier list to CRO company numbers.
- Checking which companies are late with their annual return, using `nextAnnualReturnDate`.

### 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 Apify plans. Maximum results per run: 100,000 (set by **Max results**). A run reads the full register file, which takes 10 to 30 seconds and very little compute. 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 Company Records dataset of the CRO, published on opendata.cro.ie as an EU high-value dataset. It holds current and historical companies, including dissolved ones. The file is rebuilt once a day, so a change made in the register today shows in the next day's data.

The dataset holds basic data only. It does not include directors, shareholders, beneficial owners or the content of financial statements. Eircode and NACE code are filled for part of the register only (about two thirds of active companies).

If the CRO 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 Companies Registration Office, the Irish company register.

**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 licence terms on opendata.cro.ie if you build a product on the data.

**Does it include business names (sole traders)?**
No. The file lists companies. Registered business names are a separate CRO register that is not in this dataset.

**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 CRO serves the open data file to any IP.

### Related actors

- [UK Companies House Scraper](https://apify.com/studio-amba/companies-house-scraper)
- [European Company Search](https://apify.com/studio-amba/european-company-search)
- [Estonia Company Register Scraper](https://apify.com/studio-amba/ariregister-ee-scraper)
- [Romania Company Register Scraper](https://apify.com/studio-amba/onrc-ro-scraper)

### Support

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

# Actor input Schema

## `searchQuery` (type: `string`):

Keep only companies whose name contains this text, case-insensitive. Results are ranked: whole-word matches of active companies first. Example: 'Ryanair', 'Tesco', 'pharmacy'.

## `companyNumbers` (type: `array`):

Look up specific companies by their CRO company number. Example: 104547. Leave empty to search by the other filters. Up to 1,000 numbers per run.

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

Keep only companies whose status starts with one of these values, case-insensitive. Common values: 'Normal' (active), 'Dissolved', 'Liquidation', 'Strike Off Listed', 'Struck Off', 'Examinership', 'Receivership', 'Administration'. Leave empty for all.

## `companyTypes` (type: `array`):

Keep only companies whose type contains one of these values, case-insensitive. Examples: 'LTD', 'DAC', 'CLG', 'PLC', 'ULC', 'External company'.

## `addressContains` (type: `string`):

Keep only companies whose registered address or Eircode contains this text, case-insensitive. Examples: 'Cork', 'Dublin 2', 'Galway', 'D02'.

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

Keep only companies registered on or after this date, format YYYY-MM-DD. Example: 2026-01-01 for new companies.

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

Keep only companies registered 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 cost of a run is this number times the per-result price.

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

Not required. The CRO 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
{
  "searchQuery": "Ryanair",
  "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 = {
    "searchQuery": "Ryanair",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

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

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/cro-ie-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/0Mg8GKbAwv8aG8oe2/builds/gGrsidgA1hsQhiJm0/openapi.json
