DEV Community

Cover image for How to Scrape FINN Marketplace and Cars in Python with FINN Scraper
ReventaData
ReventaData

Posted on Originally published at apify.com

How to Scrape FINN Marketplace and Cars in Python with FINN Scraper

By the end of this tutorial you will have a working Python script that pulls Norwegian second-hand marketplace listings or used cars from finn.no into structured data rows: item title, price in NOK, location, publication date, coordinates, seller classification, brand, and photo URLs.

FINN.no is Norway's primary classifieds site. FINN Scraper (reventadata/finn-scraper) is the Apify Actor built to extract listings from its two main marketplace sections: the Torget general second-hand market and the used cars market. You send it your search parameters, and it returns one clean row per listing.

In this guide we run the Actor from Python using the official Apify API client. Every sample row shown below comes from a real capture of a search for sofas on Torget, so you can see exactly what the fields look like before writing your own scripts. ⏱️ This takes about 10 minutes.


Prerequisites

You need three items to follow this tutorial:

  1. Python 3.11 or newer installed on your system.
  2. A free Apify account, which you can create using an email address or your GitHub account.
  3. Your personal Apify API token, which is located in Apify Console under Settings > API & Integrations.

Install the official Python client and set your token in your shell environment:

pip install -U "apify-client~=3.0"
export APIFY_API_TOKEN="your_apify_token_here"
Enter fullscreen mode Exit fullscreen mode

No browser automation or custom scraping infrastructure is needed on your machine. The Actor handles all fetching on the platform.


What you'll achieve

You will search finn.no for used sofa listings across Norway, retrieve the rows directly in Python, and print a clean summary for each listing showing the asking price in NOK, city or region, seller classification, and item brand.

The Actor extracts listings from public search result pages without requiring an account on the target site. It preserves the site's own categorization, geographical labels, and price amounts in structured fields rather than unstructured text.

The same script can search across any of the Actor's 16 county and region values, narrow listings by price limits, target specific seller types such as private individuals or commercial dealers, or switch to the used car market to extract vehicle specifications like model year, mileage, and fuel type.


Step 1: Open FINN Scraper

Start by visiting the FINN Scraper page on Apify Store. The Try for free button opens the Actor inside Apify Console where you can review documentation, input parameters, and sample datasets.

Because we are driving the Actor through Python code, you only need the Actor's platform name: reventadata/finn-scraper.


Step 2: Choose the search parameters

FINN Scraper supports two search verticals configured by the vertical parameter:

  • torget: The second-hand marketplace for furniture, electronics, clothing, and general goods. This is the default.
  • cars: The used cars market.

For Torget, provide one or more search terms in the searchQueries array. For used cars, searchQueries is optional; leaving it empty extracts all used cars sorted by newest publication date.

You can refine the search using optional parameters:

  • county: Select a specific Norwegian county such as "oslo" or "akershus", or leave it as "any" for nationwide searches.
  • minPrice and maxPrice: Numeric price boundaries in NOK, applied on the site before rows are returned.
  • sellers: Filter by seller kind: "private" or "company" on Torget; "private", "brand-dealer", or "independent-dealer" on used cars.
  • category: Top-level Torget categories such as "furniture-interior", "electronics", or "sports-outdoors".
  • tradeType: Torget ad types, defaulting to "sell" (Til salgs), or set to "giveaway" (Gis bort) or "wanted" (Ønskes kjøpt).
  • maxItems and maxPages: Caps on total rows and search result pages per query.

Here is a sample input object configured for a Torget search:

{
    "searchQueries": ["sofa"],
    "maxItems": 10,
    "maxPages": 1
}
Enter fullscreen mode Exit fullscreen mode

Step 3: Run it from Python

The following script initializes the Apify client, starts FINN Scraper with our search input, waits for the run to complete, and iterates over the dataset rows:

import os
from apify_client import ApifyClient

# 1. Initialise the client with your token from the environment
client = ApifyClient(os.environ["APIFY_API_TOKEN"])

# 2. Describe the search: sofa on Torget (marketplace)
run_input = {
    "searchQueries": ["sofa"],
    "maxItems": 10,
    "maxPages": 1,
}

# 3. Start the Actor and wait for it to finish
run = client.actor("reventadata/finn-scraper").call(run_input=run_input)
if run is None or run.status != "SUCCEEDED":
    status = run.status if run else "unknown"
    raise SystemExit(f"Run did not succeed (status: {status}).")

# 4. Read the rows from the run's default dataset
items = client.dataset(run.default_dataset_id).list_items().items
print(f"Retrieved {len(items)} listings.\n")

# 5. Print a one-line summary per listing
for item in items:
    title = item.get("title")
    price = item.get("price")
    currency = item.get("currency")
    location = item.get("location")
    seller_type = item.get("sellerType")
    brand = item.get("brand") or "no brand"
    print(f"{title} | {price} {currency} | {location} | {seller_type} | {brand}")
Enter fullscreen mode Exit fullscreen mode

Save this script and execute it in your terminal:

python -m scrape_script
Enter fullscreen mode Exit fullscreen mode

Step 4: Read the output

When the run finishes, the script prints the number of retrieved items followed by formatted summary lines. Here are the lines printed from the harvested sofa run's rows:

Retrieved 10 listings.

IKEA Vimle 3-seters sofa | 4000 NOK | Oslo | private | IKEA
Sofa | 1000 NOK | Egersund | private | Bohus
Bohus Sofa selges | 2800 NOK | Eidsvoll | private | no brand
Liten grå sofa selges | 500 NOK | Larvik | private | Jysk
NOGA Classic 01 Sofa – Indianskop 46 | Utstillingsmodell -40 % | 29700 NOK | Oslo | dealer | no brand
Weston sofa | 5000 NOK | Støren | private | no brand
Brun sofa x 3 | 1800 NOK | Kristiansand S | private | no brand
Sofa | 2500 NOK | Mjøndalen | private | no brand
Sofa. | 400 NOK | Sandefjord | private | no brand
Sofa | 1000 NOK | Horten | private | no brand
Enter fullscreen mode Exit fullscreen mode

Notice how the prices span from 400 NOK for a private second-hand piece up to 29,700 NOK for a commercial showroom model sold by a dealer. The brand field captures identified manufacturers like IKEA, Bohus, or Jysk when listed in the structured metadata, and falls back to null when omitted.


Step 5: Search used cars or filter Torget categories (optional)

If you want to extract used car listings instead of second-hand furniture, switch the vertical setting to "cars". The car vertical unlocks vehicle-specific filters:

  • fuel: Filter by engine type: "petrol", "diesel", "electric", "hybrid-petrol", or "plug-in-petrol".
  • minYear and maxYear: Boundary years for vehicle registration (e.g., 2018 to 2023).
  • minMileage and maxMileage: Mileage limits in kilometers.

For example, to extract electric vehicles in Oslo under 350,000 NOK:

{
    "vertical": "cars",
    "county": "oslo",
    "fuel": "electric",
    "maxPrice": 350000,
    "maxItems": 50,
    "maxPages": 2
}
Enter fullscreen mode Exit fullscreen mode

The resulting car rows include vehicle attributes such as make, model, year, mileage, fuel, transmission, and registrationClass.


Understanding your results

Each row returned by the Actor represents one listing with structured attributes: id, title, and url provide direct item access; price (in NOK) and currency capture the monetary amount; location gives the geographical area; postedAt gives the publication timestamp in ISO 8601 UTC; latitude and longitude provide coordinates; organisationName and sellerType distinguish private sellers from commercial dealers; brand identifies the maker; and shippingAvailable and buyNow denote delivery or instant checkout options.

Here is a complete row from the harvested sofa run (imageUrls shortened to 2 entries):

{
  "id": "481086056",
  "title": "IKEA Vimle 3-seters sofa",
  "url": "https://www.finn.no/recommerce/forsale/item/481086056",
  "price": 4000,
  "currency": "NOK",
  "location": "Oslo",
  "postedAt": "2026-11-15T20:31:23+00:00",
  "latitude": 59.94946,
  "longitude": 10.76511,
  "imageUrls": [
    "https://images.finncdn.no/dynamic/default/item/481086056/0ee68803-3b8a-460f-8a91-5d1aeae589fc",
    "https://images.finncdn.no/dynamic/default/item/481086056/e8885b76-05d3-4d28-8ea0-f036635602d4"
  ],
  "organisationName": null,
  "sellerType": "private",
  "shippingAvailable": false,
  "buyNow": false,
  "labels": [
    "Privat"
  ],
  "brand": "IKEA",
  "tradeType": "Til salgs",
  "matchedKeyword": "sofa",
  "vertical": "torget",
  "scrapedAt": "2026-11-15T21:03:31.714488+00:00"
}
Enter fullscreen mode Exit fullscreen mode

Pro tips and advanced usage

Here are four practical recommendations for building reliable data pipelines with FINN Scraper:

  1. Navigate the 50-page ceiling: FINN serves at most 50 result pages per query (53 ads per page on Torget, 50 on cars). If a broad keyword matches more than 2,650 items, the site caps the pagination. To collect complete catalogs, partition your search across counties (e.g., iterating through "oslo", "akershus", "vestland") or slice by price windows.
  2. Control keyword matching with requireKeywordMatch: By default, FINN's search matches query words anywhere in an ad, including unseen description text. The Actor defaults requireKeywordMatch to true, verifying that every query word appears in visible listing fields (title, brand, make, model). If you prefer raw search recall, set this to false.
  3. Automate recurring sweeps: In Apify Console under Schedules, you can trigger the Actor daily or hourly to monitor new arrivals and price drops.
  4. Integrate via Webhooks: Configure an Apify webhook on run completion to notify external services when new rows are ready to be fetched.

Troubleshooting common issues

If your runs produce unexpected results or zero rows, check these points:

  • Empty dataset (0 rows): If a run completes successfully but returns no items, verify your filters. Highly specific keywords combined with strict price ranges or small counties may match zero active ads. Also check if requireKeywordMatch dropped results that only matched in the ad body.
  • Incompatible inputs or validation errors: An incompatible input combination (such as setting car-only filters like fuel when vertical is "torget") causes the run to fail immediately with a message indicating which input to fix. Only a value outside a schema enum is refused before the run starts.
  • Run clock stops: If a run approaches its timeout, the Actor terminates politely and preserves all rows already pushed to the dataset. For large multi-page collections, increase the Actor timeout in run options.

Next steps

Now that you can run FINN Scraper from Python, you can export your datasets to CSV, Excel, or JSON for market analysis, price trend tracking, or competitive monitoring.

For current pricing and details, see the Store page.

You can explore further integration options in the official Apify API client documentation. Experiment with different vertical configurations, filter combinations, and automated schedules to build your Scandinavian market data feeds.


About the author: reventadata builds and maintains production scrapers on Apify Store.

Top comments (0)