# FINN.no Scraper | Norway Real Estate Sale Rent (`lentic_clockss/finn-scraper`) Actor

Scrape FINN.no Eiendom homes for sale, rent, leisure, plots & projects. Extract NOK prices, bedrooms, size, addresses, agents & URLs — FINN API alternative.

- **URL**: https://apify.com/lentic\_clockss/finn-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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

### What does FINN.no Scraper do?

**Scrape FINN.no Eiendom (Norway real estate) listings** — homes for sale, rentals, leisure/holiday homes, plots, commercial, new buildings, and planned projects — then export structured data as Excel, CSV, or JSON.

> Architecture: this Apify Actor is a thin client. Scraping runs on the **finn-no** Cloud Run worker over HTTPS + API key.
>
> **Worker URL is config, not code:** the Actor reads `WORKER_BASE_URL` from Actor environment variables (plus optional per-run `workerBaseUrl`). If you migrate the worker to a new host, update `WORKER_BASE_URL` (and `WORKER_AUTH` if the API key changes) in Apify Console — no Actor code change required. Set `WORKER_PROVIDES_PROXY=1` when the worker supplies its own `PROXY_URL` instead of Apify RESIDENTIAL.

This Actor is a practical **FINN.no API alternative** for market research, investor comps, rental screening, agency monitoring, and lead lists. Enter a Norwegian location such as `oslo` or a FINN location code (`0.20061`), choose a channel, and get listing rows with prices (NOK), bedrooms, size (m²), addresses, photos, and direct listing URLs from [finn.no](https://www.finn.no/).

- Pull **Norwegian homes for sale**, **lettings**, **leisure**, **plots**, **commercial**, **new buildings**, **abroad**, and **planned** listings
- Filter by price, area, bedrooms, property type, ownership, construction year, and more
- Optionally enrich detail pages (viewings, facilities, gallery, neighborhood, ownership history, broker office)
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or Apify API / MCP
- **Pay per event** — Actor start + each Dataset listing; users also pay Apify platform usage for the run

***

### What FINN listing data can you extract?

| Data point | Description |
| --- | --- |
| Title / address | Listing headline and location text |
| Finnkode / listing ID | Stable FINN identifier |
| Price (NOK) | Asking / rent display when shown |
| Bedrooms & area (m²) | Size signals from SERP or detail |
| Property & ownership type | e.g. Leilighet, Selveier, Andel |
| Channel | `sale`, `rent`, `leisure`, `plot`, … |
| Listing URL & main image | Direct FINN link + hero photo |
| Gallery / facilities / viewings | When `enrichDetails` is enabled |
| Agent / office | Broker name and office URL when available |
| Neighborhood / ownership history | Optional enrich endpoints |

Every Dataset row includes `country` = `NO`, `authority` / `source` = `finn.no`.

***

### Why scrape FINN.no?

FINN.no is Norway’s largest classifieds marketplace for housing. Scraping public Eiendom listings helps you:

- Build **Oslo / Bergen / Trondheim** market datasets for comps and pricing research
- Monitor **new listings** and **planned / project** supply with schedules
- Track **rentals vs sale** dynamics by location and property type
- Enrich CRM / investor workflows with addresses, URLs, and broker contacts
- Benchmark leisure, plot, and commercial inventory without manual browsing

***

### More Actors like this

Looking for another **property portal**, or a scraper outside real estate? Use a specialized Actor when one exists — structured fields, better coverage, usually lower cost. Use this Actor for **FINN.no Eiendom** sale / rent / leisure / plot / commercial search and detail pages.

#### Similar real estate Actors

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)

#### Prefer another specialized scraper?

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**E-commerce**

- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)

**Travel & Stays**

- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**Local & Maps**

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

**General Tools**

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to scrape FINN.no (no code required)

1. Create a free [Apify](https://console.apify.com/) account
2. Open [FINN.no Scraper](https://console.apify.com/actors/KrzW7bYRLOn4aAKgq)
3. Set `location` (e.g. `oslo`) and `channel` (e.g. `sale`)
4. Optionally enable `enrichDetails` or other enrich flags
5. Click **Start** and download results from the **Dataset** tab (JSON, CSV, Excel, …)

Start with `maxResults: 5–10` to verify the market, then scale up.

***

### How much does it cost to scrape FINN.no?

This Actor uses **pay-per-event** pricing. You are charged for:

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start |
| Result (`apify-default-dataset-item`) | **$3.00 / 1,000** listings (**$0.003** each) |

**Platform usage costs are paid by the user** — in addition to event prices above, you also pay Apify compute/proxy usage generated by the run.

#### Example cost estimates

| Listings collected | Approx. event cost\* |
| --- | --- |
| 100 | ~$0.31 |
| 1,000 | ~$3.01 |
| 10,000 | ~$30.01 |

\*Assumes one Actor start at default memory billing for start events, plus `$0.003` per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one).

Free Apify trial credit can cover a small test run — try `maxResults: 5` first.

#### Free Apify plan limits (set by this Actor's developer)

| Limit | Free Apify plan | Paid Apify plan |
| --- | --- | --- |
| Runs of this Actor | **10 runs total** | Unlimited |
| Results per run (`maxResults`) | **Up to 1,000** | Up to 2,000 |

When the run cap is hit, the run finishes with a clear status message — not an Apify platform error. Paying Apify users are not subject to the run cap.

***

### Input

Open the **Input** tab for the full form. Common fields:

| Field | Description |
| --- | --- |
| `location` | City slug (`oslo`) or FINN code (`0.20061`). For `abroad`, omit Norwegian location (Oslo empties that SERP). |
| `channel` | `sale`, `rent`, `projects`, `leisure`, `leisure_plots`, `plot`, `commercial`, `abroad`, `planned`, `office` |
| `maxResults` / `maxPages` | Cap results and SERP pages (`fetchAllPages` for larger crawls) |
| `priceFrom` / `priceTo`, `areaFrom` / `areaTo`, `minBedrooms` | SERP filters |
| `propertyType` / `ownershipType` | FINN enum values or labels (e.g. `Leilighet`, `Selveier`) |
| `enrichDetails` | Open listing detail pages for pricing, viewings, facilities, images |
| `enrichNeighborhood` / `enrichOwnershipHistory` / `enrichAreaProfile` / `enrichOffice` | Optional side endpoints |
| `detailUrls` / `officeUrl` | Scrape specific ads or broker profiles (`office` is detail-only) |
| `incremental` | Skip `listingId`s already stored in named KV `finn-seen-finnkodes` |

#### Input example

```json
{
  "location": "oslo",
  "channel": "sale",
  "maxResults": 25,
  "maxPages": 1,
  "enrichDetails": true,
  "enrichNeighborhood": true
}
```

Leisure / plots:

```json
{
  "location": "oslo",
  "channel": "leisure",
  "maxResults": 20,
  "maxPages": 1
}
```

Homes abroad (do not pass a Norwegian location):

```json
{
  "channel": "abroad",
  "maxResults": 20,
  "maxPages": 1
}
```

***

### Output sample

Results are written to the default **Dataset**. Preview fields include `name`, `type`, `status`, `country`, `authority`, plus FINN-specific columns.

```json
[
  {
    "listingId": "469777706",
    "finnkode": "469777706",
    "name": "SOFIENBERG | 2-roms selveie | Sjenerøs takhøyde",
    "type": "listing",
    "status": "active",
    "country": "NO",
    "authority": "finn.no",
    "channel": "sale",
    "listingUrl": "https://www.finn.no/realestate/homes/ad.html?finnkode=469777706",
    "address": "Sars' gate 22, Oslo",
    "priceDisplay": "3 900 000 kr",
    "bedrooms": 1,
    "areaSqm": 34.0,
    "imageUrl": "https://images.finncdn.no/dynamic/480w/...",
    "contentDepth": "guest_preview",
    "scrapedAt": "2026-07-23T10:00:56.917Z"
  }
]
```

With `enrichDetails` enabled you may also see `viewings`, `facilities`, `imageUrls`, agent/office fields, and an `enrichment` object (e.g. neighborhood).

***

### Channels (FINN Eiendom)

| Channel | FINN vertical | Notes |
| --- | --- | --- |
| `sale` | homes | Homes for sale |
| `rent` | lettings | Homes for rent |
| `projects` | newbuildings | New building projects |
| `leisure` | leisuresale | Holiday / leisure homes |
| `leisure_plots` | leisureplots | Leisure plots |
| `plot` | plots | Land / plots |
| `commercial` | businesssale | Commercial for sale |
| `abroad` | abroad | Homes abroad — omit Norwegian `location` |
| `planned` | homes (filtered) | Planned / coming-soon style listing URLs |
| `office` | — | Broker/company profile via `officeUrl` or `detailUrls` |

***

### Tips for better FINN scrapes

- Prefer **RESIDENTIAL Norway** proxy settings in the UI when offered; the managed worker also uses NO residential egress
- Use **city slugs** (`oslo`, `bergen`) or FINN location codes from `/v1/categories`
- Enable `enrichDetails` only when you need viewings, galleries, or deeper pricing — it costs more time per listing
- Use `incremental=true` for recurring schedules so already-seen `finnkode`s are skipped across runs
- For `abroad`, leave `location` empty / default — Norwegian codes return an empty SERP

***

### Is it legal to scrape FINN.no?

Only scrape **publicly available** listing data and only if you have a legitimate reason. Personal data that appears in public ads may be protected by GDPR and similar laws. Review FINN’s terms and your own compliance obligations before large-scale collection. This tool is intended for ethical use of public information — do not automate contact forms or bypass login-gated content.

***

### FAQ

#### Can I use this as a FINN.no API?

Yes — run the Actor via the Apify Console, CLI (`apify call`), Schedules, or HTTP API, then download the Dataset or stream items into your stack. There is no official public FINN “listings dump” API for this use case; this Actor is a structured data alternative.

#### Does it scrape listing detail pages?

Yes, when `enrichDetails` (and optional enrich flags) are enabled. Otherwise you get SERP / card-level fields only.

#### What formats can I export?

Apify Dataset downloads support JSON, JSONL, CSV, Excel, XML, and HTML. You can also pull results through the Apify API, Integrations, or webhooks.

#### How do I scrape only specific FINN ads?

Paste one or more `https://www.finn.no/realestate/.../ad.html?finnkode=...` URLs into `detailUrls`.

#### Why did my free-plan run stop after 10 runs?

Free Apify plan users get **10 runs** of this Actor and **up to 1,000 results per run**. These limits are set by the Actor developer (not Apify). When you hit the run cap, the run finishes with a clear status message — it is not a platform bug. Upgrade to a paid Apify plan for unlimited runs.

***

### Support

Open the **Issues** tab on this Actor page with sample input, run ID, and expected vs actual results. Feature requests for extra filters or fields are welcome.

Looking for other Nordic or European property sources? Browse more real-estate scrapers from the same publisher on Apify Store for multi-market workflows.

***

### Related Actors

All **77** public Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

# Actor input Schema

## `location` (type: `string`):

FINN location code (e.g. 0.20061) or seed city slug (oslo, bergen, …).

## `channel` (type: `string`):

Eiendom vertical: sale/rent/projects/leisure/leisure\_plots/plot/commercial/abroad/planned/office.

## `priceFrom` (type: `integer`):

Optional minimum price filter (price\_from).

## `priceTo` (type: `integer`):

Optional maximum price filter (price\_to).

## `priceCollectiveFrom` (type: `integer`):

Optional price\_collective\_from filter.

## `priceCollectiveTo` (type: `integer`):

Optional price\_collective\_to filter.

## `areaFrom` (type: `integer`):

Optional minimum area filter (area\_from).

## `areaTo` (type: `integer`):

Optional maximum area filter (area\_to).

## `plotAreaFrom` (type: `integer`):

Optional plot\_area\_from filter.

## `plotAreaTo` (type: `integer`):

Optional plot\_area\_to filter.

## `minBedrooms` (type: `integer`):

Optional minimum bedrooms filter (min\_bedrooms).

## `propertyType` (type: `string`):

FINN property\_type id or slug (3/leilighet, 1/enebolig, 4/rekkehus, …).

## `ownershipType` (type: `string`):

FINN ownership\_type id or slug (3/selveier, 4/andel, 2/aksje).

## `constructionYearFrom` (type: `integer`):

Optional construction\_year\_from.

## `constructionYearTo` (type: `integer`):

Optional construction\_year\_to.

## `published` (type: `string`):

Optional FINN published filter value.

## `videoType` (type: `string`):

Optional FINN video\_type filter.

## `sort` (type: `string`):

Optional FINN sort enum.

## `maxResults` (type: `integer`):

Maximum listings to return in this run (1–2,000). Free Apify plan users are limited to 1,000 results per run and 10 total runs of this Actor — limits set by the Actor developer.

## `maxPages` (type: `integer`):

Maximum SERP pages (~50 listings/page), up to 100.

## `fetchAllPages` (type: `boolean`):

Expand pages from treff estimate, capped by maxResults.

## `detailUrls` (type: `array`):

Optional FINN ad.html URLs. When set, calls /v1/listings.

## `officeUrl` (type: `string`):

Broker/company profile URL (required for channel=office if no detailUrls).

## `enrichDetails` (type: `boolean`):

Fetch LDP testid + stream fields for each listing.

## `enrichOffice` (type: `boolean`):

Extract broker/office fields from LDP and follow office URL when present.

## `enrichAreaProfile` (type: `boolean`):

Fetch /areaprofile/{finnkode} summary into enrichment.areaProfile.

## `enrichOwnershipHistory` (type: `boolean`):

Fetch ownershiphistory.html rows into enrichment.ownershipHistory.

## `enrichNeighborhood` (type: `boolean`):

Fetch neighborhood-api-alt.json into enrichment.neighborhood.

## `incremental` (type: `boolean`):

Skip listingIds already stored in named KV store finn-seen-finnkodes (SEEN\_FINNKODES). Persists across runs; full skip still SUCCEEDED.

## `includeRaw` (type: `boolean`):

Include raw parse payload on each row when supported.

## `fields` (type: `array`):

Optional worker response field projection (dataset still stores full rows).

## `webhookUrl` (type: `string`):

Optional webhook; failures become partial warnings, not hard fail.

## `workerBaseUrl` (type: `string`):

Override the Cloud Run worker origin for this run. Defaults to Actor env WORKER\_BASE\_URL. Use when testing a staging worker; production migrations should update WORKER\_BASE\_URL in Actor settings (no code change).

## `proxyConfiguration` (type: `object`):

Apify proxy UI. Actor-run proxy passwords are not forwarded; worker PROXY\_URL is used.

## `proxyUrl` (type: `string`):

Optional durable proxy URL forwarded to the worker.

## Actor input object example

```json
{
  "location": "oslo",
  "channel": "sale",
  "maxResults": 50,
  "maxPages": 1,
  "fetchAllPages": false,
  "enrichDetails": false,
  "enrichOffice": false,
  "enrichAreaProfile": false,
  "enrichOwnershipHistory": false,
  "enrichNeighborhood": false,
  "incremental": false,
  "includeRaw": false
}
```

# Actor output Schema

## `listings` (type: `string`):

Normalized FINN listing records.

## `runSummary` (type: `string`):

Run outcome summary.

## `inputEcho` (type: `string`):

Normalized non-secret input.

## `errorSummary` (type: `string`):

Structured failure details.

# 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 = {
    "location": "oslo",
    "channel": "sale",
    "maxResults": 50,
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/finn-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 = {
    "location": "oslo",
    "channel": "sale",
    "maxResults": 50,
    "maxPages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/finn-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 '{
  "location": "oslo",
  "channel": "sale",
  "maxResults": 50,
  "maxPages": 1
}' |
apify call lentic_clockss/finn-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lentic_clockss/finn-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/KrzW7bYRLOn4aAKgq/builds/F4pXl2lgaFLr04q2a/openapi.json