# Finn.no Mobility Scraper 💰 $2/1K — Cars, MC, Boats & More (`blackfalcondata/finn-mobility-scraper`) Actor Scrape finn.no/mobility — Norway's largest vehicle marketplace with 100,000+ listings across 6 categories. Full spec sheets, dealer details, and incremental change tracking for precise targeting. - **URL**: https://apify.com/blackfalcondata/finn-mobility-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 8 total users, 1 monthly users, 94.3% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does Finn.no Mobility Scraper do? Finn.no Mobility Scraper extracts structured listing data from [finn.no](https://finn.no) — including full descriptions. It supports keyword search, location filters, and controllable result limits, so you can run the same query consistently over time. The actor also offers detail enrichment (full descriptions) where the source provides them. ### How to use this actor - 👉 **Register for a free Apify account** — no credit card required. - 🎉 Just click **[Sign up free on Apify →](https://console.apify.com/sign-up?fpr=1h3gvi&fp_sid=ctarich)** and complete a quick signup. - 💰 A free Apify account includes $5 in monthly credits — enough to test this actor. - ⏳ Scrape during the free trial, with no commitment or upfront payment required. ### Key features - **♻️ Incremental mode** — daily runs emit only listings that are new or whose price/condition changed since last run. Perfect for inventory-diff dashboards and competitive pricing alerts. Saves 80–95% on recurring monitoring. - **🔔 Notifications** — telegram / Slack / Discord / WhatsApp / webhook alerts on each run. Combine with incremental to ping only when prices or inventory actually move. - **📋 Detail enrichment** — two-stage scraping — list first, then enrich each listing with the full detail-page payload. One input toggle controls the depth. - **📧 Email + phone extraction** — best-effort regex extraction of contact emails and phone numbers from descriptions — emitted as `extractedEmails[]` and `extractedPhones[]` on every record. - **🔗 URL + social-profile extraction** — every record carries `extractedUrls[]` plus a structured `socialProfiles { linkedin, twitter, instagram, facebook, youtube, tiktok, github, xing }` parsed from the description. - **💵 Structured pricing** — listing price parsed into a numeric `price` field plus filter inputs (`priceFrom` / `priceTo`) so you can target a budget band. Use `priceType` (where supported) to exclude leasing or wholesale listings. - **📦 Compact mode** — light payload with core fields only — comparable rows across listings without HTML or metadata overhead. Perfect for pricing dashboards. - **✂️ Description truncation** — cap description length with `descriptionMaxLength` to control LLM prompt cost and dataset size — set 0 for full descriptions, or any char-limit to trim. - **📤 Export anywhere** — Download the dataset as JSON, CSV, or Excel from the Apify Console, or stream live via the Apify API and integrations (Make, Zapier, Google Sheets, n8n, …). - **🔌 MCP connectors** — export your results into Notion via Apify's MCP connectors — a clean run-summary page, no glue code. Opt-in via the App connector field; deterministic field-mapping, no AI. Built on Apify's connector framework, so more destinations open up as their catalog grows. ### What data can you extract from finn.no? Each result includes core listing fields (`listingId`, `adId`, `title`, `make`, `model`, `series`, `modelSpec`, `year`, `price`, `mileage`, `fuel`, `transmission`, and more) plus detail-enriched fields when enabled: full `description`, typed spec projections (`bodyType`, `power`, `engineSize`, `co2`, `weight`, `seats`, `doors`, `maxTowingWeight`, `euInspectionDue`, `previousOwners`, …), and per-category fields for boats, MCs, mobilehomes, and B2B equipment. New since v0.3.0: `vehicleSpecs` raw label-to-value map of the full spec table (future-proof against Schibsted label renames), `sellerKnowledge` Q&A pairs from "Selgers kjennskap til bilen" (private listings), `inspectionReportUrl` (vegvesen.no EU-kontroll lookup), `updatedAt` ("Sist oppdatert" stamp), and dealer infokort fields (`streetAddress`, `dealerOrgNr`, `dealerPageUrl`, `dealerYearsOnFinn`, `dealerTotalAds`). By default (since v0.3.0), null and empty values are dropped from each row to keep output compact for LLM pipelines. Set `omitNulls: false` if you need a stable schema where every row has every documented field. Enable `compact: true` for an even smaller payload with only core fields. ### Input The main inputs are a search keyword, an optional location filter, and a result limit. Additional filters and options are available in the input schema. Key parameters: - **`category`** — Vehicle category to scrape. (default: `"car"`) - **`query`** — Free-text search keywords (e.g. "Toyota HiLux"). Leave empty to browse all listings. - **`make`** — Filter by vehicle make. Brand name (e.g. "Toyota", "BMW") or raw Schibsted variant ID (e.g. "0.749" for BMW). Unknown brands are silently dropped. (default: `""`) - **`location`** — City or region (e.g. "Oslo", "Bergen"). - **`yearFrom`** — Earliest model year to include. Listings with a model year older than this are excluded. Combine with `yearTo` to bound the range. Leave blank to include all years. - **`yearTo`** — Latest model year to include. Listings with a model year newer than this are excluded. Combine with `yearFrom` to bound the range. Leave blank to include all years. - **`priceFrom`** — Minimum asking price in NOK. - **`priceTo`** — Maximum asking price in NOK. - **`mileageFrom`** — Minimum mileage in kilometres. (default: `0`) - **`mileageTo`** — Maximum mileage in kilometres. (default: `0`) - **`fuel`** — Filter by fuel type. Norwegian label or numeric ID both work. (default: `""`) - **`transmission`** — Filter by transmission type. Norwegian label or numeric ID both work. (default: `""`) - ...and 24 more parameters ### Input examples **Tesla Model Y — Norway's best-selling used car** — The Model Y is the most-sold used car in Norway. Narrow with `make: "Tesla"` and a free-text `query` (model names aren't in the SERP filter set — finn.no handles them as a search term). → Used Model Y listings with `drivingRange` (km of battery range), `vehicleSpecs` table, `sellerKnowledge` Q&A, dealer infokort (`dealerOrgNr`, `streetAddress`, `dealerYearsOnFinn`), and `inspectionReportUrl` (vegvesen.no EU-kontroll). ```json { "category": "car", "make": "Tesla", "query": "Model Y", "yearFrom": 2022, "priceTo": 500000, "maxResults": 200 } ```` **EV market scan — full electric inventory** — Pull the full EV market in one run for resale analysis, price-trend tracking, or charger-rollout planning. → EV records with `drivingRange`, `fuel: "El"`, `bodyType`, `power`, dealer/private flag, and the full Schibsted spec table — usable for market sizing across all makes. ```json { "category": "car", "fuel": "El", "yearFrom": 2022, "priceTo": 600000, "maxResults": 1000 } ``` **Tesla price-drop alerts (incremental + Discord)** — Daily incremental run that only emits new or price-changed Model Y listings, then pushes them to your Discord channel. First run builds the baseline; subsequent runs cost ~nothing on quiet days. → Only new or changed Model Y dealer listings since the previous run with this `stateKey`. Each delta is posted as a Discord message with title, price change, mileage, location, and the finn.no URL. ```json { "category": "car", "make": "Tesla", "query": "Model Y", "dealerSegment": "Forhandler", "incrementalMode": true, "stateKey": "tesla-y-dealer-tracker", "discordWebhookUrl": "https://discord.com/api/webhooks/your-webhook-here", "notifyOnlyChanges": true, "maxResults": 500 } ``` **Family car hunt — automatic diesel, low mileage** — Practical first-family-car filter: at most 100 000 km, automatic transmission, post-2018 emissions class, capped at 250k NOK. → Diesel automatics with full spec sheets — `co2`, `maxTowingWeight`, `seats`, `doors`, `previousOwners`, and (private listings) sellerKnowledge Q\&A on rust, service history, accidents. ```json { "category": "car", "fuel": "Diesel", "transmission": "Automat", "yearFrom": 2018, "mileageTo": 100000, "priceTo": 250000, "maxResults": 200 } ``` **Porsche dealer inventory** — Premium-segment scan — dealer-only Porsches for collector-market or arbitrage research. Returns dealer infokort fields so you can rank by years on FINN and inventory size. → Porsche listings with `dealerOrgNr` (Brønnøysundregistrene lookup), `dealerYearsOnFinn`, `dealerTotalAds`, `streetAddress`, and `dealerPageUrl` — useful for sourcing or competitive intel. ```json { "category": "car", "make": "Porsche", "dealerSegment": "Forhandler", "yearFrom": 2015, "maxResults": 100 } ``` **Sailboats for the Oslofjord season** — Boat category with a free-text query — finn.no's boat SERP returns hull, motor, and dimensional fields. → Boat listings with `boatLength`, `boatWidth`, `boatClass`, `hullMaterial`, `maxSpeed`, `motorIncluded`, and `motorManufacturer` populated. ```json { "category": "boat", "query": "seilbåt", "priceTo": 500000, "maxResults": 100 } ``` **Compact for AI agents** — Token-light Tesla Model Y feed for LLM pipelines and MCP tools — only the 10 core fields, no spec tables. → Trimmed records: `listingId`, `make`, `model`, `year`, `price`, `mileage`, `fuel`, `transmission`, `location`, `url`. ```json { "category": "car", "make": "Tesla", "query": "Model Y", "compact": true, "maxResults": 50 } ``` ### Output Each run produces a dataset of structured listing records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console. ### Example listing record ```json { "listingId": "89bb4fee6696e3fc4de558c278ad222d29fb17f4c5a935797d27a8644abcb3ec", "adId": "460742367", "title": "Tesla Model Y", "make": "Tesla", "model": "Model Y", "modelSpec": "Performance AWD", "year": 2022, "price": 384532, "currency": "NOK", "mileage": 73000, "mileageUnit": "KILOMETER", "fuel": "El", "transmission": "Automat", "registrationClass": "Personbil", "sellerType": "Privat", "salesForm": "1", "registrationNumber": "EE62447", "imageUrl": "https://images.finncdn.no/dynamic/default/item/460742367/2dd49ebd-2559-40fb-ae91-61837b63262f", "lat": 59.20767, "lon": 10.94617, "location": "Fredrikstad", "drivingRange": 514, "description": "Tesla Model Y Performance AWD til salgsSelger en svært pen og godt utstyrt Tesla Model Y Performance – dette er ikke standardutgaven, men Performance-varianten med merkbart mer kraft og kjøreglede. Bi...", "descriptionMarkdown": "Tesla Model Y Performance AWD til salgsSelger en svært pen og godt utstyrt Tesla Model Y Performance – dette er ikke standardutgaven, men Performance-varianten med merkbart mer kraft og kjøreglede. Bi...", "contentHash": "61777c1fa8e725ef340db57b0f2adb6860e2510002ba57dc25a876335b29cf96", "bodyType": "SUV/Offroad", "power": "534 hk", "driveType": "Firehjulsdrift", "color": "Svart", "seats": 5, "doors": 5, "weight": "1 997 kg", "maxTowingWeight": "1 600 kg", "euInspectionDue": "13.07.2026", "previousOwners": 3, "firstRegistered": "13.07.2022", "detailImages": [ "https://images.finncdn.no/dynamic/default/item/460742367/2dd49ebd-2559-40fb-ae91-61837b63262f", "https://images.finncdn.no/dynamic/default/item/460742367/f004ded3-0b97-4c5e-b5ee-884234a56ee8", "https://images.finncdn.no/dynamic/default/item/460742367/9044d719-e07e-4656-8640-7f951ab1b65e" ], "vehicleSpecs": { "Omregistrering": "4 532 kr (avgifter)", "Årsavgift": "Les mer", "Merke": "Tesla", "Modell": "Model Y", "Modellår": "2022", "Karosseri": "SUV/Offroad", "Drivstoff": "El", "Effekt": "534 hk", "Kilometerstand": "73 000 km", "Batterikapasitet": "76 kWh", "Rekkevidde (WLTP)WLTP er et måltall fra bilen var ny og reell rekkevidde må sees i sammenheng med alder, km, kjøremønster og værforhold": "514 km", "Girkasse": "Automat", "Maksimal tilhengervekt": "1 600 kg", "Hjuldrift": "Firehjulsdrift", "Vekt": "1 997 kg", "Seter": "5", "Dører": "5", "Farge": "Svart", "Bilen står i": "Norge", "Neste frist for EU-kontroll": "13.07.2026", "Avgiftsklasse": "Personbil", "Registreringsnummer": "EE62447", "Eiere": "3", "Salgsform": "Bruktbil til salgs", "Pris eksl. omreg.": "380 000 kr", "Chassis nr. (VIN)": "XP7YGCEL5NB009433", "1. gang registrert": "13.07.2022" }, "sellerKnowledge": { "Har bilen heftelser/gjeld?": "Ja." }, "inspectionReportUrl": "https://www.vegvesen.no/kjoretoy/kjop-og-salg/kjoretoyopplysninger/sjekk-kjoretoyopplysninger?registreringsnummer=EE62447", "updatedAt": "2026-05-12T22:24", "url": "https://www.finn.no/mobility/item/460742367", "portalUrl": "https://www.finn.no/mobility/item/460742367", "publishedAt": "2026-05-12T20:28:33Z", "scrapedAt": "2026-05-12T20:48:58.428Z", "source": "finn.no", "isRepost": false } ``` ### Incremental fields When incremental mode is on, each record also carries: - `changeType` — one of `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`, `EXPIRED`. - `isRepost`, `repostOfId`, `repostDetectedAt` — populated when a new listing matches the tracked content of a previously expired one. Set `skipReposts: true` to drop detected reposts from the output. ### How to scrape finn.no 1. Go to [Finn.no Mobility Scraper](https://apify.com/blackfalcondata/finn-mobility-scraper?fpr=1h3gvi) in Apify Console. 2. Enter a search keyword and optional location filter. 3. Set `maxResults` to control how many results you need. 4. Enable `fetchDetails` if you need full descriptions. 5. Click **Start** and wait for the run to finish. 6. Export the dataset as JSON, CSV, or Excel. ### Use cases - Extract listing data from finn.no for market research and competitive analysis. - Track pricing trends across regions and categories over time. - Monitor new and changed listings on scheduled runs without processing the full dataset every time. - Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode. - Export clean, structured data to dashboards, spreadsheets, or data warehouses. ### How much does it cost to scrape finn.no? Finn.no Mobility Scraper uses [pay-per-event](https://docs.apify.com/platform/actors/paid-actors/pay-per-event) pricing. You pay a small fee when the run starts and then for each result that is actually produced. - **Run start:** $0.005 per run - **Per result:** $0.002 per listing record Example costs: - 10 results: **$0.025** - 25 results: **$0.055** - 100 results: **$0.21** - 200 results: **$0.41** - 500 results: **$1** #### Example: recurring monitoring savings These examples compare full re-scrapes with incremental runs at different churn rates. Churn is the share of listings that are new or whose tracked content changed since the previous run. Actual churn depends on your query breadth, source activity, and polling frequency — the scenarios below are examples, not predictions. Example setup: 200 results per run, daily polling (30 runs/month). Event-pricing examples scale linearly with result count. | Churn rate | Full re-scrape run cost | Incremental run cost | Savings vs full re-scrape | Monthly cost after baseline | |---|---:|---:|---:|---:| | 5% — stable niche query | $0.41 | $0.03 | $0.38 (94%) | $0.75 | | 15% — moderate broad query | $0.41 | $0.07 | $0.34 (84%) | $1.95 | | 30% — high-volume aggregator | $0.41 | $0.13 | $0.28 (69%) | $3.75 | Full re-scrape monthly cost at daily polling: $12.15. First month with incremental costs $1.13 / $2.29 / $4.03 for the 5% / 15% / 30% scenarios because the first run builds baseline state at full cost before incremental savings apply. ### FAQ #### How many results can I get from finn.no? The number of results depends on the search query and available listings on finn.no. Use the `maxResults` parameter to control how many results are returned per run. #### Does Finn.no Mobility Scraper support recurring monitoring? Yes. Enable incremental mode to only receive new or changed listings on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset. #### Can I integrate Finn.no Mobility Scraper with other apps? Yes. Finn.no Mobility Scraper works with Apify's [integrations](https://apify.com/integrations?fpr=1h3gvi) to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes. #### Can I use Finn.no Mobility Scraper with the Apify API? Yes. You can start runs, manage inputs, and retrieve results programmatically through the [Apify API](https://docs.apify.com/api/v2). Client libraries are available for JavaScript, Python, and other languages. #### Can I use Finn.no Mobility Scraper through an MCP Server? Yes. Apify provides an [MCP Server](https://apify.com/apify/actors-mcp-server?fpr=1h3gvi) that lets AI assistants and agents call this actor directly. Use compact mode, `descriptionMaxLength`, a single `descriptionFormat`, and `excludeEmptyFields` to keep payloads manageable for LLM context windows. #### Is it legal to scrape finn.no? This actor extracts publicly available data from finn.no. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant. #### Your feedback If you have questions, need a feature, or found a bug, please [open an issue](https://apify.com/blackfalcondata/finn-mobility-scraper/issues?fpr=1h3gvi) on the actor's page in Apify Console. Your feedback helps us improve. ### You might also like - [AutoScout24 Scraper — European Car Listings with Dealer Data](https://apify.com/blackfalcondata/autoscout24-scraper?fpr=1h3gvi) — Scrape autoscout24.com — Europe's largest used-car marketplace with 770K+ listings across 8. - [Bilbasen Scraper - Denmark’s Car Marketplace](https://apify.com/blackfalcondata/bilbasen-scraper?fpr=1h3gvi) — Scrape bilbasen.dk, Denmark’s largest car marketplace, with full vehicle specs, seller contacts,. - [DBA Scraper - Denmark’s Largest Marketplace](https://apify.com/blackfalcondata/dba-listings-scraper?fpr=1h3gvi) — Scrape dba.dk — Denmark's largest classifieds platform. Covers both marketplace and vehicle. - [mobile.de Car Scraper - Germany’s Largest Car Marketplace](https://apify.com/blackfalcondata/mobile-de-scraper?fpr=1h3gvi) — Scrape mobile.de — Germany's largest car marketplace (1.4M+ listings). Every result carries full. ### Getting started with Apify New to Apify? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=1h3gvi\&fp_sid=ctarich) — no credit card required. 1. Sign up — $5 platform credit included 2. Open this actor and configure your input 3. Click **Start** — export results as JSON, CSV, or Excel Need more later? [See Apify pricing](https://apify.com/pricing?fpr=1h3gvi). # Actor input Schema ## `category` (type: `string`): Vehicle category to scrape. ## `query` (type: `string`): Free-text search keywords (e.g. "Toyota HiLux"). Leave empty to browse all listings. ## `make` (type: `string`): Filter by vehicle make. Brand name (e.g. "Toyota", "BMW") or raw Schibsted variant ID (e.g. "0.749" for BMW). Unknown brands are silently dropped. ## `location` (type: `string`): City or region (e.g. "Oslo", "Bergen"). ## `yearFrom` (type: `integer`): Earliest model year to include. Listings with a model year older than this are excluded. Combine with `yearTo` to bound the range. Leave blank to include all years. ## `yearTo` (type: `integer`): Latest model year to include. Listings with a model year newer than this are excluded. Combine with `yearFrom` to bound the range. Leave blank to include all years. ## `priceFrom` (type: `integer`): Minimum asking price in NOK. ## `priceTo` (type: `integer`): Maximum asking price in NOK. ## `mileageFrom` (type: `integer`): Minimum mileage in kilometres. ## `mileageTo` (type: `integer`): Maximum mileage in kilometres. ## `fuel` (type: `string`): Filter by fuel type. Norwegian label or numeric ID both work. ## `transmission` (type: `string`): Filter by transmission type. Norwegian label or numeric ID both work. ## `dealerSegment` (type: `string`): Filter by seller type. ## `maxResults` (type: `integer`): Maximum number of listings to return (0 = unlimited). Memory scales with this: ≤1000 results uses 256 MB, >1000 uses 512 MB. ## `fetchDetails` (type: `boolean`): Fetch individual listing pages for full specs (vehicleSpecs), sellerKnowledge Q\&A, dealer infokort (orgNr, streetAddress, dealer page), inspection report URL, and updatedAt. Adds one HTTP request per listing. ## `descriptionMaxLength` (type: `integer`): Truncate description text to N characters. 0 = no truncation. Only relevant when fetchDetails is true. ## `compact` (type: `boolean`): Return core fields only (listingId, make, model, year, price, mileage, fuel, transmission, location, url). Ideal for AI-agent and MCP workflows. ## `omitNulls` (type: `boolean`): Drop fields with null, empty string, empty array, or empty object values from each output row. Reduces dataset size and removes noise for LLM pipelines. Keeps `false` and `0` as valid values. Default **on** — flip off if you need a stable schema where every row has every documented field. ## `incrementalMode` (type: `boolean`): Only emit new or changed listings compared to the previous run. Requires stateKey. ## `stateKey` (type: `string`): Optional stable identifier for the tracked search universe. Leave empty to auto-derive a stable identifier from your search inputs — different keyword/location/filter combinations get isolated state automatically. ## `skipReposts` (type: `boolean`): In incremental mode, skip listings that appear to be reposts of previously-seen expired listings (same content hash). ## `telegramToken` (type: `string`): Telegram bot token from @BotFather. Required for Telegram notifications. ## `telegramChatId` (type: `string`): Telegram chat or channel ID where alerts are sent (e.g. "-100123456789" for a private group, or "@yourchannel"). ## `discordWebhookUrl` (type: `string`): Discord incoming webhook URL. Get one from Server Settings → Integrations → Webhooks. ## `slackWebhookUrl` (type: `string`): Slack incoming webhook URL. Create at api.slack.com/messaging/webhooks. ## `whatsappPhoneNumberId` (type: `string`): WhatsApp Business phone number ID from Meta Business Manager (NOT the phone number itself — the numeric ID shown next to your business number). Free service-conversation messages within 24 hours of last user-initiated contact. ## `whatsappAccessToken` (type: `string`): Meta Cloud API access token with `whatsapp_business_messaging` scope. Get a permanent token from a system user in Meta Business Manager. ## `whatsappTo` (type: `string`): Recipient phone in E.164 format (e.g. +4791234567). Recipient must have messaged your business number within the last 24 hours — outside that window, free-form text is rejected by Meta. ## `webhookUrl` (type: `string`): Generic webhook URL that receives a JSON POST with the full listing payload + run metadata. Universal escape hatch for n8n / Make / Zapier / your own backend. ## `webhookHeaders` (type: `object`): Optional headers (e.g. {"Authorization": "Bearer xyz"}) sent with the webhook POST. ## `notificationLimit` (type: `integer`): Maximum number of listings included in each notification message (1–20). Excess listings are still in the dataset; notifications get a summary line. ## `notifyOnlyChanges` (type: `boolean`): When Incremental Mode is on, only send notifications for NEW / UPDATED / REAPPEARED listings. Has no effect outside incremental mode. ## `descriptionFormat` (type: `string`): Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others. ## `excludeEmptyFields` (type: `boolean`): Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards. ## `appConnector` (type: `string`): Optional. Pick a connected app under Settings → API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog. ## `mcpIssueTeam` (type: `string`): Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one. ## Actor input object example ```json { "category": "car", "make": "", "mileageFrom": 0, "mileageTo": 0, "fuel": "", "transmission": "", "dealerSegment": "", "maxResults": 20, "fetchDetails": true, "descriptionMaxLength": 0, "compact": false, "omitNulls": true, "incrementalMode": false, "skipReposts": false, "notificationLimit": 5, "notifyOnlyChanges": false, "descriptionFormat": "all", "excludeEmptyFields": false } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxResults": 20, "fetchDetails": false, "descriptionFormat": "all", "excludeEmptyFields": false }; // Run the Actor and wait for it to finish const run = await client.actor("blackfalcondata/finn-mobility-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxResults": 20, "fetchDetails": False, "descriptionFormat": "all", "excludeEmptyFields": False, } # Run the Actor and wait for it to finish run = client.actor("blackfalcondata/finn-mobility-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxResults": 20, "fetchDetails": false, "descriptionFormat": "all", "excludeEmptyFields": false }' | apify call blackfalcondata/finn-mobility-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=blackfalcondata/finn-mobility-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Finn.no Mobility Scraper 💰 $2/1K — Cars, MC, Boats & More", "description": "Scrape finn.no/mobility — Norway's largest vehicle marketplace with 100,000+ listings across 6 categories. Full spec sheets, dealer details, and incremental change tracking for precise targeting.", "version": "0.3", "x-build-id": "hgPEdUXylKOmZsbzz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~finn-mobility-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-finn-mobility-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/blackfalcondata~finn-mobility-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-finn-mobility-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/blackfalcondata~finn-mobility-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-finn-mobility-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "category": { "title": "📁 Category", "enum": [ "car", "mc", "boat", "b2b", "caravan", "mobilehome" ], "type": "string", "description": "Vehicle category to scrape.", "default": "car" }, "query": { "title": "🔍 Search Term(s)", "type": "string", "description": "Free-text search keywords (e.g. \"Toyota HiLux\"). Leave empty to browse all listings." }, "make": { "title": "Make / Brand", "enum": [ "", "Volkswagen", "Toyota", "BMW", "Mercedes-Benz", "Volvo", "Ford", "Audi", "Peugeot", "Skoda", "Nissan", "Tesla", "Mitsubishi", "Kia", "Hyundai", "Opel", "Citroen", "Mazda", "Porsche", "Suzuki", "Renault", "Land Rover", "MG", "BYD", "Subaru", "Polestar", "Chevrolet", "Lexus", "MINI", "Honda", "Jaguar", "Fiat", "Jeep", "Saab", "Cupra", "Alfa Romeo", "DS", "Cadillac", "Ferrari", "Bentley", "Maserati", "Abarth", "Dodge", "XPeng" ], "type": "string", "description": "Filter by vehicle make. Brand name (e.g. \"Toyota\", \"BMW\") or raw Schibsted variant ID (e.g. \"0.749\" for BMW). Unknown brands are silently dropped.", "default": "" }, "location": { "title": "📍 Location", "type": "string", "description": "City or region (e.g. \"Oslo\", \"Bergen\")." }, "yearFrom": { "title": "📅 Year From", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest model year to include. Listings with a model year older than this are excluded. Combine with `yearTo` to bound the range. Leave blank to include all years." }, "yearTo": { "title": "📅 Year To", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest model year to include. Listings with a model year newer than this are excluded. Combine with `yearFrom` to bound the range. Leave blank to include all years." }, "priceFrom": { "title": "Price From (NOK)", "minimum": 0, "type": "integer", "description": "Minimum asking price in NOK." }, "priceTo": { "title": "Price To (NOK)", "minimum": 0, "type": "integer", "description": "Maximum asking price in NOK." }, "mileageFrom": { "title": "🛣️ Mileage From (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage in kilometres.", "default": 0 }, "mileageTo": { "title": "🛣️ Mileage To (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage in kilometres.", "default": 0 }, "fuel": { "title": "⛽ Fuel Type", "enum": [ "", "Bensin", "Diesel", "El", "Hybrid bensin", "Hybrid diesel", "Plug-in Bensin", "Plug-in Diesel", "Gass (CNG)", "Gass+bensin", "Hydrogen", "Etanol (FFV, E85)" ], "type": "string", "description": "Filter by fuel type. Norwegian label or numeric ID both work.", "default": "" }, "transmission": { "title": "⚙️ Transmission", "enum": [ "", "Manuell", "Automat" ], "type": "string", "description": "Filter by transmission type. Norwegian label or numeric ID both work.", "default": "" }, "dealerSegment": { "title": "🏢 Seller Segment", "enum": [ "", "Merkeforhandler", "Annet bilutsalg", "Privat" ], "type": "string", "description": "Filter by seller type.", "default": "" }, "maxResults": { "title": "💯 Max Results", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to return (0 = unlimited). Memory scales with this: ≤1000 results uses 256 MB, >1000 uses 512 MB.", "default": 50 }, "fetchDetails": { "title": "📋 Include Full Details", "type": "boolean", "description": "Fetch individual listing pages for full specs (vehicleSpecs), sellerKnowledge Q&A, dealer infokort (orgNr, streetAddress, dealer page), inspection report URL, and updatedAt. Adds one HTTP request per listing.", "default": true }, "descriptionMaxLength": { "title": "✂️ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description text to N characters. 0 = no truncation. Only relevant when fetchDetails is true.", "default": 0 }, "compact": { "title": "📦 Compact Output", "type": "boolean", "description": "Return core fields only (listingId, make, model, year, price, mileage, fuel, transmission, location, url). Ideal for AI-agent and MCP workflows.", "default": false }, "omitNulls": { "title": "🧹 Omit Null / Empty Fields", "type": "boolean", "description": "Drop fields with null, empty string, empty array, or empty object values from each output row. Reduces dataset size and removes noise for LLM pipelines. Keeps `false` and `0` as valid values. Default **on** — flip off if you need a stable schema where every row has every documented field.", "default": true }, "incrementalMode": { "title": "♻️ Incremental Mode", "type": "boolean", "description": "Only emit new or changed listings compared to the previous run. Requires stateKey.", "default": false }, "stateKey": { "title": "🔑 State Key", "type": "string", "description": "Optional stable identifier for the tracked search universe. Leave empty to auto-derive a stable identifier from your search inputs — different keyword/location/filter combinations get isolated state automatically." }, "skipReposts": { "title": "🚫 Skip Reposts", "type": "boolean", "description": "In incremental mode, skip listings that appear to be reposts of previously-seen expired listings (same content hash).", "default": false }, "telegramToken": { "title": "🤖 Telegram Bot Token", "type": "string", "description": "Telegram bot token from @BotFather. Required for Telegram notifications." }, "telegramChatId": { "title": "💬 Telegram Chat ID", "type": "string", "description": "Telegram chat or channel ID where alerts are sent (e.g. \"-100123456789\" for a private group, or \"@yourchannel\")." }, "discordWebhookUrl": { "title": "🎮 Discord Webhook URL", "type": "string", "description": "Discord incoming webhook URL. Get one from Server Settings → Integrations → Webhooks." }, "slackWebhookUrl": { "title": "💼 Slack Webhook URL", "type": "string", "description": "Slack incoming webhook URL. Create at api.slack.com/messaging/webhooks." }, "whatsappPhoneNumberId": { "title": "📱 WhatsApp Phone Number ID", "type": "string", "description": "WhatsApp Business phone number ID from Meta Business Manager (NOT the phone number itself — the numeric ID shown next to your business number). Free service-conversation messages within 24 hours of last user-initiated contact." }, "whatsappAccessToken": { "title": "🔐 WhatsApp Access Token", "type": "string", "description": "Meta Cloud API access token with `whatsapp_business_messaging` scope. Get a permanent token from a system user in Meta Business Manager." }, "whatsappTo": { "title": "📨 WhatsApp Recipient", "type": "string", "description": "Recipient phone in E.164 format (e.g. +4791234567). Recipient must have messaged your business number within the last 24 hours — outside that window, free-form text is rejected by Meta." }, "webhookUrl": { "title": "🪝 Generic Webhook URL", "type": "string", "description": "Generic webhook URL that receives a JSON POST with the full listing payload + run metadata. Universal escape hatch for n8n / Make / Zapier / your own backend." }, "webhookHeaders": { "title": "🔑 Webhook Headers", "type": "object", "description": "Optional headers (e.g. {\"Authorization\": \"Bearer xyz\"}) sent with the webhook POST." }, "notificationLimit": { "title": "📊 Max Listings Per Notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of listings included in each notification message (1–20). Excess listings are still in the dataset; notifications get a summary line.", "default": 5 }, "notifyOnlyChanges": { "title": "🔄 Notify Only New/Updated", "type": "boolean", "description": "When Incremental Mode is on, only send notifications for NEW / UPDATED / REAPPEARED listings. Has no effect outside incremental mode.", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others.", "default": "all" }, "excludeEmptyFields": { "title": "Exclude empty fields from output", "type": "boolean", "description": "Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.", "default": false }, "appConnector": { "title": "Send results to Notion (or another connected app)", "type": "string", "description": "Optional. Pick a connected app under Settings → API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog." }, "mcpIssueTeam": { "title": "Issue tracker team", "type": "string", "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```