search_address

Search Norwegian addresses by free text.

Signature: search_address(text: string, optional, default None; kommunenummer: string, optional, default None; limit: integer, items, optional, default 25; query: string, optional, default None; offset: integer, items, optional, default 0)

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.

Open this validated HTML GET URL

https://allemannsdata.com/wiki/kilder/geonorge/search_address/?text={text}&kommunenummer={kommunenummer}&limit=25&query={query}&offset=0

Replace {text}, {kommunenummer}, {limit}, {query} 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/geonorge/search_address?text={text}&kommunenummer={kommunenummer}&limit=25&query={query}&offset=0. Open this exact request as JSON.

ParameterRequirementJSON typeDescription
textoptionalunionAddress query, e.g. "Karl Johans gate 1" or "Storgata".
kommunenummeroptionalunionOptional 4-digit municipality code to restrict the search (e.g. "0301" for Oslo, "4601" for Bergen).
limitoptionalintegerMax hits to return, 1 to 100 (default 20). Unit: items. Through this API: default 25, maximum 100.
queryoptionalunionAlias for `text` (use one or the other).
offsetoptionalintegerNumber of list items to skip; default 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/geonorge/search_address?text={text}&kommunenummer={kommunenummer}&limit=25&query={query}&offset=0

Replace URL placeholders and remove unused optional parameters.

JavaScript in a dashboard

const url = "https://allemannsdata.com/wiki/api/v1/kilder/geonorge/search_address?text={text}&kommunenummer={kommunenummer}&limit=25&query={query}&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/geonorge/search_address?text={text}&kommunenummer={kommunenummer}&limit=25&query={query}&offset=0"
with urlopen(url) as response:
    result = json.load(response)
data = result["data"]

Response structure

{
  "source": "geonorge",
  "operation": "search_address",
  "parameters": {},
  "data": {},
  "entities": [],
  "_meta": {"retrieved_at": "...", "sources": [], "cache": {}},
  "_links": {"self": "...", "source": "...", "wiki": "...", "feedback": "..."}
}

Unknown parameter ignored: postal_code. Valid parameters: text, kommunenummer, limit, query.

Form for manual use

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

Type: string. Address query, e.g. "Karl Johans gate 1" or "Storgata".
Type: string. Optional 4-digit municipality code to restrict the search (e.g. "0301" for Oslo, "4601" for Bergen).
Type: integer. Max hits to return, 1 to 100 (default 20). Unit: items. Through this API: default 25, maximum 100.
Type: string. Alias for `text` (use one or the other).

Result

Source: Geonorge. Retrieved 2026-11-02T03:15:09Z in 1.720 seconds.

total_count:
0
addresses:

No results.

places:

11 results

  1. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Landskapsområde
    status:
    aktiv
    kommune:
    Grimstad
    fylke:
    Agder
    lat:
    58.44657
    lon:
    8.41043
    place_id:
    60997
  2. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Bydel
    status:
    aktiv
    kommune:
    Porsgrunn
    fylke:
    Telemark
    lat:
    59.14446
    lon:
    9.64226
    place_id:
    62630
  3. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Stavanger
    fylke:
    Rogaland
    lat:
    59.231
    lon:
    5.88798
    place_id:
    1073502
  4. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Nord-Odal
    fylke:
    Innlandet
    lat:
    60.43207
    lon:
    11.61118
    place_id:
    646603
  5. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Grend
    status:
    aktiv
    kommune:
    Vadsø
    fylke:
    Finnmark - Finnmárku - Finmarkku
    lat:
    70.11458
    lon:
    29.31713
    place_id:
    576065
  6. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Flesberg
    fylke:
    Buskerud
    lat:
    59.79179
    lon:
    9.57425
    place_id:
    1035411
  7. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Li
    status:
    aktiv
    kommune:
    Sør-Aurdal
    fylke:
    Innlandet
    lat:
    60.82377
    lon:
    9.46301
    place_id:
    160824
  8. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Rollag
    fylke:
    Buskerud
    lat:
    59.91119
    lon:
    9.34905
    place_id:
    1035026
  9. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Bygland
    fylke:
    Agder
    lat:
    58.67415
    lon:
    7.79528
    place_id:
    1054663
  10. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Jorde
    status:
    aktiv
    kommune:
    Kristiansand
    fylke:
    Agder
    lat:
    58.25447
    lon:
    7.66105
    place_id:
    951732
  11. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Jorde
    status:
    aktiv
    kommune:
    Lyngdal
    fylke:
    Agder
    lat:
    58.24491
    lon:
    7.34677
    place_id:
    352432
degraded:
yes
note:
The Kartverket address service failed (Geonorge API error (503) on /sok: HTML error page, see https://status.kartverket.no). `places` holds place-name hits for 'Vestsida' instead, without house numbers.
Show all fields in HTML
total_count:
0
addresses:

No results.

places:

11 results

  1. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Landskapsområde
    status:
    aktiv
    kommune:
    Grimstad
    fylke:
    Agder
    lat:
    58.44657
    lon:
    8.41043
    place_id:
    60997
  2. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Bydel
    status:
    aktiv
    kommune:
    Porsgrunn
    fylke:
    Telemark
    lat:
    59.14446
    lon:
    9.64226
    place_id:
    62630
  3. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Stavanger
    fylke:
    Rogaland
    lat:
    59.231
    lon:
    5.88798
    place_id:
    1073502
  4. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Nord-Odal
    fylke:
    Innlandet
    lat:
    60.43207
    lon:
    11.61118
    place_id:
    646603
  5. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Grend
    status:
    aktiv
    kommune:
    Vadsø
    fylke:
    Finnmark - Finnmárku - Finmarkku
    lat:
    70.11458
    lon:
    29.31713
    place_id:
    576065
  6. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Flesberg
    fylke:
    Buskerud
    lat:
    59.79179
    lon:
    9.57425
    place_id:
    1035411
  7. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Li
    status:
    aktiv
    kommune:
    Sør-Aurdal
    fylke:
    Innlandet
    lat:
    60.82377
    lon:
    9.46301
    place_id:
    160824
  8. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Rollag
    fylke:
    Buskerud
    lat:
    59.91119
    lon:
    9.34905
    place_id:
    1035026
  9. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Adressenavn
    status:
    aktiv
    kommune:
    Bygland
    fylke:
    Agder
    lat:
    58.67415
    lon:
    7.79528
    place_id:
    1054663
  10. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Jorde
    status:
    aktiv
    kommune:
    Kristiansand
    fylke:
    Agder
    lat:
    58.25447
    lon:
    7.66105
    place_id:
    951732
  11. names:

    1 results

    1. name:
      Vestsida
      language:
      Norsk
      status:
      hovednavn
    type:
    Jorde
    status:
    aktiv
    kommune:
    Lyngdal
    fylke:
    Agder
    lat:
    58.24491
    lon:
    7.34677
    place_id:
    352432
degraded:
yes
note:
The Kartverket address service failed (Geonorge API error (503) on /sok: HTML error page, see https://status.kartverket.no). `places` holds place-name hits for 'Vestsida' instead, without house numbers.
Will you use the result in generated code?

Open the same result as JSON

Is data missing or incorrect? Send feedback about this result.

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 search_address 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.