# FINN.no Scraper: Norway Marketplace Listings (`reventadata/finn-scraper`) Actor

Scrape FINN.no, Norway's marketplace: Torget second-hand ads by search term, plus used cars. Title, price in NOK, location with coordinates, posting time, private or dealer seller, photos, and car make, model, year, mileage and fuel. Unofficial.

- **URL**: https://apify.com/reventadata/finn-scraper.md
- **Developed by:** [reventadata](https://apify.com/reventadata) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## FINN Scraper: Torget and Used Cars

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to FINN.no. "FINN" is a trademark of its
> respective owner and is used here only to describe what this tool reads. It reads the same
> public data a browser does.

FINN Scraper extracts structured listings from FINN.no, Norway's largest classifieds site: the **Torget** second-hand marketplace and the **used cars** market. Pick one with the `vertical` input.

### What does it do?

- **Torget** (`vertical: torget`): searches by keyword and returns title, price in NOK, place, coordinates, seller type, shop name, brand, shipping and buy-now flags, labels and images.
- **Used cars** (`vertical: cars`): lists used cars, optionally by keyword, with make, model, trim, year, mileage, fuel, gearbox, registration class, number plate, chassis number, sales form (used, new, leasing, auction), dealer name and images.

Real estate and jobs on FINN are not supported.

### Why use it?

- **Structured dataset columns:** price, year, mileage and fuel are separate fields, not text to parse.
- **Server-side filters:** price range, county, seller kind, Torget category, car fuel, model year and mileage are applied by FINN itself, so you pay for rows you asked for.
- **Public data only:** business and dealer names and the fields FINN shows in its search results are in the rows. Private sellers are anonymous on FINN, so rows carry no private seller name, and nothing comes from behind a login.

### How to use it

1. Choose `vertical`: `torget` or `cars`.
2. Add search terms in `searchQueries`. Torget needs at least one; used cars can run without (every used car, newest first).
3. Optionally narrow with price, county, seller kind and the vertical's own filters.
4. Run the Actor and download results as JSON, CSV, Excel, or NDJSON from the dataset.

FINN serves at most 50 result pages per search (53 Torget ads or 50 cars a page). To go past that ceiling, split the search with county, price range or seller kind.

#### Input

| Field | Type | Description |
|---|---|---|
| `vertical` | string | `torget` (marketplace) or `cars` (used cars). Default `torget`. |
| `searchQueries` | array | Search terms. Required for Torget, optional for cars. |
| `minPrice`, `maxPrice` | integer | Price bounds in NOK, applied by the site. |
| `county` | string | One of the 16 Norwegian counties, or any. |
| `sellers` | string | `any`, `private`, `company` (Torget), `brand-dealer` or `independent-dealer` (cars). A kind from the other vertical is rejected. |
| `category` | string | Torget only: top-level category. |
| `tradeType` | string | Torget only: for sale (default), given away, wanted, all. |
| `shippingOnly` | boolean | Torget only: keep ads that offer shipping. |
| `fuel`, `minYear`, `maxYear`, `minMileage`, `maxMileage` | string / integer | Cars only. Mileage in km. |
| `requireKeywordMatch` | boolean | Default on: drop ads where a word of your term is not in the visible text (FINN also matches the ad description, which the result list does not show). |
| `maxItems`, `maxPages` | integer | Row cap and pages per term (at most 50). |
| `proxyConfiguration` | object | Optional. Off by default. |

#### Sample Input

```json
{
    "vertical": "torget",
    "searchQueries": ["sofa"],
    "county": "oslo",
    "maxPrice": 5000,
    "maxItems": 100
}
```

#### Output

Every row has `id`, `title`, `url`, `price` (NOK), `currency`, `location`, `postedAt`, `latitude`, `longitude`, `imageUrls`, `organisationName`, `sellerType`, `matchedKeyword`, `vertical` and `scrapedAt`.

Torget rows add `shippingAvailable`, `buyNow`, `labels`, `brand`, `tradeType`.

Car rows add `organisationId` (dealers only), `make`, `series`, `model`, `modelSpecification`, `year`, `mileage`, `mileageUnit`, `fuel`, `transmission`, `registrationClass`, `registrationNumber`, `chassisNumber`, `salesForm`, `serviceDocuments`, `warrantyDuration`, `drivingRange`. `warrantyDuration` and `drivingRange` are whole numbers passed through as FINN gives them (the unit is not documented), or `null`. On a leasing ad the price may be an instalment rather than a purchase price (not verified).

#### Sample Output (a Torget row from a real platform run, 2026-11-11; `imageUrls` shortened to 2 items)

```json
{
  "id": "480727380",
  "title": "Sofa",
  "url": "https://www.finn.no/recommerce/forsale/item/480727380",
  "price": 400,
  "currency": "NOK",
  "location": "Sandefjord",
  "postedAt": "2026-11-10T22:47:51+00:00",
  "latitude": 59.1307,
  "longitude": 10.2269,
  "imageUrls": [
    "https://images.finncdn.no/dynamic/default/item/480727380/5dba700b-6232-4af1-bdcd-a24763d25e23",
    "https://images.finncdn.no/dynamic/default/item/480727380/1d63d693-c977-47e8-8056-099aec54945a"
  ],
  "organisationName": null,
  "sellerType": "private",
  "shippingAvailable": false,
  "buyNow": false,
  "labels": [
    "Privat"
  ],
  "brand": "IKEA",
  "tradeType": "Til salgs",
  "matchedKeyword": "sofa",
  "vertical": "torget",
  "scrapedAt": "2026-11-11T06:43:12.733802+00:00"
}
```

#### Sample Output (a car row from a real local run, 2026-11-08)

```json
{
    "id": "451243150",
    "title": "Mercedes-Benz C-Klasse",
    "url": "https://www.finn.no/mobility/item/451243150",
    "price": 101942,
    "currency": "NOK",
    "location": "Elverum",
    "postedAt": "2026-11-08T00:00:56+00:00",
    "sellerType": "private",
    "organisationId": null,
    "make": "Mercedes-Benz",
    "model": "C-Klasse",
    "modelSpecification": "Avantgarde aut",
    "year": 2012,
    "mileage": 144000,
    "mileageUnit": "KILOMETER",
    "fuel": "Diesel",
    "transmission": "Automat",
    "registrationClass": "Personbil",
    "salesForm": "used",
    "matchedKeyword": null,
    "vertical": "cars"
}
```

(The car sample omits coordinates, images, number plate, chassis number and a few null fields for length; the real row has them.)

### Pricing

The current price is on the Actor's Pricing tab.

### Privacy & Compliance

This Actor reads only publicly accessible search results and returns the public data they show. It sends no login. FINN's terms ask for written permission for automated, systematic copying; you are responsible for how you use the data and for complying with the site's terms and applicable law, including data-protection law for any personal data in the rows (for example a number plate).

# Actor input Schema

## `vertical` (type: `string`):

'Torget' is FINN's second-hand marketplace (finn.no/recommerce). 'Used cars' is the car market (finn.no/mobility). Real estate and jobs are not supported.

## `searchQueries` (type: `array`):

One search per term. Required for Torget; optional for used cars (leave empty to list used cars of any make, newest first). Several words in one term must all appear in the ad's visible text when 'Require the query in the title' is on.

## `minPrice` (type: `integer`):

Optional, inclusive, in Norwegian kroner. Applied by the site itself. Must not be above the maximum price.

## `maxPrice` (type: `integer`):

Optional, inclusive, in Norwegian kroner. Applied by the site itself.

## `county` (type: `string`):

Optional Norwegian county (fylke). Any county searches the whole country.

## `sellers` (type: `string`):

Private sellers only, or a kind of business. Torget knows 'private' and 'company'; used cars know 'private', 'brand-dealer' and 'independent-dealer'. A kind from the other vertical is rejected.

## `category` (type: `string`):

Optional top-level Torget category. Rejected when 'What to search' is 'Used cars'.

## `tradeType` (type: `string`):

Torget mixes ads for sale with give-away ads and wanted ads. For sale is almost always what you want. 'Used cars' accepts only 'For sale'.

## `shippingOnly` (type: `boolean`):

Keeps only Torget ads that offer shipping. Applied after fetching, so a run with this on fetches more pages per row kept. Rejected for 'Used cars'.

## `fuel` (type: `string`):

Optional fuel type. Rejected when 'What to search' is 'Torget'.

## `minYear` (type: `integer`):

Optional, inclusive. Rejected for Torget.

## `maxYear` (type: `integer`):

Optional, inclusive. Rejected for Torget.

## `minMileage` (type: `integer`):

Optional, inclusive. Rejected for Torget.

## `maxMileage` (type: `integer`):

Optional, inclusive. Rejected for Torget.

## `requireKeywordMatch` (type: `boolean`):

Drops ads where a word of the search term is missing from the title, brand, make, model, fuel and gearbox. The site also matches the ad description, which the result list does not show, so a search can return ads that only mention the word there. Turn off to keep everything the site returns.

## `maxItems` (type: `integer`):

Hard cap on rows saved across all search terms.

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

53 ads a page on Torget, 50 on used cars. The site serves at most 50 pages per search (2,650 Torget ads, 2,500 cars), so this is clamped to 50. Narrow the search with county, seller, price or category to go beyond that.

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

Optional. Left off by default; only turn it on if you see request failures.

## Actor input object example

```json
{
  "vertical": "torget",
  "searchQueries": [
    "sofa"
  ],
  "county": "any",
  "sellers": "any",
  "category": "any",
  "tradeType": "sell",
  "shippingOnly": false,
  "fuel": "any",
  "requireKeywordMatch": true,
  "maxItems": 10,
  "maxPages": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Items scraped from the target website.

# 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 = {
    "searchQueries": [
        "sofa"
    ],
    "maxItems": 10,
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/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 = {
    "searchQueries": ["sofa"],
    "maxItems": 10,
    "maxPages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("reventadata/finn-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "sofa"
  ],
  "maxItems": 10,
  "maxPages": 1
}' |
apify call reventadata/finn-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reventadata/finn-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/A7fqcQbbq7gbOD3X6/builds/3QHLIBMmR0CR2a7Ob/openapi.json
