# Finn.no Scraper - Norway's #1 Classifieds & Jobs Platform (`santamaria-automations/finn-no-scraper`) Actor Scrape listings from Finn.no, Norway's largest marketplace and job board (Schibsted). Extract items from marketplace, jobs, real estate, and cars. HTTP-only, low memory, datacenter proxy. - **URL**: https://apify.com/santamaria-automations/finn-no-scraper.md - **Developed by:** [Alessandro Santamaria](https://apify.com/santamaria-automations) (community) - **Categories:** E-commerce, Jobs, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 listing result (basic)s This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Finn.no Scraper Scrape listings from [finn.no](https://www.finn.no), Norway's largest classifieds platform and job board (Schibsted group). Supports marketplace, jobs, real estate, cars, and mobility. ### How it works 1. Go to [finn.no](https://www.finn.no) and set up your search with all desired filters (category, price, location, make, model, etc.) 2. Copy the URL from your browser 3. Paste it into the **Search URLs** input 4. Run the actor The actor extracts all listings matching your search, with automatic pagination. ### Features - **Any filter combination** -- Whatever you can filter on finn.no, the actor can scrape - **Multiple searches** -- Paste multiple URLs to run several searches in one run - **Detail enrichment** -- Optionally get full description, company URL, employment type (jobs) - **All verticals** -- Marketplace (Torget), Jobs (Jobb), Real Estate (Eiendom), Cars (Bil), Mobility - **Fast & cheap** -- HTTP-only, 128 MB, pay-per-result ### Output | Field | Description | Source | |-------|-------------|--------| | `title` | Listing title | Search | | `price` / `currency` | Price in NOK | Search | | `location` | City or address | Search | | `category` | Detected vertical (marketplace/jobs/cars/realestate) | Search | | `company_name` | Employer (jobs) or seller | Search | | `company_url` | Employer website | Detail | | `employment_type` | FULL_TIME, PART_TIME, etc. (jobs) | Detail | | `image_url` | Primary image URL | Search | | `description` | Full listing description | Detail | | `posted_at` / `expires_at` | Publication and expiry dates | Both | | `source_url` | Direct link on finn.no | Both | ### Pricing No start fee -- pay only for results: | Event | Cost | |-------|------| | Listing (basic) | $0.003 | | Listing (with details) | $0.005 | **100 listings = $0.30** (basic) or **$0.50** (with details) ### Examples #### Cars under 200K NOK ```json { "searchUrls": ["https://www.finn.no/mobility/search/car?price_to=200000®istration_class=1&variant=0.801"], "maxResults": 50 } ```` #### Multiple searches in one run ```json { "searchUrls": [ "https://www.finn.no/bap/forsale/search.html?q=iphone", "https://www.finn.no/job/search?q=utvikler", "https://www.finn.no/realestate/homes/search.html?q=leilighet" ], "maxResults": 200, "maxResultsPerQuery": 80 } ``` #### Quick SERP-only scan (fast, less data) ```json { "searchUrls": ["https://www.finn.no/bap/forsale/search.html?q=macbook"], "maxResults": 200, "includeDetails": false } ``` ### Related Actors **European Classifieds** - [Blocket.se Scraper — Sweden](https://apify.com/santamaria-automations/blocket-se-scraper) - [DBA.dk Scraper — Denmark](https://apify.com/santamaria-automations/dba-dk-scraper) - [Tori.fi Scraper — Finland](https://apify.com/santamaria-automations/tori-fi-scraper) - [Marktplaats.nl Scraper — Netherlands](https://apify.com/santamaria-automations/marktplaats-nl-scraper) - [Kleinanzeigen.de Scraper — Germany](https://apify.com/santamaria-automations/kleinanzeigen-de-scraper) **Real Estate** - [Homegate.ch Scraper — Swiss real estate](https://apify.com/santamaria-automations/homegate-scraper) - [Immowelt.de Scraper — German real estate](https://apify.com/santamaria-automations/immowelt-de-scraper) **Enrich your data** - [Website Email & Phone Scraper](https://apify.com/santamaria-automations/website-email-scraper) - [Google Maps Scraper](https://apify.com/santamaria-automations/google-maps-scraper) - [Website Contact Extractor](https://apify.com/santamaria-automations/website-contact-extractor) ### Issues & Feedback Missing something or not working as expected? [Open an issue](https://console.apify.com/actors/It8xIqTEZKIadyNNr/issues) and we'll fix it. # Actor input Schema ## `searchUrls` (type: `array`): Paste one or more finn.no search URLs. Go to finn.no, set up your search with all desired filters (category, price, location, etc.), then copy the URL and paste it here. ## `maxResults` (type: `integer`): Maximum total number of listings to return across all searches. ## `maxResultsPerQuery` (type: `integer`): Maximum listings per search URL. Useful when scraping multiple URLs to balance results. ## `includeDetails` (type: `boolean`): Fetch detail pages for richer data (full description, company URL, employment type for jobs, precise location). Slower but much more complete. ## `proxyConfiguration` (type: `object`): Datacenter proxy works for finn.no (no anti-bot protection). ## Actor input object example ```json { "searchUrls": [ "https://www.finn.no/mobility/search/car?price_to=200000®istration_class=1&variant=0.801" ], "maxResults": 10, "maxResultsPerQuery": 100, "includeDetails": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `listings` (type: `string`): Dataset containing scraped listings # 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": [ "https://www.finn.no/mobility/search/car?price_to=200000®istration_class=1&variant=0.801" ], "maxResults": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("santamaria-automations/finn-no-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": ["https://www.finn.no/mobility/search/car?price_to=200000®istration_class=1&variant=0.801"], "maxResults": 10, } # Run the Actor and wait for it to finish run = client.actor("santamaria-automations/finn-no-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": [ "https://www.finn.no/mobility/search/car?price_to=200000®istration_class=1&variant=0.801" ], "maxResults": 10 }' | apify call santamaria-automations/finn-no-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=santamaria-automations/finn-no-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Finn.no Scraper - Norway's #1 Classifieds & Jobs Platform", "description": "Scrape listings from Finn.no, Norway's largest marketplace and job board (Schibsted). Extract items from marketplace, jobs, real estate, and cars. HTTP-only, low memory, datacenter proxy.", "version": "1.0", "x-build-id": "aan07P3Dcz2cyHJxv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~finn-no-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-finn-no-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/santamaria-automations~finn-no-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-finn-no-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/santamaria-automations~finn-no-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-finn-no-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 one or more finn.no search URLs. Go to finn.no, set up your search with all desired filters (category, price, location, etc.), then copy the URL and paste it here.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results (total)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum total number of listings to return across all searches.", "default": 100 }, "maxResultsPerQuery": { "title": "Max Results per Search URL", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum listings per search URL. Useful when scraping multiple URLs to balance results.", "default": 100 }, "includeDetails": { "title": "Include Full Details", "type": "boolean", "description": "Fetch detail pages for richer data (full description, company URL, employment type for jobs, precise location). Slower but much more complete.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Datacenter proxy works for finn.no (no anti-bot protection).", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```