Finder.fi Business Directory Scraper

Scrape Finder.fi — Finland's leading business directory (formerly Fonecta). Search by category and city, or look up companies directly by profile URL/ID. Returns contact details, category, opening hours, website, social links, and financial data (turnover, operating profit, employee counts) where the company has published its accounts.

What this actor does

• Two modes: search (category + city + free-text) and byUrl (direct lookup by Finder.fi profile URL or numeric office ID)
• 50 curated business categories plus a free-text override for anything else
• All 309 Finnish municipalities as a city filter
• Financial data — the site's differentiator versus a plain phone-book: turnover, operating profit/margin, employee count, exports/imports flags, per fiscal year, for companies that have published accounts
• Empty fields are omitted

Output per business

• officeId, businessId (Finnish Y-tunnus / business ID)
• businessStatusCode — raw registry status code from Finder.fi's PRH-sourced data (A = active; other codes reflect non-active registry states), useful for credit/risk screening
• name, companyOfficialName, companyForm, contactType
• category, categories[]
• industryCode, industryName — official Finnish TOL (Toimialaluokitus) industry classification code and description, sourced from Statistics Finland's registry data
• streetAddress, postalCode, postOffice, cityName, cityDistrict, fullAddress, province
• latitude, longitude
• phone, mobile, email
• website, additionalWebsites[], facebookUrl, instagramUrl
• logoUrl, coverImageUrl, images[]
• description, descriptionTitle
• openNow, openingHoursToday, openingHours (per weekday)
• established, ownerName (when the company has a registered owner/proprietor rather than a board), aliases[]
• signingAuthority — the officially registered signing/representation rule for the company (e.g. "Chairman of the board alone"), sourced from the PRH (Finnish Patent and Registration Office) registry
• businessIdRegisteredDate, tradeRegisterDate, employerRegisterDate, prepaymentRegisterDate, vatRegisterDate — the dates the company was entered into each official Finnish registry (business ID, trade register, employer register, prepayment register, VAT register)
• latestFiscalYear, latestTurnoverKEur, latestTurnoverPerEmployeeKEur, latestOperatingProfitKEur, latestNumberOfEmployees
• financials[] — full multi-year history: fiscalYear, turnoverKEur, turnoverChangePercent, turnoverPerEmployeeKEur, operatingProfitKEur, operatingMarginPercent, numberOfEmployees, equityKEur, ebitdaPercent, returnOnInvestmentPercent, solvencyPercent, quickRatio, currentRatio, netIncomeKEur, balanceKEur, exportsBusiness, importsBusiness (all money fields are in thousands of euros, Finder.fi's own reporting unit)
• detailUrl — the Finder.fi profile page
• recordType: "business", source (search/byUrl), scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byUrl
category	select	Ravintola	One of 50 curated Finnish business categories (leave as "" to use only customQuery/city)
customQuery	string	–	Free-text search term; overrides category
city	select	Helsinki	One of all 309 Finnish municipalities; "" searches all of Finland
businessUrls	array	–	Finder.fi profile URLs or bare numeric office IDs (mode=byUrl)
maxItems	int	30	Hard cap on emitted records (1–1000, mode=search)

Example: restaurants in Helsinki

{
  "mode": "search",
  "category": "Ravintola",
  "city": "Helsinki",
  "maxItems": 50
}

Example: free-text search, no category

{
  "mode": "search",
  "category": "",
  "customQuery": "IT-konsultointi",
  "city": "Tampere",
  "maxItems": 30
}

Example: direct lookup by profile URL / office ID

{
  "mode": "byUrl",
  "businessUrls": [
    "https://www.finder.fi/Ravintola/Ravintola+Ragu/Helsinki/yhteystiedot/2701900",
    "172446"
  ]
}

Use cases

• Sales & lead generation — build prospect lists by category and municipality, complete with phone/email and revenue band
• Market research — pull turnover and employee-count trends for a whole industry segment in a city
• Credit / risk screening — pull multi-year financials (turnover, operating margin, solvency) before onboarding a Finnish supplier
• Local SEO / directory audits — verify a business's own Finder.fi listing (hours, website, socials) is accurate
• Competitive intelligence — enumerate every business in a category + city with contact and financial detail

FAQ

What makes Finder.fi different from a plain phone-book scraper? Alongside standard contact info, Finder.fi (run by Fonecta) publishes each Finnish company's official registry data and multi-year financial statements (turnover, operating profit, employee counts) sourced from the Finnish Patent and Registration Office (PRH) and credit-data partners — most Nordic directories don't carry this.

Why do turnoverKEur/operatingProfitKEur look small? They're already in thousands of euros (Finder.fi's own unit) — e.g. turnoverKEur: 2018 means €2,018,000. Multiply by 1,000 for raw euros.

Why is financials sometimes missing? Only companies that file full financial statements (typically limited companies, Oy) have this data on Finder.fi. Sole traders (Toiminimi) and very small associations often don't publish turnover/profit figures, so the field is genuinely absent rather than zeroed out.

What is industryCode/industryName? This is the official Finnish TOL (Toimialaluokitus) industry classification code and description — Finland's equivalent of a NACE/SIC code — as registered with Statistics Finland. It's a different, more standardized taxonomy than Finder.fi's own category/categories browsing labels, and is useful for matching companies against official industry statistics.

What are the registry date fields (tradeRegisterDate, vatRegisterDate, etc.)? These come from the PRH (Finnish Patent and Registration Office) and mark exactly when the company was entered into each official Finnish register — the trade register, employer register, prepayment (withholding tax) register, and VAT register — alongside its signingAuthority (the officially registered rule for who may sign on the company's behalf).

Why is ownerName rarely populated? Finder.fi only exposes a named proprietor for sole-trader-style businesses; limited companies list a board/management team instead, which isn't part of this directory listing. When present, it reflects a genuine registered decision-maker/owner.

How does the single category/city combination map to a search? Finder.fi's own search box is a single free-text field that auto-detects a trailing city name (e.g. typing ravintola helsinki narrows results to Helsinki). This actor reproduces that exact behavior server-side, so category/customQuery + city combine into the same query string a human user would type.

Can I search categories not in the dropdown? Yes — clear category (set it to the empty option) and put anything in customQuery; Finder.fi's search matches business names, categories, and descriptions.

Is there rate limiting? Finder.fi runs AWS WAF Bot Control on its search and profile pages. The actor uses a real headless browser (not raw HTTP) so it solves the anti-bot challenge the same way a normal visitor's browser does, with small polite delays between page loads.

Do direct profile links (detailUrl) always resolve? Yes — Finder.fi resolves company profile URLs by the trailing numeric office ID alone and redirects to the canonical slug regardless of the category/name/city segments in the path, so detailUrl always lands on the right page even if the slug text drifts from the live listing.