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

Here is one real result, with every field the actor returns (document lists trimmed for length, kept real):

{
  "companyName": "Tesco Global Áruházak Zrt.",
  "alternativeNames": ["Tesco -Global Áruházak Zrt.", "Tesco Globál Áruházak Zrt.", "TESCO-GLOBAL Áruházak Zártkörűen Működő Részvénytársaság", "Tesco-Globál Áruházak Zrt", "Tesco-Global Áruházak Zrt."],
  "registrationNumber": "13-10-040628",
  "taxNumber": "10307078",
  "kshNumber": "10307078-4711-114-13",
  "fiscalYear": 2014,
  "reportType": null,
  "reportingPeriodStart": "2013-03-01",
  "reportingPeriodEnd": "2014-02-28",
  "balanceSheetDate": "2014-02-28",
  "publicationDate": "2014.07.31. 19:12:43",
  "currency": "HUF",
  "reportedUnit": "million HUF",
  "netRevenue": 599062000000,
  "operatingProfit": -48251000000,
  "profitBeforeTax": -41931000000,
  "profitAfterTax": -43109000000,
  "retainedResult": -43109000000,
  "totalAssets": 450507000000,
  "totalEquity": 246057000000,
  "subscribedCapital": 144756000000,
  "totalLiabilities": 178641000000,
  "totalLiabilitiesAndEquity": 450507000000,
  "employeeHeadcount": null,
  "structuredFinancialsAvailable": true,
  "documentCount": 40,
  "documentNames": ["Tesco-Global_IFRS_merleg_202526.pdf (265 kB)", "Tesco-Global_IFRS_eredmenykimutatas_202526.pdf (261 kB)", "Tesco-Global_IFRS_kiegeszito_melleklet_202526.pdf (1839 kB)", "... 37 more"],
  "documentUrls": ["https://e-beszamolo.im.gov.hu/oldal/kereses_megjelenites?...", "... 39 more"],
  "note": null,
  "searchTerm": "Tesco-Global",
  "aiCompanySummary": null,
  "aiRiskLevel": null,
  "aiRiskFlags": null,
  "source": "e-beszámoló (Hungarian company financial statements register)",
  "observedAt": "2026-08-14T11:22:10.000Z"
}

The most complete Hungarian company financials scraper available. It returns every structured figure the e-beszámoló annual accounts expose per business year, plus registration and tax identifiers and the download URLs of every filed document, and gives you three ways to search (name, tax number, registration number) with optional AI KYB enrichment.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches the official Hungarian company financial statements register (e-beszámoló / OBR) by company name, tax number (adószám) or registration number (cégjegyzékszám), opens each company's filed annual accounts, and writes one normalized record per business year to the run's dataset. It reads the reporting-year column of the filed balance sheet and income statement, scales figures from thousand or million HUF to whole HUF, and returns net revenue, operating profit, profit before and after tax, retained result, total assets, equity, subscribed capital, liabilities and the balance-sheet date. Every filed document (balance sheet, income statement, notes, audit report, minutes) is returned with its download URL.

When a company files only in IFRS/ESEF form (no machine-readable OBR figures), the actor still emits an identity record with the filing metadata and document download URLs, and explains this in the note field. Optional paid AI add-ons produce a KYB financial summary and derived risk flags.

Quickstart

Open the actor, paste this into the input, and press Run. It searches for Tesco-Global and returns up to 3 business years of financials.

{
  "companyNames": ["Tesco-Global"],
  "maxYearsPerCompany": 3,
  "maxCompanies": 10
}

You can also look companies up exactly by taxNumbers (8-digit adószám) or registrationNumbers (NN-NN-NNNNNN). At least one of companyNames, taxNumbers or registrationNumbers is required.

Input reference

Field	Type	Required	Default	Description
companyNames	string[]	conditional	(empty)	One or more company names or name beginnings (minimum 4 characters), for example ["OTP Bank", "Richter Gedeon"].
taxNumbers	string[]	conditional	(empty)	One or more tax numbers (adószám törzsszám), the first 8 digits, for example ["10484878"]. Exact lookup.
registrationNumbers	string[]	conditional	(empty)	One or more registration numbers in the format NN-NN-NNNNNN, for example ["01-10-040944"]. Exact lookup.
maxYearsPerCompany	integer	no	3	How many of the most recent filed annual statements to extract per company. Each business year is one record. Range 1 to 20.
maxCompanies	integer	no	20	Maximum number of companies to process across all search terms. Free Apify plans are capped at 10 companies per run.
withCompanySummary	boolean	no	false	Paid add-on. AI KYB summary of each company's financial position (aiCompanySummary). Paid plans only, billed per record produced.
withRiskFlags	boolean	no	false	Paid add-on. AI financial risk level and red flags (aiRiskLevel, aiRiskFlags). Paid plans only, billed per record produced.

At least one of companyNames, taxNumbers or registrationNumbers must be supplied, or the run returns a single item with an error field.

Output reference

One dataset item per company business year. Types: string, integer, boolean, string[], or null when the source value is absent.

Field	Type	Description
companyName	string	Primary company name.
alternativeNames	string[]	Other name variants recorded for the company.
registrationNumber	string	Registration number (cégjegyzékszám), format NN-NN-NNNNNN.
taxNumber	string	8-digit tax number (adószám törzsszám).
kshNumber	string	Full KSH statistical number.
fiscalYear	integer	Business year of this record.
reportType	string	Report type as filed (Hungarian label), or null.
reportingPeriodStart	string	Reporting period start (YYYY-MM-DD).
reportingPeriodEnd	string	Reporting period end (YYYY-MM-DD).
balanceSheetDate	string	Balance-sheet date (YYYY-MM-DD).
publicationDate	string	When the filing was published on the register.
currency	string	Always HUF.
reportedUnit	string	Original filing unit: HUF, thousand HUF or million HUF. Figures below are already scaled to whole HUF.
netRevenue	integer	Net sales revenue, in whole HUF.
operatingProfit	integer	Operating (business) result, in whole HUF.
profitBeforeTax	integer	Profit before tax, in whole HUF.
profitAfterTax	integer	Profit after tax, in whole HUF.
retainedResult	integer	Result per the balance sheet, in whole HUF.
totalAssets	integer	Total assets, in whole HUF.
totalEquity	integer	Total equity (saját tőke), in whole HUF.
subscribedCapital	integer	Subscribed capital (jegyzett tőke), in whole HUF.
totalLiabilities	integer	Total liabilities, in whole HUF.
totalLiabilitiesAndEquity	integer	Total liabilities and equity (források összesen), in whole HUF.
employeeHeadcount	integer	Average statistical headcount when published, else null.
structuredFinancialsAvailable	boolean	true when machine-readable OBR figures were parsed, false for IFRS/ESEF-only filers.
documentCount	integer	Number of filed documents returned.
documentNames	string[]	File names of the filed documents.
documentUrls	string[]	Download URLs of the filed documents.
note	string	Explanatory note (for example when structured figures are unavailable), else null.
searchTerm	string	The input term that matched this company, else null.
aiCompanySummary	string	AI KYB summary (paid add-on), else null.
aiRiskLevel	string	AI risk level low/medium/high (paid add-on), else null.
aiRiskFlags	string[]	AI financial red flags (paid add-on), else null.
source	string	Data source label.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	Present only on a failed run: a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"companyNames":["Tesco-Global"],"maxYearsPerCompany":3,"maxCompanies":10}). Document lists trimmed for length, all values real:

{
  "companyName": "Tesco Global Áruházak Zrt.",
  "registrationNumber": "13-10-040628",
  "taxNumber": "10307078",
  "kshNumber": "10307078-4711-114-13",
  "fiscalYear": 2014,
  "reportingPeriodStart": "2013-03-01",
  "reportingPeriodEnd": "2014-02-28",
  "balanceSheetDate": "2014-02-28",
  "publicationDate": "2014.07.31. 19:12:43",
  "currency": "HUF",
  "reportedUnit": "million HUF",
  "netRevenue": 599062000000,
  "operatingProfit": -48251000000,
  "profitBeforeTax": -41931000000,
  "profitAfterTax": -43109000000,
  "retainedResult": -43109000000,
  "totalAssets": 450507000000,
  "totalEquity": 246057000000,
  "subscribedCapital": 144756000000,
  "totalLiabilities": 178641000000,
  "totalLiabilitiesAndEquity": 450507000000,
  "structuredFinancialsAvailable": true,
  "documentCount": 40,
  "searchTerm": "Tesco-Global",
  "source": "e-beszámoló (Hungarian company financial statements register)",
  "observedAt": "2026-08-14T11:22:10.000Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~hungary-company-financials-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"companyNames":["OTP Bank"],"maxYearsPerCompany":3,"maxCompanies":5}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~hungary-company-financials-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"taxNumbers":["10307078"],"maxYearsPerCompany":5}'

Apify CLI:

apify call scrapers_lat/hungary-company-financials-scraper \
  --input '{"registrationNumbers":["13-10-040628"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per record returned (result event), which is one company business year. See the pricing tab for the current per-result price.
• Paid AI add-ons. withCompanySummary and withRiskFlags charge separate per-record events (ai_company_summary, ai_risk_flags) only when the enrichment is produced, and are disabled for free plans.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 companies per run and cannot use the AI add-ons. Upgrade for more.
• Rate limiting. The source rate-limits by IP; the actor routes through Hungary residential proxies and rotates on limit, so large runs take longer.

FAQ and troubleshooting

A run returned an error item asking for search terms. Why? You must provide at least one of companyNames, taxNumbers or registrationNumbers. That error item is not charged.

Why is structuredFinancialsAvailable false and the figures null? The company files only in IFRS/ESEF form, which the register does not publish as machine-readable figures. The filed statements are still returned via documentUrls, and the note field explains this.

In what currency and unit are the figures? Always whole HUF. reportedUnit tells you the original filing unit (thousand or million HUF); the actor has already scaled the figures to whole HUF.

How do I get more than one year per company? Raise maxYearsPerCompany (up to 20). Each business year is a separate record.

Is this an official government tool? No. This actor is independent and has no affiliation with the Hungarian government or e-beszámoló. It reads only data that is publicly available on the register. Use it in accordance with the source's terms.

Related scrapers

• Czech ARES Companies Scraper: Czech company registry records.
• Denmark CVR Companies Scraper: Danish company registry records.
• Estonia Business Register Scraper: Estonian company registry and financials.
• Belgium KBO Companies Scraper: Belgian company registry records.
• GLEIF LEI Company Records Scraper: global Legal Entity Identifier records.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with the Hungarian government or e-beszámoló. Accesses only publicly available company filing data. Use in accordance with the source's terms of service.