# Finder.fi Scraper (`solidcode/finder-fi-scraper`) Actor \[πŸ’° $1.00 / 1K] Extract Finnish business data from Finder.fi β€” company names, business IDs (Y-tunnus), contacts, addresses, geo coordinates, industries, opening hours, and social profiles. Search by keyword and city, or paste Finder.fi search URLs. - **URL**: https://apify.com/solidcode/finder-fi-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Finder.fi Scraper Pull Finnish business listings from Finder.fi at scale β€” names, official business IDs (Y-tunnus), phone, mobile, email, website, social profiles, full postal address, map coordinates, opening hours, and company status, one clean row per business location. A company that operates several outlets returns one row per outlet β€” every branch with its own address, phone, and coordinates β€” so you capture each contactable location, not just the head office. Search by keyword and city, or paste a Finder.fi search link and reuse its exact filters. Built for B2B sales teams, lead-generation agencies, and market researchers who need verified Finnish company contacts without clicking through the directory profile by profile. ### Why This Scraper? - **Canonical Finnish business IDs (Y-tunnus)** β€” every company comes with its hyphenated official ID (e.g. `2467766-5`), the key that joins straight to PRH, VAT, and Finnish accounting systems. - **One row per business location, not just the head office** β€” a chain or multi-branch company returns a separate record for each outlet, each with its own street address, phone, and GPS, so a 6-restaurant group gives you 6 contactable leads instead of one. Group by `businessId` afterward if you ever want a single row per legal entity. - **Map-ready geo coordinates** β€” latitude and longitude on every record, so you can plot results, run radius searches, or feed a territory map without geocoding addresses yourself. - **Full direct contact set** β€” separate `phone`, `mobile`, `email`, and `website` fields per company, so dialers and email tools get exactly the channel they need. - **Facebook and Instagram profiles** β€” normalized social URLs alongside the website, ready for social-selling and account research. - **7-day opening hours plus a live open-now flag** β€” the complete weekly schedule for each business, plus a boolean telling you whether it is open at scrape time. - **Company form and active/inactive status** β€” legal form (Oy, Ay, Tmi, and more) and a normalized status (Active, Dissolved, Bankruptcy) so you can filter out dead entities before they hit your CRM. - **Complete Finnish postal address** β€” street, postal code, post office, city, and province as discrete fields, not one mashed-together string. - **Keyword + city search or paste-a-URL** β€” run Finnish industry terms across all of Finland or one city, or paste a Finder.fi search link to reuse its built-in category filters exactly. - **Logo and image gallery** β€” the company logo plus a bounded gallery of profile and cover images for brand and creative research. ### Use Cases **Lead Generation** - Build targeted Finnish B2B contact lists with phone, mobile, and email in one pass - Pull every restaurant, contractor, or clinic in a city for cold outreach - Capture Facebook and Instagram handles for social-selling campaigns - Assemble territory lists keyed by province and post office **Sales Prospecting** - Enrich prospects with their official Y-tunnus for clean record matching - Filter to Active companies and skip dissolved or bankrupt entities - Prioritize businesses by company form (Oy vs. Tmi) to match your ICP - Map prospects by latitude and longitude to plan field-sales routes **Market Research** - Size a Finnish industry by counting companies per keyword and city - Compare business density across provinces and cities - Track which companies maintain active websites and social profiles - Snapshot opening-hours coverage across a category or region **CRM Enrichment** - Append missing phone, email, and website fields to existing Finnish accounts - Standardize addresses into discrete street, postal code, and city fields - Refresh company status to flag entities that have gone inactive - Add map coordinates to records for geospatial dashboards **Local & Competitive Analysis** - List every competitor in a niche within a single city - Compare opening hours and contact channels across rivals - Audit which competitors publish logos, images, and descriptions - Monitor a category by re-running the same keyword on a schedule ### Getting Started #### Simple Keyword Search Search one Finnish industry term across all of Finland: ```json { "keywords": ["ravintola"], "maxResults": 50 } ```` #### Keyword + City Narrow a crowded category to a single city: ```json { "keywords": ["autokorjaamo"], "location": "Tampere", "maxResults": 200 } ``` #### Paste a Finder.fi Search URL Reuse the exact filters from a search you built on the site: ```json { "searchUrls": ["https://www.finder.fi/search?what=hotelli+Helsinki"], "maxResults": 100 } ``` #### Multi-Keyword Run Sweep several industries in one go: ```json { "keywords": ["ravintola", "kahvila", "baari"], "location": "Turku", "maxResults": 500 } ``` ### Input Reference #### What to Scrape | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchUrls` | string\[] | `[]` | Paste Finder.fi search-result URLs. Any filters already in the URL (category, location, etc.) are applied automatically. Leave empty if you'd rather build a search using the fields below. | | `keywords` | string\[] | `["ravintola"]` | One or more business or industry terms to search for (e.g. "ravintola", "hotelli", "autokorjaamo"). Each keyword is searched in turn. Leave empty if you're using Search URLs above. | #### Search Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `location` | string | `""` | Limit the keyword search to a Finnish city or area (e.g. "Helsinki", "Tampere", "Turku"). Leave blank to search all of Finland. Only applies to the keywords β€” not to Search URLs. | #### Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResults` | integer | `100` | Maximum number of business locations to return across all keywords and URLs (a company with several outlets counts as one row per outlet). Set to 0 for unlimited (up to 100,000 per run). Start with 10-50 to test, then increase. | ### Output Each business location is one flat record β€” a company with several outlets returns one record per outlet, each with its own address, phone, and coordinates. Here's a representative result: ```json { "listingId": "172446", "name": "Ravintola Olo", "tradingName": "Olo Ravintola", "businessId": "2467766-5", "companyForm": "OsakeyhtiΓΆ", "status": "Active", "category": "Ravintolat", "mainLineOfBusiness": "Ravintolat, Catering-palvelut", "phone": "+358 10 320 6250", "mobile": "+358 40 123 4567", "email": "info@olo.fi", "website": "https://olo.fi", "facebookUrl": "https://facebook.com/ravintolaolo", "instagramUrl": "https://instagram.com/ravintolaolo", "streetAddress": "Pohjoisesplanadi 5", "postalCode": "00170", "postOffice": "Helsinki", "city": "Helsinki", "province": "Uusimaa", "latitude": 60.1675, "longitude": 24.9521, "openingHours": { "monday": "11:00-23:00", "tuesday": "11:00-23:00", "wednesday": "11:00-23:00", "thursday": "11:00-23:00", "friday": "11:00-00:00", "saturday": "13:00-00:00", "sunday": "closed" }, "openNow": true, "logo": "https://www.finder.fi/images/olo-logo.png", "images": ["https://www.finder.fi/images/olo-1.jpg", "https://www.finder.fi/images/olo-2.jpg"], "description": "Fine-dining restaurant in the heart of Helsinki serving a modern Nordic tasting menu.", "hasPaidPackage": true, "searchKeyword": "ravintola", "url": "https://www.finder.fi/yhteystiedot/1234567" } ``` #### Identity | Field | Type | Description | |-------|------|-------------| | `listingId` | string | Unique ID for this specific business location. Two outlets of the same company share a `businessId` but have different `listingId`s β€” use it to deduplicate locations. | | `name` | string | Registered company or location name | | `tradingName` | string | Trading name or alias, when the company uses one | | `businessId` | string | Official Finnish business ID (Y-tunnus), hyphenated (e.g. `2467766-5`). Shared by every location of the same company. | | `companyForm` | string | Legal form (OsakeyhtiΓΆ, Avoin yhtiΓΆ, Toiminimi, etc.) | | `status` | string | Company status: Active, Dissolved, or Bankruptcy | | `category` | string | Primary line-of-business category | | `mainLineOfBusiness` | string | Full list of the company's lines of business | #### Contact | Field | Type | Description | |-------|------|-------------| | `phone` | string | Landline phone number | | `mobile` | string | Mobile phone number | | `email` | string | Company email address | | `website` | string | Company website URL | | `facebookUrl` | string | Facebook profile URL | | `instagramUrl` | string | Instagram profile URL | #### Address & Geo | Field | Type | Description | |-------|------|-------------| | `streetAddress` | string | Street address | | `postalCode` | string | Postal code | | `postOffice` | string | Post office name | | `city` | string | City | | `province` | string | Province / region | | `latitude` | number | Latitude for mapping | | `longitude` | number | Longitude for mapping | #### Hours & Media | Field | Type | Description | |-------|------|-------------| | `openingHours` | object | Weekly opening hours, one entry per weekday | | `openNow` | boolean | Whether the business is open at scrape time | | `logo` | string | Company logo URL | | `images` | string\[] | Gallery of profile and cover image URLs | | `description` | string | Company description text | #### Meta | Field | Type | Description | |-------|------|-------------| | `hasPaidPackage` | boolean | Whether the company runs a premium Finder.fi listing | | `searchKeyword` | string | The keyword that surfaced this company | | `url` | string | Direct link to the company's Finder.fi profile | ### Tips for Best Results - **Use Finnish keywords** β€” Finnish terms like "ravintola" (restaurant), "hotelli" (hotel), or "autokorjaamo" (auto repair) return far more matches than their English equivalents, since the directory is Finnish-first. - **Paste a search URL to reuse category filters** β€” build a search on Finder.fi with the exact category and location you want, then paste that URL into `searchUrls`; the actor reuses those filters precisely, no rebuilding required. - **Scope a pasted URL to a city by putting the city in `what`** β€” Finder.fi folds the location into the search term, so write `?what=hotelli+Helsinki` (not a separate location parameter) to keep a pasted search limited to one city. - **Combine keyword + city to narrow a crowded category** β€” broad terms like "ravintola" return thousands of hits nationwide; add a `location` such as "Helsinki" to focus on one market. - **Start small, then scale** β€” set `maxResults` to 10-50 on your first run to confirm the data fits your needs, then raise the cap. - **Filter on `status` after the run** β€” keep only `Active` companies to drop dissolved and bankrupt entities before importing into your CRM. - **Each location is its own lead** β€” a company with several outlets returns one row per location, each with its own address, phone, and coordinates, so you reach every branch. If you instead want a single row per legal entity, group your results by `businessId` after the run and keep the first row in each group. - **Match records by Y-tunnus** β€” the hyphenated `businessId` is the most reliable join key for matching a location back to its parent company in existing Finnish company data; `listingId` uniquely identifies each individual location. - **Run multiple keywords in one job** β€” list several related industry terms in `keywords` to sweep a whole sector in a single run instead of one job per term. The same location matching more than one of your keywords is returned only once, so you never pay twice for the identical listing in a single run. ### Pricing **From $1.00 per 1,000 results** β€” among the most affordable ways to extract structured Finnish company data. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.12 | $0.115 | $0.105 | $0.10 | | 1,000 | $1.20 | $1.15 | $1.05 | $1.00 | | 10,000 | $12.00 | $11.50 | $10.50 | $10.00 | | 100,000 | $120.00 | $115.00 | $105.00 | $100.00 | No compute or time-based charges β€” you pay per result, plus a small fixed per-run start fee. A "result" is any business-location row in the output dataset. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** β€” Workflow automation - **Google Sheets** β€” Direct spreadsheet export - **Slack** / **Email** β€” Notifications on new results - **Webhooks** β€” Trigger custom APIs on run completion - **Apify API** β€” Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate B2B research, market analysis, and lead generation using publicly listed Finnish business information. You are responsible for complying with applicable laws β€” including the GDPR and Finnish data-protection rules β€” and with Finder.fi's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and handle any personal data lawfully and respectfully. # Actor input Schema ## `searchUrls` (type: `array`): Paste Finder.fi search-result URLs. Any filters already in the URL (category, location, etc.) are applied automatically. Leave empty if you'd rather build a search using the fields below. ## `keywords` (type: `array`): One or more business or industry terms to search for (e.g. 'ravintola', 'hotelli', 'autokorjaamo'). Each keyword is searched in turn. Leave empty if you're using Search URLs above. ## `location` (type: `string`): Limit the keyword search to a Finnish city or area (e.g. 'Helsinki', 'Tampere', 'Turku'). Leave blank to search all of Finland. Only applies to the keywords above β€” not to Search URLs. ## `maxResults` (type: `integer`): Maximum number of business locations to return across all keywords and URLs (a company with several outlets counts as one row per outlet). Set to 0 for unlimited (up to 100,000 results per run). Tip: start with 10-50 to test, then increase. ## Actor input object example ```json { "searchUrls": [], "keywords": [ "ravintola" ], "maxResults": 100 } ``` # Actor output Schema ## `overview` (type: `string`): Table of extracted business locations with key fields. A company with several outlets appears as one row per location. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchUrls": [], "keywords": [ "ravintola" ], "location": "", "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/finder-fi-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": [], "keywords": ["ravintola"], "location": "", "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("solidcode/finder-fi-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchUrls": [], "keywords": [ "ravintola" ], "location": "", "maxResults": 100 }' | apify call solidcode/finder-fi-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/finder-fi-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Finder.fi Scraper", "description": "[πŸ’° $1.00 / 1K] Extract Finnish business data from Finder.fi β€” company names, business IDs (Y-tunnus), contacts, addresses, geo coordinates, industries, opening hours, and social profiles. Search by keyword and city, or paste Finder.fi search URLs.", "version": "1.0", "x-build-id": "HM1mWY9bxYCSeRqfV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~finder-fi-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-finder-fi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~finder-fi-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-finder-fi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~finder-fi-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-finder-fi-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste Finder.fi search-result URLs. Any filters already in the URL (category, location, etc.) are applied automatically. Leave empty if you'd rather build a search using the fields below.", "items": { "type": "string" } }, "keywords": { "title": "Search Keywords", "type": "array", "description": "One or more business or industry terms to search for (e.g. 'ravintola', 'hotelli', 'autokorjaamo'). Each keyword is searched in turn. Leave empty if you're using Search URLs above.", "items": { "type": "string" } }, "location": { "title": "City or Area", "type": "string", "description": "Limit the keyword search to a Finnish city or area (e.g. 'Helsinki', 'Tampere', 'Turku'). Leave blank to search all of Finland. Only applies to the keywords above β€” not to Search URLs." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of business locations to return across all keywords and URLs (a company with several outlets counts as one row per outlet). Set to 0 for unlimited (up to 100,000 results per run). Tip: start with 10-50 to test, then increase.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```