{"id":"ssb","name":"Statistics Norway","description":"Search Statbank and fetch table metadata, dimensions, units and statistics in JSON-stat2.","documentation":"https://www.ssb.no/api/pxwebapiv2","operations":[{"name":"search_tables","description":"Search Statbank table titles, variables and values. Signature: search_tables(query: string, required; limit: integer, items, optional, default 25; past_days: integer, days, optional, default None; include_discontinued: yes/no, optional, default False; lang: string, optional, default 'no'; offset: integer, items, optional, default 0).","signature":"search_tables(query: string, required; limit: integer, items, optional, default 25; past_days: integer, days, optional, default None; include_discontinued: yes/no, optional, default False; lang: string, optional, default 'no'; offset: integer, items, optional, default 0)","parameters":[{"name":"query","type":"string","schema":{"type":"string"},"required":true,"default":null,"description":"Search expression, e.g. \"befolkning kommune\" or \"title:arbeidsledighet\".","unit":null,"display_type":"string"},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"required":false,"default":25,"description":"Maximum tables returned by this wrapper, 1-100. Unit: items. Through this API: default 25, maximum 100.","unit":"items","display_type":"integer"},{"name":"past_days","type":"integer","schema":{"anyOf":[{"type":"integer"},{"type":"null"}]},"required":false,"default":null,"description":"Optionally restrict to tables updated in the last N days. Unit: days.","unit":"days","display_type":"integer"},{"name":"include_discontinued","type":"boolean","schema":{"type":"boolean"},"required":false,"default":false,"description":"Include discontinued tables when true.","unit":null,"display_type":"yes/no"},{"name":"lang","type":"string","schema":{"type":"string"},"required":false,"default":"no","description":"Metadata language, \"no\" or \"en\".","unit":null,"display_type":"string"},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/search_tables?query={query}&limit=25&past_days={past_days}&include_discontinued=false&lang=no&offset=0","example_url":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/search_tables?query=befolkning+kommune","output_fields":["match_count","returned","search_note","tables","tables[].id","tables[].label","tables[].description","tables[].updated","tables[].firstPeriod","tables[].lastPeriod","tables[].category","tables[].variableNames","tables[].source","tables[].timeUnit"],"output_fields_truncated":false,"canonical_field_aliases":{"identifier":["tables[].id"],"name":["tables[].label"]},"description_language":"en","documentation":"Search Statbank table titles, variables and values.\n\nArgs:\n    query: Search expression, e.g. \"befolkning kommune\" or \"title:arbeidsledighet\".\n    limit: Maximum tables returned by this wrapper, 1-100.\n    past_days: Optionally restrict to tables updated in the last N days.\n    include_discontinued: Include discontinued tables when true.\n    lang: Metadata language, \"no\" or \"en\".\n\nReturns table identifiers, titles, update periods and variable names. Pass\nan id to get_table_metadata or get_table_data.\n\nThis only searches table titles and topic metadata, never the data inside\na table. A place name (municipality, county) can still return hits: SSB\nalso matches when the term is a selectable value in a table's region\ncodelist, which returns almost every table at that region level with no\nuseful ranking. `search_note` is set when that looks like what happened.\n\nSignature: search_tables(query: string, required; limit: integer, items, optional, default 25; past_days: integer, days, optional, default None; include_discontinued: yes/no, optional, default False; lang: string, optional, default 'no'; offset: integer, items, optional, default 0).","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/ssb/search_tables/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/ssb/search_tables/?query={query}&limit=25&past_days={past_days}&include_discontinued=false&lang=no&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/search_tables","response_schema":{"type":"object","properties":{"match_count":{"type":["integer","null"]},"returned":{"type":"integer"},"search_note":{"type":["string","null"]},"tables":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":["string","null"]},"description":{"type":["string","null"]},"updated":{"type":["string","null"],"format":"date-time"},"firstPeriod":{"type":["string","null"]},"lastPeriod":{"type":["string","null"]},"category":{"type":["string","null"]},"variableNames":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["string","null"]},"timeUnit":{"type":["string","null"]}},"required":["id"]}}},"additionalProperties":false,"required":["match_count","returned","tables"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["statistical_table"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/search_tables/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/search_tables","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/search_tables?query={query}&limit=25&past_days={past_days}&include_discontinued=false&lang=no&offset=0","response_example":{"source":"ssb","operation":"search_tables","parameters":{"query":"befolkning kommune","limit":25,"offset":0},"data":{"match_count":1,"returned":1,"search_note":"example value","tables":[{"id":"example-id","label":"Example","description":"example value","updated":"2026-01-15T12:00:00Z","firstPeriod":"example value","lastPeriod":"example value","category":"example value","variableNames":["Example"],"source":"example value","timeUnit":"2026-01-15T12:00:00Z"}]},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"ssb","name":"Statistics Norway","description":"Search Statbank and fetch table metadata, dimensions, units and statistics in JSON-stat2.","cache_ttl_seconds":300,"documentation":"https://www.ssb.no/api/pxwebapiv2"}]},"_provenance":{"data":{"source":"ssb","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/ssb"},"entities":{"source":"ssb","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/search_tables","source":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","wiki":"https://allemannsdata.com/wiki/kilder/ssb/search_tables/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}},{"name":"get_table_metadata","description":"Get dimensions, value codes, labels, units and periods for an SSB table. Signature: get_table_metadata(table_id: string, required; lang: string, optional, default 'no'; value_filter: string, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","signature":"get_table_metadata(table_id: string, required; lang: string, optional, default 'no'; value_filter: string, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)","parameters":[{"name":"table_id","type":"string","schema":{"type":"string"},"required":true,"default":null,"description":"Five-digit Statbank table id, e.g. \"07459\".","unit":null,"display_type":"string"},{"name":"lang","type":"string","schema":{"type":"string"},"required":false,"default":"no","description":"Metadata language, \"no\" or \"en\".","unit":null,"display_type":"string"},{"name":"value_filter","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Optional case-insensitive substring to filter each dimension's values by code or label, e.g. \"Gloppen\" or \"0301\". Use this instead of paging through a ~980-row municipality list for a single place. It also surfaces renumbered codes for free: SSB keeps a retired code in the list (e.g. \"Gloppen (-2019)\") alongside its replacement (\"Gloppen\", code 4650 since 2020), so both show up in one call.","unit":null,"display_type":"string"},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"display_type":"integer","required":false,"default":25,"description":"Maximum list items returned by the gateway (default 25, maximum 100).","unit":"items"},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_metadata?table_id={table_id}&lang=no&value_filter={value_filter}&limit=25&offset=0","example_url":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_metadata?table_id=07459&value_filter=0301","output_fields":["version","class","label","source","updated","note","role","id","size","dimension","value","extension","link"],"output_fields_truncated":false,"canonical_field_aliases":{"name":["label"],"identifier":["id"]},"description_language":"en","documentation":"Get dimensions, value codes, labels, units and periods for an SSB table.\n\nArgs:\n    table_id: Five-digit Statbank table id, e.g. \"07459\".\n    lang: Metadata language, \"no\" or \"en\".\n    value_filter: Optional case-insensitive substring to filter each\n        dimension's values by code or label, e.g. \"Gloppen\" or \"0301\".\n        Use this instead of paging through a ~980-row municipality list\n        for a single place. It also surfaces renumbered codes for free:\n        SSB keeps a retired code in the list (e.g. \"Gloppen (-2019)\")\n        alongside its replacement (\"Gloppen\", code 4650 since 2020), so\n        both show up in one call.\n\nSignature: get_table_metadata(table_id: string, required; lang: string, optional, default 'no'; value_filter: string, optional, default None; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/ssb/get_table_metadata/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/ssb/get_table_metadata/?table_id={table_id}&lang=no&value_filter={value_filter}&limit=25&offset=0","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_metadata","response_schema":{"type":"object","properties":{"version":{"type":["string","null"]},"class":{"type":["string","null"]},"label":{"type":["string","null"]},"source":{"type":["string","null"]},"updated":{"type":["string","null"],"format":"date-time"},"note":{"type":["array","null"],"items":{"type":"string"}},"role":{"type":["object","null"]},"id":{"type":"array","items":{"type":"string"}},"size":{"type":"array","items":{"type":"integer"}},"dimension":{"type":"object"},"value":{"type":["array","null"],"items":{"type":["number","null"]}},"extension":{"type":["object","null"]},"link":{"type":["object","null"]}},"required":["class","dimension"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["statistical_table"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_metadata/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_metadata","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_metadata?table_id={table_id}&lang=no&value_filter={value_filter}&limit=25&offset=0","response_example":{"source":"ssb","operation":"get_table_metadata","parameters":{"table_id":"07459","value_filter":"0301","limit":25,"offset":0},"data":{"version":"example value","class":"example value","label":"Example","source":"example value","updated":"2026-01-15T12:00:00Z","note":["example value"],"role":{},"id":["example-id"],"size":[1],"dimension":{},"value":[1.0],"extension":{},"link":{}},"entities":[{"type":"statistical_table","id":"07459","source":"ssb","description":"Statistical table used as the operation input."}],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"ssb","name":"Statistics Norway","description":"Search Statbank and fetch table metadata, dimensions, units and statistics in JSON-stat2.","cache_ttl_seconds":300,"documentation":"https://www.ssb.no/api/pxwebapiv2"}]},"_provenance":{"data":{"source":"ssb","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/ssb"},"entities":{"source":"ssb","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_metadata","source":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","wiki":"https://allemannsdata.com/wiki/kilder/ssb/get_table_metadata/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}},{"name":"get_table_data","description":"Get data from an SSB table in JSON-stat2 format using a safe GET query. Signature: get_table_data(table_id: string, required; value_codes: JSON object, optional, default None; lang: string, optional, default 'no').","signature":"get_table_data(table_id: string, required; value_codes: JSON object, optional, default None; lang: string, optional, default 'no')","parameters":[{"name":"table_id","type":"string","schema":{"type":"string"},"required":true,"default":null,"description":"Five-digit Statbank table id, e.g. \"07459\".","unit":null,"display_type":"string"},{"name":"value_codes","type":"object","schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}]},"required":false,"default":null,"description":"Optional JSON object mapping dimension ids to selections, for example {\"Region\":\"0301\",\"Tid\":\"top(3)\",\"ContentsCode\":\"*\"}. Omit it for SSB's small default extract. Values may be strings or lists. Use the exact dimension and value codes returned by get_table_metadata; display prefixes from the Statbank UI are not API value codes.","unit":null,"display_type":"JSON object"},{"name":"lang","type":"string","schema":{"type":"string"},"required":false,"default":"no","description":"Result language, \"no\" or \"en\".","unit":null,"display_type":"string"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_data?table_id={table_id}&value_codes={value_codes}&lang=no","example_url":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_data?table_id=07459&value_codes=%7B%22Region%22%3A%220301%22%2C%22Tid%22%3A%222025%22%2C%22ContentsCode%22%3A%22%2A%22%7D","not_paged":"Returns one JSON-stat dataset; choose rows with value_codes.","output_fields":["version","class","label","source","updated","note","role","id","size","dimension","value","extension","link"],"output_fields_truncated":false,"canonical_field_aliases":{"name":["label"],"identifier":["id"]},"description_language":"en","documentation":"Get data from an SSB table in JSON-stat2 format using a safe GET query.\n\nArgs:\n    table_id: Five-digit Statbank table id, e.g. \"07459\".\n    value_codes: Optional JSON object mapping dimension ids to selections,\n        for example {\"Region\":\"0301\",\"Tid\":\"top(3)\",\"ContentsCode\":\"*\"}.\n        Omit it for SSB's small default extract. Values may be strings or lists.\n        Use the exact dimension and value codes returned by get_table_metadata;\n        display prefixes from the Statbank UI are not API value codes.\n    lang: Result language, \"no\" or \"en\".\n\nUnits and decimals are included in the JSON-stat metadata. SSB enforces its\nown cell limits and returns an error if the requested extract is too large.\nA geographic code queried outside the years it was in force (e.g. a\nmunicipality renumbered in the 2020 reform) returns null/zero with no\nerror from SSB; when detected this is flagged in\n`region_validity_warnings` instead of passing through as a silent zero.\n\nSignature: get_table_data(table_id: string, required; value_codes: JSON object, optional, default None; lang: string, optional, default 'no').","documentation_language":"en","wiki_get_endpoint":"https://allemannsdata.com/wiki/kilder/ssb/get_table_data/","wiki_get_url_template":"https://allemannsdata.com/wiki/kilder/ssb/get_table_data/?table_id={table_id}&value_codes={value_codes}&lang=no","json_endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_data","response_schema":{"type":"object","properties":{"version":{"type":["string","null"]},"class":{"type":["string","null"]},"label":{"type":["string","null"]},"source":{"type":["string","null"]},"updated":{"type":["string","null"],"format":"date-time"},"note":{"type":["array","null"],"items":{"type":"string"}},"role":{"type":["object","null"]},"id":{"type":"array","items":{"type":"string"}},"size":{"type":"array","items":{"type":"integer"}},"dimension":{"type":"object"},"value":{"type":["array","null"],"items":{"type":["number","null"]}},"extension":{"type":["object","null"]},"link":{"type":["object","null"]}},"required":["class","dimension"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["statistical_table"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"response_schema_url":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_data/schema","endpoint":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_data","get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_data?table_id={table_id}&value_codes={value_codes}&lang=no","response_example":{"source":"ssb","operation":"get_table_data","parameters":{"table_id":"07459","value_codes":"{\"Region\":\"0301\",\"Tid\":\"2025\",\"ContentsCode\":\"*\"}"},"data":{"version":"example value","class":"example value","label":"Example","source":"example value","updated":"2026-01-15T12:00:00Z","note":["example value"],"role":{},"id":["example-id"],"size":[1],"dimension":{},"value":[1.0],"extension":{},"link":{}},"entities":[{"type":"statistical_table","id":"07459","source":"ssb","description":"Statistical table used as the operation input."}],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"ssb","name":"Statistics Norway","description":"Search Statbank and fetch table metadata, dimensions, units and statistics in JSON-stat2.","cache_ttl_seconds":300,"documentation":"https://www.ssb.no/api/pxwebapiv2"}]},"_provenance":{"data":{"source":"ssb","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/ssb"},"entities":{"source":"ssb","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/get_table_data","source":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","wiki":"https://allemannsdata.com/wiki/kilder/ssb/get_table_data/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}],"operation_schema_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/ssb/{operation}/schema","related_sources":[{"id":"norgesbank","name":"Norges Bank","reason":"Interest rates, exchange rates and other financial time series.","api":"https://allemannsdata.com/wiki/api/v1/kilder/norgesbank","wiki":"https://allemannsdata.com/wiki/kilder/norgesbank/"},{"id":"data_norge","name":"data.norge.no","reason":"Descriptions of public datasets and APIs.","api":"https://allemannsdata.com/wiki/api/v1/kilder/data_norge","wiki":"https://allemannsdata.com/wiki/kilder/data_norge/"}],"_meta":{"retrieved_at":"2026-11-04T03:00:25Z","language":"en","content_languages":["en"],"sources":[{"id":"ssb","name":"Statistics Norway","description":"Search Statbank and fetch table metadata, dimensions, units and statistics in JSON-stat2.","documentation":"https://www.ssb.no/api/pxwebapiv2","cache_ttl_seconds":300}]},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","names":"https://allemannsdata.com/wiki/api/v1/kilder/ssb?view=names","compact":"https://allemannsdata.com/wiki/api/v1/kilder/ssb?view=compact","full":"https://allemannsdata.com/wiki/api/v1/kilder/ssb","wiki":"https://allemannsdata.com/wiki/kilder/ssb/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}