Finn.no Scraper

Scrape Finn.no — Norway's largest online classifieds marketplace with millions of listings across items for sale, cars, motorcycles, boats, trucks & trailers, buses, construction machinery, agriculture equipment, caravans, motorhomes, real estate (for sale, for rent, holiday homes, plots, commercial, businesses for sale), and jobs. Choose from 24 modes to target one specific vertical with its own rich filter set (price, year, mileage, location, and more), or fan out across the 5 highest-volume categories in a single run with searchAll. HTTP-only — no login, cookies, API key, or proxy required.

What this actor does

• 24 modes — items, cars, motorcycles & mopeds, boats, trucks & trailers, buses, construction machinery, agriculture equipment, caravans, motorhomes, 11 real-estate sub-verticals, and jobs, each with its own filters and output fields
• searchAll fan-out — one run across items, cars, real estate for sale, real estate for rent, and jobs — the 5 highest-volume categories
• Deep per-vertical filters — make/model-adjacent enums, condition/fuel/transmission dropdowns, equipment & amenity checklists, and year/mileage/price/power/area range filters
• Sort & scope controls — relevance, newest/oldest, price, or distance; filter by Norwegian county (fylke) and "published today"
• Empty fields are omitted — only fields with real data are returned; nothing comes back as null

Output per listing

• adId — Finn.no ad ID (finnkode)
• heading — ad headline
• vertical — human-readable category, e.g. Items for sale, Cars & vehicles, Boats, Real estate (for sale), Jobs
• price — price in NOK (asking price for real estate for sale, monthly rent for real estate for rent)
• currency — always NOK
• priceTotal — total price incl. costs (real estate for sale)
• sharedCostMonthly — monthly shared/common cost (real estate for sale)
• location — listing location (city/street)
• publishedDate — ISO timestamp the ad was published
• imageUrl — first/cover image URL
• imageUrls — all gallery image URLs (items, cars, mc, boats, real estate)
• adUrl — direct link to the listing
• seller — seller/dealer/company/broker name (cars, mc, boats, jobs, real estate)
• brand — product brand (items)
• condition — ad/trade type: Til salgs (for sale), Gis bort (giving away), or Ønskes kjøpt (wanted) (items)
• sellerType — private seller vs. dealer (items)
• make, carModel, modelSpecification, year, mileage, mileageUnit, transmission, fuel, dealerSegment — vehicle specs (cars, mc, trucks, buses, construction machinery, agriculture, caravans, motorhomes; field subset varies by vertical)
• drivingRangeKm — WLTP driving range in km (cars, EVs only)
• warrantyMonths — remaining warranty duration in months (cars, mc, when attached)
• registrationClass — registration/tax class, e.g. Personbil (cars)
• vin — vehicle identification number (cars, mc, when disclosed)
• salesForm — sales form, e.g. Bruktbil til salgs, Leasing, Auksjon (cars only)
• regNo — vehicle registration number (mc, trucks, buses, motorhomes, when disclosed)
• engineVolumeCc — engine displacement in cc (mc, motorhomes)
• hoursUsed — operating hours, the agricultural equivalent of mileage (agriculture, when disclosed)
• motorType — motor placement, e.g. Innenbords (inboard), Utenbords (outboard) (boats)
• motorFuel — motor fuel type (boats)
• motorPowerHp — motor power in horsepower (boats)
• boatClass — boat type/class, e.g. Yacht, Seilbåt/Motorseiler (boats)
• boatLengthFt — length in feet (boats)
• boatWidthCm — beam/width in cm (boats)
• boatMaxSpeedKnots — top speed in knots (boats, when disclosed)
• positions, jobLocations — number of open positions, all listed locations (jobs)
• applicationDeadline — ISO timestamp of the application deadline (jobs, when set)
• propertyType, ownerType, neighborhood, bedrooms, areaSizeSqm, plotSizeSqm — property details (real estate, all 11 sub-verticals; plotSizeSqm is the primary size field for plot-only sub-verticals)
• viewingTimes — ISO timestamps of upcoming open-house viewings (real estate, when scheduled)
• furnished — furnished status (Møblert/Delvis møblert/Umøblert) (real estate for rent)
• mode — which mode produced this record, e.g. searchItems, searchCars, searchRealEstate
• scrapedAt — ISO timestamp of scrape

Only fields with real data are included — empty/unavailable fields are omitted rather than returned as null. A real 0 (e.g. a sailboat with no engine) is always kept; only truly absent values are omitted.

Note on condition vs. the itemCondition input filter: these are different concepts. itemCondition narrows search results by the item's physical condition (brand new, like new, well used, etc.) — a search-only facet Finn.no doesn't echo back per listing. The condition output field reflects whether the ad is a sale, a free giveaway, or a "wanted" post — always available, but a different concept. If you want a filter whose value shows up in the output condition field, use tradeType instead.

Input

Field	Type	Default	Description
mode	select	searchItems	searchAll, searchCars, searchMc, searchBoats, searchRealEstate, searchRealEstateRentals, searchRealEstateLeisureSale, searchRealEstateLeisurePlots, searchRealEstateAbroad, searchRealEstateNewBuildings, searchRealEstatePlots, searchRealEstateBusinessSale, searchRealEstateBusinessRent, searchRealEstateBusinessPlots, searchRealEstateCompanyForSale, searchTrucks, searchBuses, searchConstructionMachinery, searchAgricultureTractors, searchAgricultureCombines, searchAgricultureTools, searchCaravans, searchMotorhomes, searchJobs, searchItems
query	string	iPhone	Keyword to search. Leave empty to browse all listings in the selected category
sortBy	select	relevance	relevance, newest, oldest, priceAsc, priceDesc, closest
location	select	– (any county)	Norwegian county (fylke) — applies to every mode, including each vertical inside searchAll
category	select	– (any category)	Torget top-level category (mode=searchItems)
itemCondition	select	– (any condition)	Item's physical condition, e.g. "Brand new", "Like new" (mode=searchItems); narrows results but is not itself echoed on any output field — see the condition note above
tradeType	select	– (any ad type)	Ad type — for sale / giving away / wanted (mode=searchItems); value IS reflected on the output condition field
forRent	select	– (either)	Buy vs. rent (mode=searchItems)
sellerType	select	– (any seller)	Private seller vs. dealer (mode=searchItems)
carFuel	select	– (any fuel)	Vehicle fuel type, e.g. Petrol, Diesel, Electric (mode=searchCars)
carBodyType	select	– (any body type)	Vehicle body type, e.g. SUV, Sedan, Estate (mode=searchCars)
carTransmission	select	– (any transmission)	Automatic or Manual gearbox (mode=searchCars)
carDealerSegment	select	– (any seller)	Private / brand dealer / other dealer (mode=searchCars)
carWheelDrive	select	– (any drivetrain)	Front / rear / four-wheel drive (mode=searchCars)
carColour	select	– (any colour)	Exterior colour, 16 values (mode=searchCars)
carSalesForm	select	– (any sales form)	Used/new/leasing/auction/offers-wanted (mode=searchCars)
carRegistrationClass	select	– (any class)	Vehicle registration/tax class — passenger car, van, light truck, etc. (mode=searchCars)
carWarrantyInsurance	select	– (any)	Warranty / right-of-exchange / manufacturer-programme offer attached (mode=searchCars)
carDocumentation	select	– (any)	Which report/history document is attached (mode=searchCars)
carWheelSets	select	– (any)	One vs. two-or-more wheel sets included (mode=searchCars)
carEquipment	array (multi-select)	– (any)	Equipment checklist, e.g. Bluetooth, cruise control, tow hitch (mode=searchCars); matches any selected item
carSmoothTrade	boolean	false	Only cars enrolled in Finn's "Smidig bilhandel" programme (mode=searchCars)
carYearMin / carYearMax	integer	–	Model year range (mode=searchCars)
carMileageMin / carMileageMax	integer	–	Odometer range in km (mode=searchCars)
carEnginePowerMin / carEnginePowerMax	integer	–	Engine power range in hp (mode=searchCars)
carSeatsMin / carSeatsMax	integer	–	Number-of-seats range (mode=searchCars)
carDrivingRangeMin / carDrivingRangeMax	integer	–	WLTP driving range in km, EVs (mode=searchCars)
carTrailerWeightMin / carTrailerWeightMax	integer	–	Allowed trailer weight range in kg (mode=searchCars)
jobExtent	select	– (any extent)	Full-time or Part-time (mode=searchJobs)
jobDuration	select	– (any form)	Employment form — permanent, temporary, project, etc. (mode=searchJobs)
jobSector	select	– (any sector)	Private / public / organizations / cooperative (mode=searchJobs)
jobWorkingLanguage	select	– (any language)	Norwegian or English (mode=searchJobs)
jobHomeOffice	select	– (any arrangement)	At the office / partly remote / fully remote (mode=searchJobs)
jobManagerRole	select	– (any level)	Manager / team lead / director (mode=searchJobs)
jobWorkExperience	select	– (any level)	No experience / junior / experienced / management (mode=searchJobs)
jobEducation	select	– (any level)	Required education level, 8 values (mode=searchJobs)
jobOccupation	select	– (any occupation)	Top-level occupation, 84 values (mode=searchJobs)
jobIndustry	select	– (any industry)	Employer industry, 69 values (mode=searchJobs)
jobApplicationDeadline	select	– (any)	How soon the application deadline is (mode=searchJobs)
propertyType	select	– (any property type)	Property type, e.g. Apartment, Detached house (mode=searchRealEstate / searchRealEstateRentals)
realEstateLifecycle	select	– (any status)	For sale / sold in last 3 days / coming for sale (mode=searchRealEstate)
realEstateIsNewProperty	select	– (either)	New build vs. resale (mode=searchRealEstate)
realEstateOwnershipType	select	– (any type)	Freehold / co-op share / housing-company share / bond (mode=searchRealEstate)
realEstateEnergyLabel	select	– (any label)	Official energy rating A–G (mode=searchRealEstate)
realEstateFloor	select	– (any floor)	Which floor the unit is on (mode=searchRealEstate / searchRealEstateRentals)
realEstateFurnished	select	– (any furnishing)	Furnished / partly furnished / unfurnished (mode=searchRealEstateRentals)
realEstateAnimalsAllowed	select	– (any)	Only rentals that explicitly allow pets (mode=searchRealEstateRentals)
realEstateMinBedrooms	select	– (any)	Minimum bedroom count, "N+" (mode=searchRealEstate / searchRealEstateRentals)
realEstateSellerType	select	– (any)	Private seller vs. estate broker (mode=searchRealEstate)
realEstateFacilities	array (multi-select)	– (any)	Amenities checklist, e.g. balcony, elevator, EV charging (mode=searchRealEstate / searchRealEstateRentals); matches any selected item
realEstateAreaSqmMin / realEstateAreaSqmMax	integer	–	Internal floor-area range in m² (mode=searchRealEstate / searchRealEstateRentals)
realEstateConstructionYearMin / realEstateConstructionYearMax	integer	–	Construction year range (mode=searchRealEstate)
realEstatePlotSizeSqmMin / realEstatePlotSizeSqmMax	integer	–	Plot/land size range in m² (mode=searchRealEstate)
realEstateCommonCostMin / realEstateCommonCostMax	integer	–	Shared/common monthly cost range in NOK (mode=searchRealEstate)
realEstateTotalPriceMin / realEstateTotalPriceMax	integer	–	Total price incl. collective debt, NOK range (mode=searchRealEstate)
mcType	select	– (any type)	Motorcycle/moped/ATV/snowmobile type, 21 values (mode=searchMc)
mcCondition	select	– (either)	New vs. used motorcycle (mode=searchMc)
mcFuel	select	– (any fuel)	Motorcycle fuel type (mode=searchMc)
mcYearMin / mcYearMax	integer	–	Model year range (mode=searchMc)
mcMileageMin / mcMileageMax	integer	–	Odometer range in km (mode=searchMc)
mcEnginePowerMin / mcEnginePowerMax	integer	–	Engine power range in hp (mode=searchMc)
mcEngineVolumeMin / mcEngineVolumeMax	integer	–	Engine displacement range in cc (mode=searchMc)
boatClass	select	– (any class)	Boat type/class, 15 values (mode=searchBoats)
boatMotorType	select	– (any)	Inboard / outboard / other motor placement (mode=searchBoats)
boatFuel	select	– (any fuel)	Boat motor fuel type (mode=searchBoats)
boatMaterial	select	– (any material)	Hull building material (mode=searchBoats)
boatYearMin / boatYearMax	integer	–	Model year range (mode=searchBoats)
boatLengthFtMin / boatLengthFtMax	integer	–	Length range in feet (mode=searchBoats)
boatMotorPowerMin / boatMotorPowerMax	integer	–	Motor power range in hp (mode=searchBoats)
boatWidthCmMin / boatWidthCmMax	integer	–	Beam/width range in cm (mode=searchBoats)
boatMaxSpeedMin / boatMaxSpeedMax	integer	–	Top speed range in knots (mode=searchBoats)
truckSegment	select	– (any group)	Vehicle group, e.g. Tow truck, Tanker, Crane truck, 21 values (mode=searchTrucks)
busSegment	select	– (any group)	Bus / minibus / other (mode=searchBuses)
constructionSegment	select	– (any category)	Machinery category, e.g. Excavator, Wheel loader, Crane, 17 values (mode=searchConstructionMachinery)
agricultureToolsType	select	– (any category)	Implement category, e.g. Tillage, Sprayers, Forestry, 12 values (mode=searchAgricultureTools)
commercialDealerSegment	select	– (any seller)	Private seller vs. dealer (mode=searchTrucks / searchBuses / searchConstructionMachinery / agriculture modes)
truckYearMin / truckYearMax	integer	–	Model year range (mode=searchTrucks)
truckEnginePowerMin / truckEnginePowerMax	integer	–	Engine power range in hp (mode=searchTrucks)
truckWeightMin / truckWeightMax	integer	–	Total weight range in kg (mode=searchTrucks)
busYearMin / busYearMax	integer	–	Model year range (mode=searchBuses)
busEnginePowerMin / busEnginePowerMax	integer	–	Engine power range in hp (mode=searchBuses)
constructionYearMin / constructionYearMax	integer	–	Model year range (mode=searchConstructionMachinery)
constructionEnginePowerMin / constructionEnginePowerMax	integer	–	Engine power range in hp (mode=searchConstructionMachinery)
agricultureYearMin / agricultureYearMax	integer	–	Model year range (agriculture modes)
agricultureEnginePowerMin / agricultureEnginePowerMax	integer	–	Engine power range in hp (mode=searchAgricultureTractors / searchAgricultureCombines)
caravanSegment	select	– (any group)	Vehicle group — Caravan / Trailer tent / Other (mode=searchCaravans)
motorhomeSegment	select	– (any type)	Body type — Alcove / A-class / Van conversion / etc., 5 values (mode=searchMotorhomes)
rvCondition	select	– (either)	New vs. used (mode=searchCaravans / searchMotorhomes)
rvLocation	select	– (any)	Currently in Norway vs. abroad (mode=searchCaravans / searchMotorhomes)
rvSleepers	select	– (any)	Sleeper-berth bucket, e.g. "3-4" (mode=searchCaravans / searchMotorhomes)
motorhomeSeats	select	– (any)	Registered seat-count bucket, e.g. "4-5" (mode=searchMotorhomes)
motorhomeTransmission	select	– (any)	Automatic or Manual gearbox (mode=searchMotorhomes)
motorhomeWheelDrive	select	– (any)	Front / rear / four-wheel drive (mode=searchMotorhomes)
caravanDealerSegment	select	– (any seller)	Private seller vs. dealer (mode=searchCaravans / searchMotorhomes)
caravanYearMin / caravanYearMax	integer	–	Model year range (mode=searchCaravans)
caravanWeightMin / caravanWeightMax	integer	–	Total weight range in kg (mode=searchCaravans)
caravanLengthMin / caravanLengthMax	integer	–	Length range in cm (mode=searchCaravans)
caravanWidthMin / caravanWidthMax	integer	–	Width range in cm (mode=searchCaravans)
motorhomeYearMin / motorhomeYearMax	integer	–	Model year range (mode=searchMotorhomes)
motorhomeWeightMin / motorhomeWeightMax	integer	–	Total weight range in kg (mode=searchMotorhomes)
motorhomeLengthMin / motorhomeLengthMax	integer	–	Length range in cm (mode=searchMotorhomes)
motorhomeMileageMin / motorhomeMileageMax	integer	–	Odometer range in km (mode=searchMotorhomes)
motorhomeEnginePowerMin / motorhomeEnginePowerMax	integer	–	Engine power range in hp (mode=searchMotorhomes)
itemFreeShippingOnly	boolean	false	Only item listings offering free shipping (mode=searchItems)
publishedToday	boolean	false	Only listings published today ("Nye i dag") — applies to every mode
priceMin	integer	–	Min price in NOK
priceMax	integer	–	Max price in NOK
maxItems	integer	20	Max listings to return (1–1000). For searchAll, split evenly across the 5 categories

Note on maxItems with no query: requesting a large maxItems (e.g. 1000) with query left empty (browsing all listings in a category) can return fewer records than requested, because Finn.no's query-less browse view doesn't advance monotonically across result pages. When this happens the run's status message reports the shortfall explicitly (e.g. "Scraped 721 listings from Finn.no (fewer than the requested 1000: ...)") instead of silently truncating. Searches with a real query (including the default query: "iPhone") reliably deliver the full requested count.

Every mode-specific filter above is simply ignored when the selected mode doesn't support it — no error, no crash. When running searchAll, every filter is applied to the vertical(s) it belongs to (e.g. carFuel only affects the cars leg).

Example: quick keyword search

{
  "mode": "searchItems",
  "query": "iPhone",
  "sortBy": "newest",
  "maxItems": 30
}

Example: filtered used-car search

{
  "mode": "searchCars",
  "carFuel": "El",
  "carYearMin": 2020,
  "carMileageMax": 50000,
  "location": "Oslo",
  "sortBy": "priceAsc",
  "maxItems": 25
}

Example: rental apartments in a specific area

{
  "mode": "searchRealEstateRentals",
  "location": "Oslo",
  "priceMax": 15000,
  "realEstateMinBedrooms": "2+",
  "maxItems": 20
}

Example: cross-category daily snapshot

{
  "mode": "searchAll",
  "query": "sykkel",
  "publishedToday": true,
  "maxItems": 50
}

Use cases

• Resale & arbitrage — track newly listed items and price movements to spot resale opportunities
• Car dealerships & buyers — monitor the used-car market for specific makes, fuel types, or price bands
• Real estate agencies & investors — watch new for-sale or rental listings in a target county or neighbourhood
• Recruiters & job boards — aggregate open positions by industry, sector, or work arrangement
• Market researchers & pricing analysts — build cross-category snapshots of NOK pricing trends with searchAll
• Equipment & fleet buyers — source used trucks, construction machinery, or agriculture equipment by year and engine power

FAQ

What is Finn.no? Finn.no is Norway's largest online marketplace, operated by Schibsted Media Group. It hosts millions of listings for items, cars, motorcycles, boats, real estate, jobs, travel, and more.

Do I need a Finn.no account? No. Public listings are accessible without login, cookies, or an API key.

How are prices returned? Prices are in Norwegian Krone (NOK) as integers.

What does "Search all categories" (searchAll) do? It queries items, cars, real estate for sale, real estate for rent, and jobs in the same run and splits maxItems evenly across those five categories, giving a cross-category snapshot in a single run. The niche verticals (motorcycles, boats, the 9 real-estate sub-verticals, and the 8 commercial/RV modes) aren't part of this fan-out — select them individually via mode.

Does this cover trucks, buses, construction machinery, agriculture equipment, caravans, and motorhomes? Yes. searchTrucks, searchBuses, and searchConstructionMachinery cover commercial vehicles. searchAgricultureTractors, searchAgricultureCombines, and searchAgricultureTools cover farm equipment. searchCaravans and searchMotorhomes cover recreational vehicles — each with its own vehicle-group/category filters and year/engine-power/weight/length range filters.

Does this cover rental properties too, or just homes for sale? Both. searchRealEstate covers homes for sale; searchRealEstateRentals covers homes for rent, with its own monthly-rent pricing and furnished-status field. Nine further sub-verticals are available individually: holiday homes for sale, holiday-home plots, property abroad, new-build projects, residential plots, commercial premises for sale/rent, commercial plots, and businesses for sale as a going concern.

Does this cover motorcycles and boats too, or just cars? Yes. searchMc covers motorcycles, mopeds, ATVs, and snowmobiles; searchBoats covers boats — each with its own filter set and output fields (registration number & engine displacement for MC; motor power, length, width, and top speed for boats).

How many listings can I scrape per run? Up to 1,000 using maxItems.

Can I sort results? Yes — by relevance (default), newest/oldest first, price ascending/descending, or distance.

Can I filter by county, category, condition, fuel type, occupation, energy label, etc.? Yes — see the Input table above. Every filter that doesn't apply to the currently selected mode is simply ignored, with no error.

Are there filters that aren't available? A few facets are intentionally left out because Finn.no's underlying value sets are too large or too unstable to keep as a reliable dropdown: item sub-categories (500+ values), item/car brand (up to ~1,800 values), job sub-occupations (~214 values beneath the 84 top-level jobOccupation values), and per-vertical vehicle make on trucks/buses/construction/agriculture/caravans/motorhomes (10–212 values each). Use query for these (e.g. query: "Samsung" or query: "Scania"). Viewing dates and map/radius search are also out of scope since they're rolling/date-based or client-side-only on Finn.no; scheduled viewing times that Finn does return per listing still appear in the viewingTimes output field.

Why do vehicle year filters (e.g. carYearMax) top out at 2027? Finn.no's vehicle year filter stops working correctly once a bound goes past the site's current live ceiling — instead of narrowing results, it silently returns the unfiltered set. The input schema caps at the current live ceiling to avoid that. Finn extends the ceiling by roughly a year whenever the next model year goes on sale; for a newer model year in the meantime, use query (e.g. query: "2028 modell").

Is this affiliated with Finn.no? No, this is a third-party actor that reads Finn.no's public search results. It is not affiliated with or endorsed by Finn.no or Schibsted Media Group.