finn_selskaper

Search for companies by location (kommune or fylke), optionally filtered by business activity codes, company age and employee count.

Direct GET

For navigating agents: open the HTML page with parameters in the URL. The result is fetched and displayed without screenshots or form filling.

https://allemannsdata.com/wiki/kilder/firmafakta/finn_selskaper/?kommune={kommune}&fylke={fylke}&naeringskoder={naeringskoder}&min_age={min_age}&max_age={max_age}&min_employees={min_employees}&max_employees={max_employees}&limit=30&offset=0

Replace {kommune}, {fylke}, {naeringskoder}, {min_age}, {max_age}, {min_employees}, {max_employees}, {limit}, {offset} with values. Remove unused optional parameters from the URL.

For software and dashboards: Read the operation descriptor. The JSON GET template is https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper?kommune={kommune}&fylke={fylke}&naeringskoder={naeringskoder}&min_age={min_age}&max_age={max_age}&min_employees={min_employees}&max_employees={max_employees}&limit=30&offset=0.

ParameterRequirementJSON typeDescription
kommuneoptionalstringMunicipality name (e.g., "Oslo", "Bergen", "Stavanger"). Optional if fylke is provided.
fylkeoptionalstringCounty/region name. Optional if kommune is provided.
naeringskoderoptionalarrayList of business activity codes to filter by. Optional - if not provided, returns all companies in the location. Call list_naeringskoder to look up codes for a segment.
min_ageoptionalintegerMinimum company age in years (calculated from stiftelsesdato).
max_ageoptionalintegerMaximum company age in years (calculated from stiftelsesdato).
min_employeesoptionalintegerMinimum number of employees.
max_employeesoptionalintegerMaximum number of employees.
limitoptionalintegerMaximum number of companies to return. Default is 30, capped at 100.
offsetoptionalintegerNumber of companies to skip. Default is 0.
Generated JavaScript, Python and response structure

Use JSON when the user requests code, machine-readable data, value extraction or further computation. Use the HTML GET page to identify the correct source and verify parameters.

Example for generated JavaScript and Python

https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper?kommune={kommune}&fylke={fylke}&naeringskoder={naeringskoder}&min_age={min_age}&max_age={max_age}&min_employees={min_employees}&max_employees={max_employees}&limit=30&offset=0

Replace URL placeholders and remove unused optional parameters.

JavaScript in a dashboard

const url = "https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper?kommune={kommune}&fylke={fylke}&naeringskoder={naeringskoder}&min_age={min_age}&max_age={max_age}&min_employees={min_employees}&max_employees={max_employees}&limit=30&offset=0";
const response = await fetch(url);
if (!response.ok) {
  const failure = await response.json();
  throw new Error(`${failure.error.code}: ${failure.error.message} ${failure.suggestion}`);
}
const result = await response.json();
const data = result.data;

Python without additional packages

import json
from urllib.request import urlopen

url = "https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper?kommune={kommune}&fylke={fylke}&naeringskoder={naeringskoder}&min_age={min_age}&max_age={max_age}&min_employees={min_employees}&max_employees={max_employees}&limit=30&offset=0"
with urlopen(url) as response:
    result = json.load(response)
data = result["data"]

Response structure

{
  "source": "firmafakta",
  "operation": "finn_selskaper",
  "parameters": {},
  "data": {},
  "entities": [],
  "_meta": {"retrieved_at": "...", "sources": [], "cache": {}},
  "_links": {"self": "...", "source": "...", "wiki": "..."}
}
Form for manual use

The form is a fallback for people and browser agents that cannot open the GET URL directly.

Type: string. Municipality name (e.g., "Oslo", "Bergen", "Stavanger"). Optional if fylke is provided.
Type: string. County/region name. Optional if kommune is provided.
Type: list of string (comma-separated). List of business activity codes to filter by. Optional - if not provided, returns all companies in the location. Call list_naeringskoder to look up codes for a segment.
Type: integer. Minimum company age in years (calculated from stiftelsesdato).
Type: integer. Maximum company age in years (calculated from stiftelsesdato).
Type: integer. Minimum number of employees.
Type: integer. Maximum number of employees.
Type: integer. Maximum number of companies to return. Default is 30, capped at 100.
Type: integer. Number of companies to skip. Default is 0.

Continue exploring

How an AI agent should use this page

Ground rule: Navigate with HTML GET links to keep explanations and relationships. Use the page's JSON alternative only when concrete values must be extracted, compared or computed.

How to use the finn_selskaper lookup

  1. Replace the placeholders in the HTML GET template; remove optional parameters you do not need.
  2. Check types, units, limits and ID formats in the parameter table.
  3. Follow linked results to canonical pages before combining sources.

Misreading to avoid: An empty list means "no results for this lookup". An error message or unavailable source does not mean the data does not exist.

Source-specific next step

Go to the source page for other operations. Use the JSON template only after the HTML result shows that the parameters and source are correct.