{
  "openapi": "3.0.1",
  "info": {
    "title": "FINN.no Scraper: Norway Marketplace Listings",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "3QHLIBMmR0CR2a7Ob"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/reventadata~finn-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-reventadata-finn-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/reventadata~finn-scraper/runs": {
      "post": {
        "operationId": "runs-sync-reventadata-finn-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/reventadata~finn-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-reventadata-finn-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": {
          "vertical": {
            "title": "What to search",
            "enum": [
              "torget",
              "cars"
            ],
            "type": "string",
            "description": "'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.",
            "default": "torget"
          },
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum price (NOK)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive, in Norwegian kroner. Applied by the site itself. Must not be above the maximum price."
          },
          "maxPrice": {
            "title": "Maximum price (NOK)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive, in Norwegian kroner. Applied by the site itself."
          },
          "county": {
            "title": "County",
            "enum": [
              "any",
              "agder",
              "akershus",
              "buskerud",
              "finnmark",
              "innlandet",
              "more-og-romsdal",
              "nordland",
              "oslo",
              "rogaland",
              "svalbard",
              "telemark",
              "troms",
              "trondelag",
              "vestfold",
              "vestland",
              "ostfold"
            ],
            "type": "string",
            "description": "Optional Norwegian county (fylke). Any county searches the whole country.",
            "default": "any"
          },
          "sellers": {
            "title": "Seller kind",
            "enum": [
              "any",
              "private",
              "company",
              "brand-dealer",
              "independent-dealer"
            ],
            "type": "string",
            "description": "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.",
            "default": "any"
          },
          "category": {
            "title": "Torget category (Torget only)",
            "enum": [
              "any",
              "business",
              "building-garden",
              "animals",
              "electronics",
              "vehicle-accessories",
              "parents-children",
              "clothes-cosmetics",
              "art-antiques",
              "furniture-interior",
              "sports-outdoors",
              "entertainment-hobby"
            ],
            "type": "string",
            "description": "Optional top-level Torget category. Rejected when 'What to search' is 'Used cars'.",
            "default": "any"
          },
          "tradeType": {
            "title": "Ad type (Torget only)",
            "enum": [
              "sell",
              "giveaway",
              "wanted",
              "any"
            ],
            "type": "string",
            "description": "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'.",
            "default": "sell"
          },
          "shippingOnly": {
            "title": "Only ads offering shipping (Torget only)",
            "type": "boolean",
            "description": "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'.",
            "default": false
          },
          "fuel": {
            "title": "Fuel (used cars only)",
            "enum": [
              "any",
              "petrol",
              "diesel",
              "electric",
              "hybrid-petrol",
              "hybrid-diesel",
              "plug-in-petrol",
              "plug-in-diesel"
            ],
            "type": "string",
            "description": "Optional fuel type. Rejected when 'What to search' is 'Torget'.",
            "default": "any"
          },
          "minYear": {
            "title": "Minimum model year (used cars only)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive. Rejected for Torget."
          },
          "maxYear": {
            "title": "Maximum model year (used cars only)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive. Rejected for Torget."
          },
          "minMileage": {
            "title": "Minimum mileage in km (used cars only)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive. Rejected for Torget."
          },
          "maxMileage": {
            "title": "Maximum mileage in km (used cars only)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive. Rejected for Torget."
          },
          "requireKeywordMatch": {
            "title": "Require the query in the title",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "maxItems": {
            "title": "Maximum rows",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on rows saved across all search terms.",
            "default": 100
          },
          "maxPages": {
            "title": "Maximum pages per search term",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "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.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. Left off by default; only turn it on if you see request failures.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}