{ "openapi": "3.0.1", "info": { "title": "FINN.no Scraper — Marketplace, Cars, Homes & Jobs, No Phones", "description": "Norwegian listings from FINN.no — Torget, cars, boats, homes for sale and rent, commercial property and jobs: price, place, seller type and company, details on request. No phones.", "version": "0.1", "x-build-id": "8i5YL2ZTel3aRcvcY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~finn-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-finn-listings", "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/highbrow_fame~finn-listings/runs": { "post": { "operationId": "runs-sync-highbrow_fame-finn-listings", "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/highbrow_fame~finn-listings/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-finn-listings", "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": { "searchUrls": { "title": "Search links", "type": "array", "description": "Set up a search on finn.no — Torget (the marketplace), cars, motorbikes, boats, caravans, motorhomes, machines, property (homes for sale, new homes, rentals, holiday homes, plots, commercial) or jobs — with all the filters you want, and paste the address of the results page. One per line.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Or search for these words, one per line — e.g. \"sofa\", \"iphone 15\", \"volvo v70\", \"sjøutsikt\", \"utvikler\". The options below apply to them.", "items": { "type": "string" } }, "section": { "title": "Section to search", "enum": [ "marketplace", "cars", "motorcycles", "mopeds", "atvs", "snowmobiles", "boats", "caravans", "motorhomes", "trucks", "buses", "construction-machines", "tractors", "farm-tools", "homes-for-sale", "new-homes", "rentals", "holiday-homes", "plots", "holiday-plots", "homes-abroad", "commercial-for-sale", "commercial-for-rent", "jobs" ], "type": "string", "description": "For the keywords above.", "default": "marketplace" }, "category": { "title": "Category", "enum": [ "all", "furniture-and-interior", "electronics", "sport-and-outdoors", "parents-and-children", "fashion-and-beauty", "garden-and-renovation", "entertainment-and-hobbies", "art-and-antiques", "vehicle-parts", "animals", "business" ], "type": "string", "description": "Optional, for Torget keywords. For a narrower category (e.g. bikes or sofas), set it up on finn.no and paste the link instead.", "default": "all" }, "region": { "title": "Place", "type": "string", "description": "Optional, for the keywords above: a county (fylke) such as \"Oslo\", \"Vestland\" or \"Trøndelag\", or a municipality or district such as \"Bergen\", \"Trondheim\" or \"Stavanger\". Empty: all of Norway." }, "minPrice": { "title": "Min price (NOK)", "minimum": 0, "type": "integer", "description": "Optional, for the keywords above (for rentals: the monthly rent). Not used for jobs." }, "maxPrice": { "title": "Max price (NOK)", "minimum": 0, "type": "integer", "description": "Optional, for the keywords above (for rentals: the monthly rent). Not used for jobs." }, "condition": { "title": "Condition", "enum": [ "any", "new", "as-new", "good", "worn", "for-repair" ], "type": "string", "description": "Optional, for Torget keywords.", "default": "any" }, "sellerType": { "title": "Offered by", "enum": [ "all", "private", "business" ], "type": "string", "description": "Optional, for the keywords above: private persons, or dealers, shops, estate agents and other businesses.", "default": "all" }, "sortBy": { "title": "Sort", "enum": [ "default", "newest", "cheapest", "most-expensive" ], "type": "string", "description": "For the keywords above. Jobs can be sorted by newest only.", "default": "default" }, "maxListingsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops each search (link or keyword) after this many listings. FINN shows at most 50 pages (2,500-2,650 listings) for one search; to go further, the Actor reads the rest county by county, municipality by municipality and in price bands.", "default": 200 }, "includeDetails": { "title": "Open every Torget listing and job ad for its details", "type": "boolean", "description": "Torget listings get the full description, the category, the condition, the postcode and the item details (brand, size, type…). Job ads get the sector, extent, duration, occupations, industries, skills, workplace postcode and FINN's summary of qualifications and benefits. One more page per listing, so slower. Vehicles and property already carry their data and are not opened.", "default": false }, "exactMatchesOnly": { "title": "Only exact matches", "type": "boolean", "description": "When a Torget search finds only a few listings with your words, FINN adds similar ones and counts them in its result (\"volvo pv444\": 40 listings, 13 of them with the words). Tick to leave the similar ones out. Every Torget record says how it matched in \"matchedBy\".", "default": false }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to work on at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Used only to try again after a network error: the first try goes out directly.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }