Finn.no Scraper

Scrape Finn.no — Norway's #1 classifieds marketplace (~5M listings/month). Extracts search results and optional detail page data with parallel fetching for speed.

Features

• Search results: title, price, location, image, URL, item ID
• Detail pages (optional): description, brand, condition, category path, images, dates, seller type
• Price filtering: min/max price in NOK
• Region filtering: Oslo, Bergen, Trondheim, Stavanger, Tromsø, etc.
• Sort: newest, price_low, price_high, most_relevant
• Multi-page pagination: scrape up to 10 pages
• Multiple output formats: JSON, CSV, Excel, Markdown, JSON Lines
• Parallel detail fetching: 10 concurrent requests per batch — 50 listings in ~10s
• CheerioCrawler: only 268MB RAM required

Input Parameters

Parameter	Type	Default	Description
searchQuery	string	(required)	Search term (e.g., "iphone", "bil", "leilighet")
maxPages	int	1	Number of search result pages (1-10)
priceMin	int	null	Minimum price in NOK
priceMax	int	null	Maximum price in NOK
regions	string[]	[]	Filter by region (e.g., ["Oslo", "Bergen"])
sort	string	"newest"	Sort order: newest, price_low, price_high, most_relevant
fetchDetails	bool	false	Fetch detail pages for description, brand, condition, etc.
detailDelaySecs	float	1.5	Delay between detail-fetch batches in seconds
outputFormat	string	"json"	json, csv, excel, markdown, jsonl
webhookUrl	string	null	Webhook URL for real-time notifications

Example Input

{
  "searchQuery": "iphone 17",
  "maxPages": 2,
  "sort": "newest",
  "fetchDetails": true,
  "priceMin": 5000,
  "priceMax": 20000,
  "regions": ["Oslo", "Bergen"],
  "outputFormat": "json"
}

Output Fields

Search Results (always included)

Field	Type	Description
title	string	Listing title
price	string	Price with currency (e.g., "13 000 kr")
price_numeric	int	Price as number for sorting/filtering
location	string	City/area
region	string	County/region
url	string	Listing URL
image_url	string	Thumbnail image URL
item_id	string	Finn.no item ID
search_query	string	The search query used
page_number	int	Which search page this was on
scraped_at	ISO 8601	Timestamp

Detail Fields (when fetchDetails: true)

Field	Type	Description
description	string	Full listing description
condition	string	Ny (New), Brukt (Used)
brand	string	Brand name
category_path	string	Full category hierarchy
images	string[]	All image URLs
published_date	ISO 8601	When listing was posted
last_modified	ISO 8601	Last update timestamp
seller_type	string	Private/Commercial seller

Pricing

$1 per 1,000 runs.

💬 Quick Start for AI Assistants

Copy and paste this into ChatGPT, Claude, or another AI assistant to get help using this actor:

---

You are helping me use the "Finn.no Scraper" on Apify (actor ID: hvYc7OiwY0YWhxEQ1). It extracts listings from finn.no, Norway's #1 classifieds marketplace.

Input fields:

• searchQuery: string, e.g. "iphone"
• maxPages: number, pages to scrape (default: 1)
• priceMin, priceMax: number, filter by NOK (default: none)
• regions: string array, e.g. ["Oslo", "Bergen"]
• sort: string, "newest" | "price_low" | "price_high" | "most_relevant"
• fetchDetails: boolean, visit detail pages for descriptions, condition, brand
• detailDelaySecs: number, seconds between detail visits (default: 1.5)
• outputFormat: "json" | "csv" | "excel" | "markdown" | "jsonl"
• webhookUrl: string, optional HTTPS URL for POST delivery

Output fields: title, price, price_numeric, location, region, url, image_url, item_id, search_query, page_number, scraped_at + detail fields (description, condition, brand, category_path, images).

Help me with the right input, output processing, or troubleshooting.

Changelog

Version	Date	Changes
0.1.0	2026-07-17	Initial release — Finn.no listing extraction with CheerioCrawler (268MB RAM), parallel detail fetching, region/price filtering