# Finn.no Real Estate Scraper (`rigelbytes/finn-no-scraper`) Actor Scrape Norwegian real-estate listings from Finn.no with search URL or filter-based discovery, optional full details and broker contact info. - **URL**: https://apify.com/rigelbytes/finn-no-scraper.md - **Developed by:** [Rigel Bytes](https://apify.com/rigelbytes) (community) - **Categories:** Real estate, Integrations, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.70 / 1,000 listings 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Real Estate Scraper Extract thousands of Norwegian property listings from Finn.no to power market research, investment analysis, portfolio monitoring, and automated alerts โ€” for just **$1 per 1,000 listings** (detailed results & broker info at $2/1,000). --- ### What can Finn.no Real Estate Scraper do for you? - ๐Ÿ  **Build a complete property database** โ€” Scrape every listing matching your criteria across all Norwegian counties - ๐Ÿ“Š **Track price trends over time** โ€” Schedule daily runs to monitor asking prices, total costs, and shared expenses - ๐Ÿ” **Filter with precision** โ€” Use Finn.no's native filters (location, price, bedrooms, energy label, property type, ownership, facilities) or paste any search URL - ๐Ÿ˜๏ธ **Get broker & seller contacts** โ€” Optionally extract phone numbers and emails for direct outreach - ๐Ÿ“ธ **Download all property images** โ€” Retrieve full-resolution photos, floor plans, and map images - ๐Ÿ“ **Geo-enrich listings** โ€” Latitude/longitude, postal codes, cadastral references, and static map URLs included --- ### What data can you extract? | Field | Description | |-------|-------------| | ๐Ÿ–ผ๏ธ **Image** | Main listing photo + all gallery images | | ๐Ÿท๏ธ **Title** | Listing headline (e.g. "Enebolig med 3 soverom") | | ๐Ÿ”— **URL** | Direct link to the Finn.no ad | | ๐Ÿ“ **Location** | Address, neighborhood, municipality, coordinates | | ๐Ÿ’ฐ **Asking price** | Prisantydning in NOK | | ๐Ÿ’ฐ **Total price** | Prisantydning + felleskostnader | | ๐Ÿ’ฐ **Shared cost/mo** | Fellesutgifter per month | | ๐Ÿ“ **Living area** | Bruksareal (mยฒ) | | ๐Ÿ›๏ธ **Bedrooms** | Number of bedrooms | | ๐Ÿšช **Rooms** | Total rooms | | ๐Ÿ˜๏ธ **Property type** | Enebolig, Leilighet, Rekkehus, Tomt, etc. | | ๐Ÿ“œ **Ownership type** | Selveier, Andel, Aksje, Obligasjon | | ๐Ÿ—๏ธ **Construction year** | Byggeรฅr | | โšก **Energy label** | Aโ€“G energikarakter | | ๐Ÿข **Broker/agency** | Meglerfirma navn & logo | | ๐Ÿ“… **Published date** | When the listing went live | | ๐Ÿ†” **Finn code** | Unique ad identifier | | ๐Ÿ“ **Full description** | All description sections (when `scrapeDetails=true`) | | ๐Ÿ  **Street address** | Exact street, postal code, city | | ๐Ÿ–ผ๏ธ **All images** | Full array of image URLs | | ๐Ÿท๏ธ **Facilities** | Balkong, Heis, Garasje, Utsikt, EV-lading, etc. | | ๐Ÿ‘๏ธ **Viewings** | Scheduled showing times with iCal links | | ๐Ÿ“ž **Broker contacts** | Name, phone, email (when `includeContactInfo=true`) | | ๐Ÿ“ **Plot area** | Tomtareal (mยฒ) | | ๐Ÿ’ฐ **Collective debt** | Fellesgjeld for housing cooperatives | | ๐Ÿท๏ธ **Source** | "list" or "detail" extraction mode | --- ### Why use this scraper? - ๐Ÿ“ˆ **Market research** โ€” Analyze price per mยฒ trends across municipalities - ๐Ÿ˜๏ธ **Portfolio monitoring** โ€” Track new listings matching your investment criteria - ๐Ÿค– **Automated alerts** โ€” Feed scraped data into your CRM or notification system - ๐Ÿ“Š **Valuation models** โ€” Train ML models on historical Finnish real estate data - ๐Ÿข **Broker intelligence** โ€” Identify active agents, their inventory, and contact details - โšก **Save weeks of manual work** โ€” What takes hours manually runs in minutes on Apify --- ### Pricing - **$1/1,000 listings** (Detailed Result: $2/1,000, Broker Info: $2/1,000) - No hidden fees or limits on usage. - Apify plan discounts apply: **Bronze** $0.90/1,000 ยท **Silver** $0.80/1,000 ยท **Gold** $0.70/1,000 (detailed/broker: $1.70/$1.50/$1.30) --- ### How to use Finn.no Real Estate Scraper 1. **Create a free Apify account** โ€” [Sign up](https://console.apify.com/signup) (no credit card required) 2. **Open the actor** โ€” Go to [apify.com/rigelbytes/finn-no-scraper](https://apify.com/rigelbytes/finn-no-scraper) 3. **Set your search criteria** โ€” Paste a Finn.no search URL *or* use the visual filters (location, price, bedrooms, property type, etc.) 4. **Choose detail level** โ€” Enable "Fetch Full Listing Details" for descriptions, images, facilities; enable "Include Broker/Seller Contact" for phone/email 5. **Start the run** โ€” Click **Start** and wait for results 6. **Download your data** โ€” Export as JSON, CSV, Excel, or access via API --- ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `startUrls` | Array[Object] | No | Preferred input. Finn.no search URLs with filters pre-applied | | `searchQuery` | String | No | Free-text search (q parameter) | | `publishedToday` | Boolean | No | Only listings published today | | `locations` | Array[String] | No | Counties (Oslo, Nordland, Innlandet, etc.) or Finn codes | | `saleStatus` | Array[String] | No | for_sale, sold_last_3_days, coming_for_sale | | `propertyCondition` | String | No | Any, used, new | | `priceFrom` / `priceTo` | Integer | No | Asking price range (NOK) | | `totalPriceFrom` / `totalPriceTo` | Integer | No | Total price range (NOK) | | `sharedCostFrom` / `sharedCostTo` | Integer | No | Shared cost/month range (NOK) | | `areaFrom` / `areaTo` | Integer | No | Living area range (mยฒ) | | `minBedrooms` | Integer | No | Minimum bedrooms (1โ€“5) | | `constructionYearFrom` / `constructionYearTo` | Integer | No | Year built range | | `plotAreaFrom` / `plotAreaTo` | Integer | No | Plot size range (mยฒ) | | `propertyTypes` | Array[String] | No | apartment, detached, townhouse, semi_detached, farm, garage, industrial, plot, multi_family, other | | `ownershipTypes` | Array[String] | No | stock, share, bond, freeholder, other | | `sellerTypes` | Array[String] | No | broker, private | | `facilities` | Array[String] | No | balcony, fireplace, elevator, no_neighbors, modern, airconditioning, beachfront, hiking, garage, laundry, alarm, broadband, caretaker, view, ev_charging | | `energyLabels` | Array[String] | No | A, B, C, D, E, F, G | | `floors` | Array[String] | No | NOTFIRST, 1โ€“6, BIG (above 6th) | | `videoTypes` | Array[String] | No | Video, 360 viewing | | `scrapeDetails` | Boolean | No | Fetch full details per listing (slower, richer) | | `includeContactInfo` | Boolean | No | Extract broker/seller phone & email | | `maxItems` | Integer | No | Max listings to scrape (0 = unlimited, default 50) | | `proxyConfiguration` | Object | No | Apify Proxy settings (residential recommended) | #### ๐Ÿ“ Copy for Use: ```json { "startUrls": [ { "url": "https://www.finn.no/realestate/homes/search.html?location=0.20061" } ], "scrapeDetails": true, "includeContactInfo": true, "maxItems": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` *** ### Output #### Sample Output (Overview view) | Image | Title | URL | Location | Asking price | Total price | Shared cost/mo | Area mยฒ | Bedrooms | Rooms | Type | Ownership | Built | Energy | Organisation | Published | Finn code | |-------|-------|-----|----------|--------------|-------------|----------------|---------|----------|-------|------|-----------|-------|--------|--------------|-----------|-----------| | ๐Ÿ–ผ๏ธ | Enebolig med 3 soveromโ€ฆ | [Link](https://www.finn.no/realestate/homes/ad.html?finnkode=470675677) | Skรธelvdalen 231, 9310 Sรธrreisa | 1,250,000 | 1,282,340 | 0 | 172 | 3 | 4 | Enebolig | Selveier | 1958 | E | EiendomsMegler 1 Finnsnes | 2026-07-24 | 470675677 | #### Sample Output (Details view) Additional fields: `description`, `streetAddress`, `postalCode`, `postalName`, `latitude`, `longitude`, `imageUrls[]`, `facilities[]`, `viewings[]`, `contacts[]`, `contactPhones[]`, `sellerEmails[]`, `floor`, `plotArea`, `collectiveDebt`, `source` *** ### Why Choose This Scraper? - **Affordable**: Pay only $1 per 1,000 listings scraped (detailed results & broker info at $2/1,000) - **Comprehensive**: Extracts 30+ fields including images, geo-data, facilities, viewings, and contacts - **Easy to Use**: Visual filter builder or paste any Finn.no search URL โ€” no coding required - **Reliable**: Runs on Apify's residential proxy network; handles pagination, rate limits, and retries automatically *** ### Recommended Proxy Providers - ## **Shifter** - Reliable residential proxies all over the world. - Cheap rates - [Order Shifter Now](https://shifter.io/r/YoBB/order) - Get 10% Off any product, use coupan `rigelbytes-YoBB`. - ## **OxyLabs** - **100M+ Proxies** - Fastest proxies in the market - Real profile, human-like Residential IPs - Quality assurance framework for most reliable IPs - [Get Proxies](https://oxylabs.go2cloud.org/aff_c?offer_id=7\&aff_id=1366\&url_id=7) - ## **DataImpulse** - Covers **200+ Countries** - Reliable Residential Proxies for just $1/GB - [Get Residential Proxies](https://dataimpulse.com/?aff=89421) ### [![Learn More About Proxies](https://img.shields.io/badge/Learn_More-About_Proxies-blue?style=for-the-badge)](#understanding-proxies) ### ๐Ÿ™Œ Why Buy Through Our Affiliate Link? - Exclusive Deals: Some providers may offer special discounts or bonuses when you use our link. - Support Our Work: Each purchase helps us maintain and improve the tools and services we provide. - No Extra Cost: You pay the same price, but part of it goes to supporting our efforts. #### Running via Apify Console You can run this actor from the Apify Console by providing the necessary input parameters. #### Running via API You can trigger this actor using the Apify API, passing the required input in the request body. *** ### API Examples #### Python ```python from apify_client import ApifyClient client = ApifyClient("") run_input = { "startUrls": [{"url": "https://www.finn.no/realestate/homes/search.html?location=0.20061"}], "scrapeDetails": True, "includeContactInfo": True, "maxItems": 5, "proxyConfiguration": {"useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"]}, } run = client.actor("rigelbytes/finn-no-scraper").call(run_input=run_input) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` #### JavaScript (Node.js) ```javascript const { ApifyClient } = require('apify-client'); const client = new ApifyClient({ token: '' }); const run = await client.actor('rigelbytes/finn-no-scraper').call({ startUrls: [{ url: 'https://www.finn.no/realestate/homes/search.html?location=0.20061' }], scrapeDetails: true, includeContactInfo: true, maxItems: 5, proxyConfiguration: { useApifyProxy: true, apifyProxyGroups: ['RESIDENTIAL'] }, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### cURL ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "startUrls": [{"url": "https://www.finn.no/realestate/homes/search.html?location=0.20061"}], "scrapeDetails": true, "includeContactInfo": true, "maxItems": 5, "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]} }' \ "https://api.apify.com/v2/acts/rigelbytes~finn-no-scraper/runs?token=" ``` *** ### ๐Ÿ“ธ Output Preview ![Finn.no Real Estate Scraper Output](https://github.com/faizanalii/apify-images/blob/main/Finn.no%20Real%20Estate%20Scraper.gif?raw=true) *** ### ๐Ÿš€ Other Tools by Rigel Bytes Explore **109** more scraping tools by Rigel Bytes, organized by use case: #### ๐Ÿ“ฑ Social Media Scrape Instagram, TikTok, LinkedIn, and more for content research and marketing intelligence. - **[Export Instagram Reels](https://apify.com/rigelbytes/export-instagram-reels)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Facebook Ads Scraper](https://apify.com/rigelbytes/facebook-ads-scraper)** โ€” Extract posts, profiles, and engagement data from Facebook for content research, influencer tracking, and marketing analytics. - **[Instagram Analytics Tool](https://apify.com/rigelbytes/instagram-analytics-tool)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Comment Scraper](https://apify.com/rigelbytes/instagram-comment-scraper)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Creator Stats](https://apify.com/rigelbytes/instagram-creator-stats)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Engagement Tool](https://apify.com/rigelbytes/instagram-engagement-tool)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Post Scraper](https://apify.com/rigelbytes/instagram-post-scraper)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[instagram-posts](https://apify.com/rigelbytes/instagram-posts)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Profile Scraper](https://apify.com/rigelbytes/instagram-profile-scraper)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Reel Scraper](https://apify.com/rigelbytes/instagram-reel-scraper)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[linkedin-company-details](https://apify.com/rigelbytes/linkedin-company-details)** โ€” Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[Linkedin Company Scraper](https://apify.com/rigelbytes/linkedin-company-scraper)** โ€” Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[LinkedIn Job Scraper](https://apify.com/rigelbytes/linkedin-job-scraper)** โ€” Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[LinkedIn Profile Scraper](https://apify.com/rigelbytes/linkedin-profile-scraper)** โ€” Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[Scrape Instagram Creators](https://apify.com/rigelbytes/scrape-instagram-creators)** โ€” Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Tiktok Comment Scraper](https://apify.com/rigelbytes/tiktok-comment-scraper)** โ€” Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[Tiktok Creator Stats](https://apify.com/rigelbytes/tiktok-creator-stats)** โ€” Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[Tiktok Engagement Rate](https://apify.com/rigelbytes/tiktok-engagement-rate)** โ€” Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[TikTok Profile Scraper](https://apify.com/rigelbytes/tiktok-profile-scraper)** โ€” Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[YouTube Comment Scraper](https://apify.com/rigelbytes/youtube-comment-scraper)** โ€” Extract posts, profiles, and engagement data from YouTube for content research, influencer tracking, and marketing analytics. #### ๐Ÿ  Real Estate Extract property listings, prices, and agent data from top real estate platforms. - **[Aengevelt Scraper โ€” German Real Estate Property Listings](https://apify.com/rigelbytes/aengevelt-scraper)** โ€” Extract property listings from Aengevelt Immobilien. Get pricing, location, contact data, and images from Germany's leading real estate platform. - **[Airbnb Address Finder](https://apify.com/rigelbytes/airbnb-address-finder)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Availability Calendar](https://apify.com/rigelbytes/airbnb-availability-calendar)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Detailed Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-detailed-scraper)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Images Downloader](https://apify.com/rigelbytes/airbnb-images-downloader)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Listing](https://apify.com/rigelbytes/airbnb-listing)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Listing Urls](https://apify.com/rigelbytes/airbnb-listing-urls)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Property Details](https://apify.com/rigelbytes/airbnb-property-details)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Reviews](https://apify.com/rigelbytes/airbnb-reviews)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-scraper)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Aqar.fm Scraper โ€” ุงู„ู†ุณุฎุฉ ุงู„ุนุฑุจูŠุฉ](https://apify.com/rigelbytes/aqar-fm-scraper)** โ€” Scrapes Saudi real estate listings from aqar.fm via Next.js RSC search API. Supports Arabic search paths and detailed property data extraction. - **[Bayut Scraper](https://apify.com/rigelbytes/bayut-scraper)** โ€” Scrape property listings and market data from Bayut for market research, price monitoring, and investment analysis. - **[BNP Paribas Real Estate Scraper](https://apify.com/rigelbytes/bnppre-scraper)** โ€” Scrape commercial property listings from BNP Paribas Real Estate (bnppre.de) โ€” offices, retail, industrial, and investment properties across Germany. - **[Boligsiden.dk Scraper](https://apify.com/rigelbytes/boligsiden-dk-scraper)** โ€” Scrape Danish real estate listings from Boligsiden.dk โ€” for sale, sold, and rental properties with pricing, details, and images. - **[CBRE Scraper โ€” Extract German Commercial Property Listings](https://apify.com/rigelbytes/cbre-scraper)** โ€” Scrape commercial real estate letting listings from CBRE Germany (cbre.de). Office & industrial property data for investment analysis. - **[Colliers Scraper โ€” German Commercial Property Listings](https://apify.com/rigelbytes/colliers-scraper)** โ€” Extract commercial property listings from Colliers.de โ€” offices, industrial, retail & logistics with pricing, map data, and images. - **[Daft.ie Property Scraper](https://apify.com/rigelbytes/daft-ie-scraper)** โ€” Scrapes property listings from Daft.ie including residential, rental, commercial, and new homes across Ireland. - **[DAHLER Real Estate Scraper โ€” German Property Listings API](https://apify.com/rigelbytes/dahler-scraper)** โ€” Extract buy and rent property listings from DAHLER Immobilien across Germany, Austria, and Spain. Get prices, images, and agent contact details. - **[dubai-listing-scraper](https://apify.com/rigelbytes/dubai-listing-scraper)** โ€” Extract unlimited property listings from Bayut.com โ€” the UAE's largest real estate platform. Get detailed property data. - **[Export Airbnb Calendar](https://apify.com/rigelbytes/export-airbnb-calendar)** โ€” Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Funda Netherlands Real Estate Scraper](https://apify.com/rigelbytes/funda-nl-scraper)** โ€” Scrape property listings from Funda.nl โ€” the largest real estate platform in the Netherlands. Supports buy and rent, with detailed property data. - **[Furnished Finder Fast](https://apify.com/rigelbytes/furnished-finder-fast)** โ€” Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[Extract Furnished Finder Hosts](https://apify.com/rigelbytes/furnished-finder-hosts)** โ€” Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[FurnishedFinder](https://apify.com/rigelbytes/furnishedfinder)** โ€” Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[German Real Estate MCP](https://apify.com/rigelbytes/german-realestate-mcp)** โ€” MCP server for German real estate โ€” 14 Rigel Bytes scrapers (ImmoScout24, Immowelt, Kleinanzeigen, RE/MAX, CBRE, and more). - **[GrandCityProperty Scraper โ€” Extract German Rental Listings](https://apify.com/rigelbytes/grandcityproperty)** โ€” Extract rental property listings from GrandCityProperty.de โ€” prices, floor plans, energy data, and contact details. - **[Grossmann Berger Scraper โ€” German Real Estate Listings](https://apify.com/rigelbytes/grossmann-berger-scraper)** โ€” Extract property listings, prices, agent contacts, and images from grossmann-berger.de. From $2/1,000 listings. - **[Hemnet.se Scraper - Swedish Real Estate Listings](https://apify.com/rigelbytes/hemnet-se-scraper)** โ€” Scrape property listings from Hemnet.se including for-sale, upcoming, and sold homes. Search by URL or location with full filter support. - **[Immobiliare Italy Real Estate Scraper](https://apify.com/rigelbytes/immobiliare-it-scraper)** โ€” Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immobilienscout24](https://apify.com/rigelbytes/immobilienscout24)** โ€” Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immobilienscout24-scraper](https://apify.com/rigelbytes/immobilienscout24-scraper)** โ€” Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immoweb Scraper - Belgium Property Listings](https://apify.com/rigelbytes/immoweb-scraper)** โ€” Scrapes property listings from Immoweb.be. Supports search result extraction with optional property detail enrichment. - **[Immowelt Property Scraper](https://apify.com/rigelbytes/immowelt-property-scraper)** โ€” The Immowelt Scraper extracts unlimited real estate listings from Immowelt with complete details including prices, locations, and images. - **[Immowelt Scraper](https://apify.com/rigelbytes/immowelt-scraper)** โ€” The Immowelt Scraper extracts unlimited real estate listings from Immowelt with complete details including prices, locations, and images. - **[JLL Property Scraper โ€” Extract Commercial Investment Listings](https://apify.com/rigelbytes/jll-scraper)** โ€” Scrape commercial and investment property data from JLL Germany for office, retail, and logistics properties. - **[Land.com Agents Scraper](https://apify.com/rigelbytes/landdotcom-agents)** โ€” Scrape property listings and market data from Land.com for market research, price monitoring, and investment analysis. - **[Land.com Scraper](https://apify.com/rigelbytes/landdotcom-scraper)** โ€” Scrape property listings and market data from Land.com for market research, price monitoring, and investment analysis. - **[Outdoorsy Scraper](https://apify.com/rigelbytes/outdoorsy-scraper)** โ€” Scrape property listings and market data from Outdoorsy for market research, price monitoring, and investment analysis. - **[PropertyFinder Eygpt](https://apify.com/rigelbytes/propertyfinder-eygpt)** โ€” Scrape property listings and market data from Property Finder for market research, price monitoring, and investment analysis. - **[Propertyfinder Scraper](https://apify.com/rigelbytes/propertyfinder-scraper)** โ€” Scrape property listings and market data from Property Finder for market research, price monitoring, and investment analysis. - **[Realtor.com Agent Scraper](https://apify.com/rigelbytes/realtor-agent-scraper)** โ€” Scrape real estate agents from Realtor.com by city or ZIP code. Optionally fetch full agent profiles and reviews. - **[Realtor.com Scraper](https://apify.com/rigelbytes/realtor-scraper)** โ€” Scrape Realtor.com property listings with full search filters via GraphQL. Supports price, beds/baths, property type, and more. - **[Redfin Scraper](https://apify.com/rigelbytes/redfin-scraper)** โ€” Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis. - **[RE/MAX Germany Scraper](https://apify.com/rigelbytes/remax-scraper)** โ€” Scrapes residential and commercial real estate listings from remax.de by German Bundesland. Extracts prices, areas, images, and agent contacts. - **[Rent.com Scraper](https://apify.com/rigelbytes/rent-com-scraper)** โ€” Scrape rental listings from rent.com โ€” search by location query or URL. Extracts property details, photos, floor plans, and amenities. - **[Rightmove Scraper](https://apify.com/rigelbytes/rightmove-scraper)** โ€” Scrape property listings and market data from Rightmove for market research, price monitoring, and investment analysis. - **[RVshare Scraper](https://apify.com/rigelbytes/rvshare-scraper)** โ€” Scrape property listings and market data from RVshare for market research, price monitoring, and investment analysis. - **[Savills Property Scraper โ€” Extract Listings by Location](https://apify.com/rigelbytes/savills-scraper)** โ€” Scrape residential and commercial property listings from Savills by city. Get prices, addresses, sizes, bedrooms, and agent details. - **[Unlimited Redfin Scraper](https://apify.com/rigelbytes/unlimited-redfin-scraper)** โ€” Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis. - **[Wรผstenrot Immobilien Scraper โ€” German Property Listings API](https://apify.com/rigelbytes/wuestenrot-immobilien)** โ€” Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Zillow Detail Scraper](https://apify.com/rigelbytes/zillow-detail-scraper)** โ€” Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis. - **[Zillow Scraper](https://apify.com/rigelbytes/zillow-scraper)** โ€” Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis. - **[Zoopla Scraper](https://apify.com/rigelbytes/zoopla-scraper)** โ€” Scrape property listings and market data from Zoopla for market research, price monitoring, and investment analysis. #### โœˆ๏ธ Travel & Hospitality Monitor rentals, bookings, and travel listings at scale. - **[Autotrader Scraper](https://apify.com/rigelbytes/autotrader-scraper)** โ€” Scrapes car listings from Autotrader.com with advanced search filters, pagination, and detailed vehicle data. - **[CarMax Scraper](https://apify.com/rigelbytes/carmax-scraper)** โ€” Scrapes used car listings from CarMax.com with search URL, zip code filtering, and pagination support. - **[Cars.com Scraper](https://apify.com/rigelbytes/cars-scraper)** โ€” Scrapes car listings from Cars.com using their GraphQL API. Extracts detailed vehicle data including price, specs, and dealer info. - **[Cars & Bids Scraper](https://apify.com/rigelbytes/carsandbids-scraper)** โ€” Scrape live, upcoming, and past car auctions from Cars & Bids. Extract vehicle details, bids, photos, comments, and more. - **[Ticketmaster Scraper](https://apify.com/rigelbytes/ticketmaster-scraper)** โ€” Collect rental and travel listings from Ticketmaster for pricing intelligence and availability tracking. #### ๐Ÿ›’ E-commerce Scrape products, prices, and marketplace data for competitive research. - **[Amazon Product Scraper](https://apify.com/rigelbytes/amazon-product-scraper)** โ€” Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research. - **[Amazon Search Scraper](https://apify.com/rigelbytes/amazon-scraper)** โ€” Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research. - **[AutoScout24 Scraper](https://apify.com/rigelbytes/autoscout24-scraper)** โ€” Scrape car listings from AutoScout24 with full filter support. Extract makes, models, prices, mileage, seller info, and images. - **[Daraz](https://apify.com/rigelbytes/daraz)** โ€” Scrape products, prices, and seller data from Daraz for competitor monitoring, pricing, and product research. - **[Etsy Scraper](https://apify.com/rigelbytes/etsy-scraper)** โ€” Scrape products, prices, and seller data from Etsy for competitor monitoring, pricing, and product research. - **[Homedepot Scraper](https://apify.com/rigelbytes/homedepot-scraper)** โ€” HomeDepot Products Scraper lets you extract product data from homedepot.com using a collection URL and delivery ZIP. - **[Kleinanzeigen Scraper](https://apify.com/rigelbytes/kleinanzeigen-scraper)** โ€” Scrape listings from kleinanzeigen.de โ€” search results and detail pages for any category (electronics, vehicles, real estate, and more). - **[Otodom Scraper - Polish Real Estate Listings](https://apify.com/rigelbytes/otodom-scraper)** โ€” Scrapes property listings from Otodom.pl, Poland's leading real estate marketplace. Supports filters for transaction type and property features. #### ๐Ÿ’ผ Jobs & Recruitment Collect job listings and company hiring data for market analysis. - **[StepStone Jobs Scraper โ€” Extract German/DACH Job Listings](https://apify.com/rigelbytes/stepstone-jobs-scraper)** โ€” Scrape thousands of job listings from StepStone (DE, AT, BE, NL) with salary, skills, remote status & more. - **[Upwork Jobs Scraper](https://apify.com/rigelbytes/upwork-jobs-scraper)** โ€” Scrapes Upwork freelance job listings by keyword with full search filters (sort, experience, job type, budget, and more). - **[ZipRecruiter Job Scraper](https://apify.com/rigelbytes/ziprecruiter-scraper)** โ€” Scrape job listings from ZipRecruiter with search queries, locations, and radius filters. Extracts title, company, salary, and description. #### ๐Ÿ“ฉ Lead Generation Find business contacts, leads, and company data for sales and outreach. - **[Booli.se Scraper](https://apify.com/rigelbytes/booli-se-scraper)** โ€” Scrapes Swedish real estate listings from Booli.se โ€” for sale, sold prices, and new construction. Supports search and filter-based discovery. - **[Company Service Finder](https://apify.com/rigelbytes/company-service-finder)** โ€” The Company Service Finder uses AI to extract and analyze company services from Google Search & Maps. - **[Doctify Scraper](https://apify.com/rigelbytes/doctify-scraper)** โ€” Doctify Scraper lets you extract doctor and practice data from doctify.com using a search results URL. - **[Doctolib Scraper](https://apify.com/rigelbytes/doctolib-scraper)** โ€” Scrape doctor profiles, availability, and practice details from Doctolib.de โ€” Germany's largest medical appointment booking platform. - **[FindLaw Law Firm Scraper - Attorney & Law Firm Data Extraction](https://apify.com/rigelbytes/findlaw-scraper)** โ€” Scrape law firm profiles from FindLaw.com. Extract detailed attorney and firm information including contact details. - **[Google Maps Scraper](https://apify.com/rigelbytes/google-maps-scraper)** โ€” Find business leads and contact details from Google Maps for outbound sales, prospecting, and CRM enrichment. - **[Website Services Finder](https://apify.com/rigelbytes/website-services-finder)** โ€” Automatically extract and analyze company services from any business website using advanced AI. Choose from 5 AI models. - **[Zillow Agents](https://apify.com/rigelbytes/zillow-agents)** โ€” Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment. - **[Zillow Agents Phone](https://apify.com/rigelbytes/zillow-agents-phone)** โ€” Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment. - **[Zillow Agents Vault](https://apify.com/rigelbytes/zillow-agents-vault)** โ€” Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment. #### โญ Reviews & Ratings Monitor reviews and reputation data across review platforms. - **[Airbnb Listing Reviews](https://apify.com/rigelbytes/airbnb-listing-reviews)** โ€” Collect reviews and ratings from Airbnb for reputation monitoring and customer insights. - **[BBB Scraper](https://apify.com/rigelbytes/bbb-scraper)** โ€” Collect reviews and ratings from BBB for reputation monitoring and customer insights. - **[Costco Product Scraper](https://apify.com/rigelbytes/costco-scraper)** โ€” Scrapes product data from Costco.com including prices, descriptions, ratings, and availability. - **[HRS Hotel Reviews Scraper](https://apify.com/rigelbytes/hrs-hotel-reviews-scraper)** โ€” Extract hotel details, room offers, and guest reviews from HRS hotel URLs. - **[HRS Hotel Scraper](https://apify.com/rigelbytes/hrs-scraper)** โ€” Scrapes hotel listings, prices, ratings, and amenities from HRS (hrs.com) by location and travel dates. - **[Rottentomatoes Reviews Scraper](https://apify.com/rigelbytes/rottentomatoes-reviews-scraper)** โ€” Collect reviews and ratings from Rotten Tomatoes for reputation monitoring and customer insights. - **[Trustpilot Reviews Scraper](https://apify.com/rigelbytes/trustpilot-reviews)** โ€” Collect reviews and ratings from Trustpilot for reputation monitoring and customer insights. #### ๐Ÿ” Food & Delivery Extract restaurant, grocery, and delivery platform data. - **[Instacart Scraper](https://apify.com/rigelbytes/instacart-scraper)** โ€” Scrape menus, stores, and delivery data from Instacart for data-driven research and automation. - **[Publix Scraper](https://apify.com/rigelbytes/publix-scraper)** โ€” Scrape menus, stores, and delivery data from Publix for data-driven research and automation. #### ๐Ÿ› ๏ธ Developer Tools General-purpose scraping and automation tools. - **[EU Tenders Scraper](https://apify.com/rigelbytes/eu-tenders-scraper)** โ€” Scrape EU public procurement notices from TED (Tenders Electronic Daily) with advanced search filters, pagination, and data export. - **[Web Crawler](https://apify.com/rigelbytes/webcrawler)** โ€” This web crawler is designed to provide users with complete flexibility by allowing them to use their own crawling logic. *** ### Understanding Proxies: When scraping data or browsing anonymously, proxies are essential. They act as intermediaries, masking your original IP address and allowing you to send requests from another location. #### Why Use Proxies? - Avoid IP Blocks: By routing requests through proxies, you prevent the target website from recognizing your IP as a scraper or spammer. - Access Geo-restricted Content: Proxies let you access content or websites restricted by location. - Enhance Anonymity: Hide your actual IP, ensuring privacy while scraping or browsing. #### Types of Proxies 1. Residential Proxies - Real IP addresses provided by ISPs to home users. - They mimic regular users, making them harder to detect. - Best for: Long-term, undetectable scraping, and avoiding blocks. 2. Data Center Proxies - IP addresses from servers in data centers. - Faster and cheaper than residential proxies but easier to detect and block. - Best for: High-speed scraping, but with a higher risk of detection. 3. Mobile Proxies - IPs provided by mobile carriers (3G/4G/5G networks). - Very difficult to detect, as they appear as regular mobile users. - Best for: Mobile-related scraping or avoiding sophisticated blocks. #### Rotating Proxies vs. Straight Proxies - Rotating Proxies: Every request you send goes through a different proxy, making it harder for websites to detect patterns. - Straight Proxies: All requests are sent through the same proxy, making it easier to track your IP. *** ### About Rigel Bytes Rigel Bytes specializes in web scraping, automation, and data analytics. We help businesses extract and leverage valuable data for informed decision-making. *** ### Contact Us Ready to unlock the power of data? Reach out to us at (contact@rigelbytes.com) or [book an appointment](https://cal.com/faizanali/appointments) with us to learn more about how we can help you achieve your data goals. *** ### Detailed Data ```json [ { "id": "470675677", "url": "https://www.finn.no/realestate/homes/ad.html?finnkode=470675677", "title": "Enebolig med 3 soverom | Balkong, terrasse og garasje | Ligger landlig til i Skรธelvdalen", "location": "Skรธelvdalen 231, 9310 Sรธrreisa", "priceSuggestion": 1250000, "priceTotal": 1282340, "priceSharedCost": 0, "areaUsable": 172, "bedrooms": 3, "rooms": 4, "propertyType": "Enebolig", "ownershipType": "Selveier", "constructionYear": 1958, "energyLabel": "E", "organisationName": "EiendomsMegler 1 Finnsnes", "publishedAt": "2026-07-24T17:42:00+00:00", "imageUrl": "https://images.finncdn.no/dynamic/default/2026/7/vertical-2/24/7/470/675/677_8685aebe-5ba0-4089-aa60-1321d855748a.jpg", "latitude": 69.11598185054471, "longitude": 18.018504483094624, "source": "detail" }, { "id": "470534294", "url": "https://www.finn.no/realestate/homes/ad.html?finnkode=470534294", "title": "Koselig eiendom med utsikt mot fjorden | Stor terrasse og naturskjรธnne omgivelser", "location": "Labergshaugen 17, 9350 Sjรธvegan", "priceSuggestion": 850000, "priceTotal": 872340, "priceSharedCost": 0, "areaUsable": 45, "bedrooms": 1, "rooms": 2, "propertyType": "Enebolig", "ownershipType": "Selveier", "constructionYear": 1996, "energyLabel": "D", "organisationName": "EiendomsMegler 1 Finnsnes", "publishedAt": "2026-07-24T17:25:19+00:00", "imageUrl": "https://images.finncdn.no/dynamic/default/2026/7/vertical-2/22/4/470/534/294_541649e9-1529-4254-8033-c850366a98e3.jpg", "latitude": 68.86034948568887, "longitude": 17.81477817989547, "source": "detail" } ] ``` # Actor input Schema ## `startUrls` (type: `array`): Preferred input. Finn.no real-estate search page URLs (search.html with any filters already applied), e.g. https://www.finn.no/realestate/homes/search.html?location=0.20061\&property\_type=3. When provided, these take priority over structured filters below. ## `searchQuery` (type: `string`): Free-text search in Finn Eiendom (q). Used when building a search from filters (or ignored when startUrls already encode the query). ## `publishedToday` (type: `boolean`): Only listings published today (published=1 / Nye i dag). ## `locations` (type: `array`): Norwegian counties or Finn location codes. Names (Oslo, Nordland, Innlandet, Finnmark, โ€ฆ) are mapped to Finn codes; you can also paste codes such as 0.20061. ## `saleStatus` (type: `array`): Salgsstatus: for sale, sold last 3 days, or coming for sale. ## `propertyCondition` (type: `string`): Tilstand: used housing or new construction. ## `priceFrom` (type: `integer`): Minimum asking price in NOK (price\_from). ## `priceTo` (type: `integer`): Maximum asking price in NOK (price\_to). ## `totalPriceFrom` (type: `integer`): Minimum total price in NOK (price\_collective\_from). ## `totalPriceTo` (type: `integer`): Maximum total price in NOK (price\_collective\_to). ## `sharedCostFrom` (type: `integer`): Minimum common expenses per month in NOK (rent\_from / fellesutgifter). ## `sharedCostTo` (type: `integer`): Maximum common expenses per month in NOK (rent\_to). ## `areaFrom` (type: `integer`): Minimum living area in square meters (area\_from). ## `areaTo` (type: `integer`): Maximum living area in square meters (area\_to). ## `minBedrooms` (type: `integer`): Minimum number of bedrooms (1โ€“5 maps to Finn min\_bedrooms). ## `constructionYearFrom` (type: `integer`): Earliest construction year (construction\_year\_from). ## `constructionYearTo` (type: `integer`): Latest construction year (construction\_year\_to). ## `plotAreaFrom` (type: `integer`): Minimum plot / tomt size (plot\_area\_from). ## `plotAreaTo` (type: `integer`): Maximum plot / tomt size (plot\_area\_to). ## `propertyTypes` (type: `array`): Boligtype filters (apartment, detached, townhouse, semi-detached, farm, etc.). ## `ownershipTypes` (type: `array`): Eierform: stock, share, bond, freeholder, other. ## `sellerTypes` (type: `array`): Privat/Megler filter. ## `facilities` (type: `array`): Fasiliteter such as balcony, elevator, garage, view, EV charging, etc. ## `energyLabels` (type: `array`): Energikarakter Aโ€“G. ## `floors` (type: `array`): Etasje filter values: NOTFIRST, 1โ€“6, or BIG (over 6th floor). ## `videoTypes` (type: `array`): Digitale visninger: video and/or 360ยฐ. ## `scrapeDetails` (type: `boolean`): When enabled, opens each listing and extracts full details (description, all images, facilities, viewings, cadastre, etc.). Slower but much richer output. ## `includeContactInfo` (type: `boolean`): When enabled, extracts agent/broker or private seller contact information (phone, email). Performs a detail page fetch per listing. ## `maxItems` (type: `integer`): Maximum number of listings to scrape (0 = unlimited). ## `proxyConfiguration` (type: `object`): Apify proxy settings. Residential proxies are recommended for Finn.no. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.finn.no/realestate/homes/search.html?location=0.20061" } ], "publishedToday": false, "propertyCondition": "", "scrapeDetails": false, "includeContactInfo": false, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing scraped Finn.no real-estate listings ## `runStats` (type: `string`): Key-value store record with recordsScraped and run timestamps # 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 = { "startUrls": [ { "url": "https://www.finn.no/realestate/homes/search.html?location=0.20061" } ], "searchQuery": "", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("rigelbytes/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 = { "startUrls": [{ "url": "https://www.finn.no/realestate/homes/search.html?location=0.20061" }], "searchQuery": "", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("rigelbytes/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 '{ "startUrls": [ { "url": "https://www.finn.no/realestate/homes/search.html?location=0.20061" } ], "searchQuery": "", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call rigelbytes/finn-no-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rigelbytes/finn-no-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Finn.no Real Estate Scraper", "description": "Scrape Norwegian real-estate listings from Finn.no with search URL or filter-based discovery, optional full details and broker contact info.", "version": "1.0", "x-build-id": "cmLbFUVG91i8SRoOS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rigelbytes~finn-no-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rigelbytes-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/rigelbytes~finn-no-scraper/runs": { "post": { "operationId": "runs-sync-rigelbytes-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/rigelbytes~finn-no-scraper/run-sync": { "post": { "operationId": "run-sync-rigelbytes-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": { "startUrls": { "title": "Search URLs", "type": "array", "description": "Preferred input. Finn.no real-estate search page URLs (search.html with any filters already applied), e.g. https://www.finn.no/realestate/homes/search.html?location=0.20061&property_type=3. When provided, these take priority over structured filters below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Free-text search in Finn Eiendom (q). Used when building a search from filters (or ignored when startUrls already encode the query)." }, "publishedToday": { "title": "New Today", "type": "boolean", "description": "Only listings published today (published=1 / Nye i dag).", "default": false }, "locations": { "title": "Areas / Counties", "uniqueItems": true, "type": "array", "description": "Norwegian counties or Finn location codes. Names (Oslo, Nordland, Innlandet, Finnmark, โ€ฆ) are mapped to Finn codes; you can also paste codes such as 0.20061.", "items": { "type": "string", "enum": [ "Oslo", "Akershus", "ร˜stfold", "Innlandet", "Buskerud", "Vestfold", "Telemark", "Agder", "Rogaland", "Vestland", "Mรธre og Romsdal", "Trรธndelag", "Nordland", "Troms", "Finnmark", "Svalbard" ] } }, "saleStatus": { "title": "Sale Status", "uniqueItems": true, "type": "array", "description": "Salgsstatus: for sale, sold last 3 days, or coming for sale.", "items": { "type": "string", "enum": [ "for_sale", "sold_last_3_days", "coming_for_sale" ], "enumTitles": [ "For sale (Til salgs)", "Sold last 3 days (Solgt siste 3 dager)", "Coming for sale (Kommer for salg)" ] } }, "propertyCondition": { "title": "Condition", "enum": [ "", "used", "new" ], "type": "string", "description": "Tilstand: used housing or new construction.", "default": "" }, "priceFrom": { "title": "Min Price (Prisantydning)", "minimum": 0, "type": "integer", "description": "Minimum asking price in NOK (price_from)." }, "priceTo": { "title": "Max Price (Prisantydning)", "minimum": 0, "type": "integer", "description": "Maximum asking price in NOK (price_to)." }, "totalPriceFrom": { "title": "Min Total Price", "minimum": 0, "type": "integer", "description": "Minimum total price in NOK (price_collective_from)." }, "totalPriceTo": { "title": "Max Total Price", "minimum": 0, "type": "integer", "description": "Maximum total price in NOK (price_collective_to)." }, "sharedCostFrom": { "title": "Min Shared Cost / Month", "minimum": 0, "type": "integer", "description": "Minimum common expenses per month in NOK (rent_from / fellesutgifter)." }, "sharedCostTo": { "title": "Max Shared Cost / Month", "minimum": 0, "type": "integer", "description": "Maximum common expenses per month in NOK (rent_to)." }, "areaFrom": { "title": "Min Size (mยฒ)", "minimum": 0, "type": "integer", "description": "Minimum living area in square meters (area_from)." }, "areaTo": { "title": "Max Size (mยฒ)", "minimum": 0, "type": "integer", "description": "Maximum living area in square meters (area_to)." }, "minBedrooms": { "title": "Minimum Bedrooms", "minimum": 1, "maximum": 5, "type": "integer", "description": "Minimum number of bedrooms (1โ€“5 maps to Finn min_bedrooms)." }, "constructionYearFrom": { "title": "Min Year of Construction", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Earliest construction year (construction_year_from)." }, "constructionYearTo": { "title": "Max Year of Construction", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Latest construction year (construction_year_to)." }, "plotAreaFrom": { "title": "Min Plot Size (mยฒ)", "minimum": 0, "type": "integer", "description": "Minimum plot / tomt size (plot_area_from)." }, "plotAreaTo": { "title": "Max Plot Size (mยฒ)", "minimum": 0, "type": "integer", "description": "Maximum plot / tomt size (plot_area_to)." }, "propertyTypes": { "title": "Housing Type", "uniqueItems": true, "type": "array", "description": "Boligtype filters (apartment, detached, townhouse, semi-detached, farm, etc.).", "items": { "type": "string", "enum": [ "apartment", "detached", "townhouse", "semi-detached", "farm", "garage", "industrial", "plot", "multi-family", "other" ], "enumTitles": [ "Apartment (Leilighet)", "Detached house (Enebolig)", "Townhouse (Rekkehus)", "Semi-detached (Tomannsbolig)", "Farm / smallholding (Gรฅrdsbruk/Smรฅbruk)", "Garage / parking", "Production / industrial", "Plot (Tomt)", "Multi-family (Bygรฅrd)", "Other" ] } }, "ownershipTypes": { "title": "Ownership", "uniqueItems": true, "type": "array", "description": "Eierform: stock, share, bond, freeholder, other.", "items": { "type": "string", "enum": [ "stock", "share", "bond", "freeholder", "other" ], "enumTitles": [ "Stock (Aksje)", "Share (Andel)", "Bond (Obligasjon)", "Freeholder (Selveier)", "Other (Annet)" ] } }, "sellerTypes": { "title": "Private / Broker", "uniqueItems": true, "type": "array", "description": "Privat/Megler filter.", "items": { "type": "string", "enum": [ "broker", "private" ], "enumTitles": [ "Broker (Megler)", "Private seller (Privat)" ] } }, "facilities": { "title": "Facilities", "uniqueItems": true, "type": "array", "description": "Fasiliteter such as balcony, elevator, garage, view, EV charging, etc.", "items": { "type": "string", "enum": [ "balcony", "fireplace", "elevator", "no_neighbors", "modern", "airconditioning", "beachfront", "hiking", "garage", "laundry", "alarm", "broadband", "caretaker", "view", "ev_charging" ], "enumTitles": [ "Balcony / terrace", "Fireplace", "Elevator", "No neighbors opposite", "Modern", "Air conditioning", "Beachfront", "Hiking terrain", "Garage / parking", "Shared laundry", "Alarm", "Broadband", "Caretaker / security", "View", "EV charging" ] } }, "energyLabels": { "title": "Energy Label", "uniqueItems": true, "type": "array", "description": "Energikarakter Aโ€“G.", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G" ] } }, "floors": { "title": "Floor", "uniqueItems": true, "type": "array", "description": "Etasje filter values: NOTFIRST, 1โ€“6, or BIG (over 6th floor).", "items": { "type": "string", "enum": [ "NOTFIRST", "1", "2", "3", "4", "5", "6", "BIG" ], "enumTitles": [ "Not 1st floor", "1st floor", "2nd floor", "3rd floor", "4th floor", "5th floor", "6th floor", "Above 6th floor" ] } }, "videoTypes": { "title": "Digital Viewings", "uniqueItems": true, "type": "array", "description": "Digitale visninger: video and/or 360ยฐ.", "items": { "type": "string", "enum": [ "1", "2" ], "enumTitles": [ "Video", "360 viewing" ] } }, "scrapeDetails": { "title": "Fetch Full Listing Details", "type": "boolean", "description": "When enabled, opens each listing and extracts full details (description, all images, facilities, viewings, cadastre, etc.). Slower but much richer output.", "default": false }, "includeContactInfo": { "title": "Include Broker / Seller Contact", "type": "boolean", "description": "When enabled, extracts agent/broker or private seller contact information (phone, email). Performs a detail page fetch per listing.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape (0 = unlimited).", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. Residential proxies are recommended for Finn.no.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```