# Hungary Company Financial Statements Scraper (e-beszámoló) (`scrapers_lat/hungary-company-financials-scraper`) Actor

Scrape Hungarian companies' filed annual accounts (e-beszámoló): revenue, operating profit, profit after tax, total assets, equity, capital and balance-sheet date by year, plus registration and tax numbers. Search by name, adószám or cégjegyzékszám. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/hungary-company-financials-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Lead generation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.75 / 1,000 results

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?

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

## Hungary Company Financial Statements Scraper (e-beszámoló)

> Look up any Hungarian company in the official financial-statements register (e-beszámoló) and get clean, structured financials by business year: net sales revenue, operating profit, profit before and after tax, the net result for the year, total assets, equity, subscribed capital, liabilities and the balance-sheet date, together with the company's registration number, tax number and the direct download links to the filed statements. Built for KYB, credit and due diligence, financial analysis and data enrichment.

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Company financials](https://img.shields.io/badge/Data-Company%20financials-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)

**📥 [Input](https://apify.com/scrapers_lat/hungary-company-financials-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/hungary-company-financials-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/hungary-company-financials-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/hungary-company-financials-scraper/examples)**

<table><tr>
<td align="center"><strong>Search 3 ways</strong><br>name · tax number · registration number</td>
<td align="center"><strong>Financials by year</strong><br>revenue · profit · assets · equity</td>
<td align="center"><strong>Filed documents</strong><br>direct download URLs</td>
</tr></table>

<br>

### What you get

One clean, flat record per company and business year:

- **Identity** — current company name, other/former names, registration number (cégjegyzékszám), tax number (adószám) and KSH statistical number.
- **The business year** — reporting period, balance-sheet date, filing type and the date the report was published.
- **Income statement** — net sales revenue, operating profit, profit before tax, profit after tax and the net result for the year, in full HUF.
- **Balance sheet** — total assets, total equity, subscribed capital, total liabilities and total resources, in full HUF.
- **People** — average employee headcount when it is disclosed in the structured filing.
- **Filed documents** — the count, filenames and direct download URLs of the filed statements (balance sheet, income statement and notes) so you can grab the originals.

Figures are normalized to full HUF regardless of whether the company filed in thousands or millions. No result means no charge, and no login, cookies or API key are ever required.

### Who is it for

| Use case | Who benefits |
|---|---|
| KYB and compliance | Teams verifying Hungarian counterparties |
| Credit and risk | Analysts scoring revenue, profit, equity and leverage |
| Financial analysis | Investors and researchers building multi-year time series |
| Due diligence | Investigators reviewing filed accounts and their history |
| Data enrichment | Builders adding financials and registration IDs to their records |

### How to use it

1. Add one or more **company names** (name beginnings, minimum 4 characters), or use exact **tax numbers** or **registration numbers** for single-company lookups.
2. Set **Max business years per company** to choose how many recent annual statements to pull (each year is one record).
3. Set **Max companies** and run. Export as JSON, CSV or Excel, or pull it through the Apify API.

### Frequently Asked Questions

**Can I search by name, tax number or registration number?**
Yes. Search by company name, by 8-digit tax number (adószám törzsszám), or by registration number (cégjegyzékszám). Tax and registration lookups return a single, exact company.

**Which financial figures are included?**
Net sales revenue, operating profit, profit before and after tax, the net result for the year, total assets, total equity, subscribed capital, total liabilities and total resources, all normalized to full HUF, with the balance-sheet date and reporting period.

**How many years do I get?**
As many of the most recent filed annual statements as you ask for, one record per business year, so you can build a multi-year time series.

**What about companies that file under IFRS?**
Some large or listed companies publish their statements as filed documents rather than in machine-readable form. For those the record still includes the company identity, filing metadata and the direct download URLs of the filed statements.

**How fresh is the data?**
Every record is read live at run time from the official register and carries an `observedAt` timestamp.

### Export, API and AI agents (x402 + MCP)

Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.

For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).

### Related scrapers

- [Germany Company Registry & Financials Scraper (Handelsregister)](https://apify.com/scrapers_lat/germany-company-financials-scraper)
- [France Company Registry Scraper](https://apify.com/scrapers_lat/france-company-search-scraper)
- [UK Companies House Scraper](https://apify.com/scrapers_lat/uk-companies-house-scraper)

### More scrapers at scrapers.lat

This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for public platforms: finance, news, real estate, jobs, e-commerce and government data. Browse the full catalog or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).

***

> This actor is an independent tool and has no affiliation with the e-beszámoló portal, the Hungarian Ministry of Justice or any government body. It only accesses publicly available company financial-statement data. Use the results in accordance with the source's terms.

# Actor input Schema

## `companyNames` (type: `array`):

One or more Hungarian company names (or name beginnings, minimum 4 characters) to search. One run searches every term, for example \["OTP Bank", "Richter Gedeon", "Tesco-Global"].

## `taxNumbers` (type: `array`):

Optional. One or more Hungarian tax numbers (adószám törzsszám) — the first 8 digits, e.g. \["10484878"]. Exact lookup that returns a single company each.

## `registrationNumbers` (type: `array`):

Optional. One or more company registration numbers in the format NN-NN-NNNNNN, e.g. \["01-10-040944"]. Exact lookup that returns a single company each.

## `maxYearsPerCompany` (type: `integer`):

How many of the most recent filed annual statements to extract as financial rows for each company. Each business year is one output record.

## `maxCompanies` (type: `integer`):

Maximum number of companies to process across all search terms.

## `withCompanySummary` (type: `boolean`):

Add an AI-written KYB summary of each company financial position (paid add-on, opt-in). Requires a paid Apify plan. Billed per record only when a summary is produced.

## `withRiskFlags` (type: `boolean`):

Add AI-derived financial red flags and a risk level from the filed accounts (paid add-on, opt-in). Requires a paid Apify plan. Billed per record only when produced.

## Actor input object example

```json
{
  "companyNames": [
    "Tesco-Global"
  ],
  "maxYearsPerCompany": 3,
  "maxCompanies": 10,
  "withCompanySummary": false,
  "withRiskFlags": false
}
```

# 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 = {
    "companyNames": [
        "Tesco-Global"
    ],
    "maxYearsPerCompany": 3,
    "maxCompanies": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/hungary-company-financials-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 = {
    "companyNames": ["Tesco-Global"],
    "maxYearsPerCompany": 3,
    "maxCompanies": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/hungary-company-financials-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 '{
  "companyNames": [
    "Tesco-Global"
  ],
  "maxYearsPerCompany": 3,
  "maxCompanies": 10
}' |
apify call scrapers_lat/hungary-company-financials-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/hungary-company-financials-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/r6aZyb4C3rXBsn85y/builds/RbbikgYddrjydQLR4/openapi.json