{ "openapi": "3.0.1", "info": { "title": "Norway Company Register Scraper: Brreg Business Data", "description": "Norwegian companies from the official Brønnøysund register as flat rows: search by municipality, industry, legal form, size or age, or pull the daily feed of new, changed and deleted companies.", "version": "0.1", "x-build-id": "BgF8jPVxy3JTzS0Sa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bogdiehard~brreg-norway-company-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bogdiehard-brreg-norway-company-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/bogdiehard~brreg-norway-company-scraper/runs": { "post": { "operationId": "runs-sync-bogdiehard-brreg-norway-company-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/bogdiehard~brreg-norway-company-scraper/run-sync": { "post": { "operationId": "run-sync-bogdiehard-brreg-norway-company-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": { "mode": { "title": "Mode", "enum": [ "search", "updates" ], "type": "string", "description": "Search: companies that match the filters. Change feed: companies the register changed since \"Updates since\" (new, changed or deleted). The filters apply to search only.", "default": "search" }, "name": { "title": "Company name contains", "type": "string", "description": "Free text matched against the company name, as the register matches names. Search mode only." }, "legalForms": { "title": "Legal forms", "uniqueItems": true, "type": "array", "description": "Keep companies with these legal forms. Empty means every form except sole proprietorships (ENK, available with the setting below). Records of private persons (PERS) and estates (BO, KBO) are never output. Search mode only.", "items": { "type": "string", "enum": [ "ADOS", "ANNA", "ANS", "AS", "ASA", "BA", "BBL", "BRL", "DA", "ENK", "EOFG", "ESEK", "FKF", "FLI", "FYLK", "GFS", "IKJP", "IKS", "KF", "KIRK", "KOMM", "KS", "KTRF", "NUF", "OPMV", "ORGL", "PK", "PRE", "SA", "SAM", "SE", "SF", "SPA", "STAT", "STI", "SÆR", "TVAM", "UTLA", "VPFO" ], "enumTitles": [ "ADOS - Administrativ enhet - offentlig sektor", "ANNA - Annen juridisk person", "ANS - Ansvarlig selskap med solidarisk ansvar", "AS - Aksjeselskap", "ASA - Allmennaksjeselskap", "BA - Selskap med begrenset ansvar", "BBL - Boligbyggelag", "BRL - Borettslag", "DA - Ansvarlig selskap med delt ansvar", "ENK - Enkeltpersonforetak", "EOFG - Europeisk økonomisk foretaksgruppe", "ESEK - Eierseksjonssameie", "FKF - Fylkeskommunalt foretak", "FLI - Forening/lag/innretning", "FYLK - Fylkeskommune", "GFS - Gjensidig forsikringsselskap", "IKJP - Andre ikke-juridiske personer", "IKS - Interkommunalt selskap", "KF - Kommunalt foretak", "KIRK - Den norske kirke", "KOMM - Kommune", "KS - Kommandittselskap", "KTRF - Kontorfellesskap", "NUF - Norskregistrert utenlandsk foretak", "OPMV - Særskilt oppdelt enhet, jf. mval. § 2-2", "ORGL - Organisasjonsledd", "PK - Pensjonskasse", "PRE - Partrederi", "SA - Samvirkeforetak", "SAM - Tingsrettslig sameie", "SE - Europeisk selskap", "SF - Statsforetak", "SPA - Sparebank", "STAT - Staten", "STI - Stiftelse", "SÆR - Annet foretak iflg. særskilt lov", "TVAM - Tvangsregistrert for MVA", "UTLA - Utenlandsk enhet", "VPFO - Verdipapirfond" ] } }, "municipalityCodes": { "title": "Municipality numbers", "uniqueItems": true, "type": "array", "description": "4-digit municipality numbers (kommunenummer), for example 0301 for Oslo. Empty means the whole country. Search mode only.", "items": { "type": "string", "pattern": "^\\d{4}$" } }, "industryCodes": { "title": "Industry codes (SN2025)", "uniqueItems": true, "type": "array", "description": "SN2025 industry codes (the standard Brreg uses now), for example 62.100 (computer programming) or a prefix such as 62 for the whole division. Older SN2007 codes such as 62.010 no longer match anything. Search mode only.", "items": { "type": "string", "pattern": "^\\d{2}(\\.\\d{1,3})?$" } }, "minEmployees": { "title": "Minimum employees", "minimum": 0, "type": "integer", "description": "Keep companies with at least this many registered employees. Search mode only." }, "maxEmployees": { "title": "Maximum employees", "minimum": 0, "type": "integer", "description": "Keep companies with at most this many registered employees. Search mode only." }, "registeredFrom": { "title": "Registered from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep companies registered in the register on or after this date, as YYYY-MM-DD. Search mode only." }, "registeredTo": { "title": "Registered to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep companies registered on or before this date, as YYYY-MM-DD. Search mode only." }, "onlyActive": { "title": "Active companies only", "type": "boolean", "description": "Leave out companies that are bankrupt or under liquidation. Search mode only. The change feed always includes them.", "default": true }, "includeSoleProprietorships": { "title": "Include sole proprietorships (ENK)", "type": "boolean", "description": "Off by default. A sole proprietorship (ENK) is a business named after its owner, so its name is a person's name. Records of private persons (PERS) and of estates (BO, KBO) are never output, whatever this setting.", "default": false }, "updatesSince": { "title": "Updates since", "type": "string", "description": "Change feed mode only: the earliest change time to include, as ISO 8601, for example 2026-10-11T00:00:00Z. Empty means 24 hours before the run." }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of results to return (up to 50,000). You are charged per result. Above 10,000, a search is split into several queries automatically.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed for this official open-data API, so it is off by default. Turn it on only if the register blocks your requests.", "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 } } } } } } } } } }