Finn.no Marketplace, Vehicles, Property & Jobs Extractor: MCP config, n8n workflow and API

{
  "mode": "searchItems",
  "query": "iPhone",
  "sortBy": "relevance",
  "publishedToday": false,
  "itemFreeShippingOnly": false,
  "carSmoothTrade": false,
  "maxItems": 20
}

---
name: finn-no-marketplace-vehicles-property-and-jobs
description: "Finn.no listing records spanning items, vehicles, real estate, and jobs with price, location, and category-specific specs. Runs the Apify Actor dataspryva/finn-no-marketplace-vehicles-property-and-jobs. Use when the user needs Willhaben data with fields such as adId, heading, vertical, price, location, adUrl and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "dataspryva/finn-no-marketplace-vehicles-property-and-jobs"
  store-url: "https://apify.com/dataspryva/finn-no-marketplace-vehicles-property-and-jobs"
---

# Finn.no Marketplace, Vehicles, Property & Jobs Extractor

Use this skill to fetch Willhaben data with the Apify Actor `dataspryva/finn-no-marketplace-vehicles-property-and-jobs` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | string, required | What to search on Finn.no. |
| `query` | string | Keyword to search for (e.g. 'iPhone', 'sofa', 'BMW'). Leave empty to browse all listings in the selected category/mode. |
| `sortBy` | one of `relevance`, `newest`, `oldest`, `priceAsc`, `priceDesc`, `closest` | Order in which listings are returned. |
| `location` | string | Restrict results to a Norwegian county. Applies to every mode (including each vertical inside 'Search all categories'). |
| `publishedToday` | boolean | Only return listings published today (Nye i dag). Applies to every mode. |
| `category` | string | Torget top-level category. Only applies when mode is 'Search items for sale' (or the items leg of 'Search all categories'). |
| `itemCondition` | one of `Helt ny - Uåpnet/med lapp`, `Som ny - Ikke synlig brukt`, `Pent brukt - I god stand`, `Godt brukt - Synlig brukt`, `Må fikses - Noen mangler/ødelagte deler` | Filter by the item's physical condition (tilstand). Only applies when mode is 'Search items for sale' (or the items leg of 'Search all categories'). |
| `tradeType` | one of `Til salgs`, `Gis bort`, `Ønskes kjøpt` | Filter by Finn's ad/trade type. Only applies when mode is 'Search items for sale'. Unlike itemCondition, this value IS reliably reflected back on the matching output records' `condition` field. |
| `forRent` | one of `Kjøp`, `Leie` | Filter items listed for purchase vs. for rent. Only applies when mode is 'Search items for sale'. |
| `sellerType` | one of `Privat`, `Forhandler` | Filter by private seller vs. dealer/retailer. Only applies when mode is 'Search items for sale'. Note: Finn.no doesn't return a raw seller-type field on item listings, so this narrows results but isn't itself echoed back on item output records. |
| `itemFreeShippingOnly` | boolean | Only return item listings offering free shipping (Gratis frakt). Only applies when mode is 'Search items for sale'. |
| `carFuel` | string | Vehicle fuel type. Only applies when mode is 'Search cars & vehicles'. |
| `carBodyType` | string | Vehicle body/karosseri type. Only applies when mode is 'Search cars & vehicles'. |
| `carTransmission` | one of `Automat`, `Manuell` | Gearbox type. Only applies when mode is 'Search cars & vehicles'. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "searchItems",
  "query": "iPhone",
  "sortBy": "relevance",
  "publishedToday": false,
  "itemFreeShippingOnly": false,
  "carSmoothTrade": false,
  "maxItems": 20
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/dataspryva~finn-no-marketplace-vehicles-property-and-jobs/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/dataspryva~finn-no-marketplace-vehicles-property-and-jobs/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `adId`, `heading`, `vertical`, `price`, `location`, `adUrl`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.