{ "openapi": "3.0.1", "info": { "title": "Norway Company Register Scraper: Brønnøysund Business Data", "description": "Norwegian companies from the Central Coordinating Register for Legal Entities (Brønnøysund, NLOD open data): organisation number, legal form, industry, employees, share capital, addresses, website, VAT and bankruptcy status. No sole traders, no personal data.", "version": "1.0", "x-build-id": "MKUMbuMcWVMifnOY0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rowcraft~norway-company-register-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rowcraft-norway-company-register-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/rowcraft~norway-company-register-scraper/runs": { "post": { "operationId": "runs-sync-rowcraft-norway-company-register-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/rowcraft~norway-company-register-scraper/run-sync": { "post": { "operationId": "run-sync-rowcraft-norway-company-register-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": { "municipalities": { "title": "Municipalities", "type": "array", "description": "Municipality of the business address, one per line: Norwegian name or 4-digit number (Oslo, Bergen, Tromsø or 4601). Empty = all of Norway.", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Counties (fylker) since 2024, one per line: Vestland, Rogaland, Trøndelag, Akershus... Every municipality of the county is searched.", "items": { "type": "string" } }, "industryCodes": { "title": "Industry codes (NACE / SN)", "type": "array", "description": "Industry codes of the Norwegian standard (based on NACE), one per line: a section letter (J), a division (62) or a full code (62.100). A shorter code includes everything under it.", "items": { "type": "string" } }, "registeredAfter": { "title": "Registered after", "type": "string", "description": "Only entities registered in the register on or after this day: a date (2026-10-01), today, yesterday, or a relative value such as 7 days, 3 months. New registrations are mostly new companies." }, "registeredBefore": { "title": "Registered before", "type": "string", "description": "Only entities registered on or before this day." }, "search": { "title": "Name contains", "type": "string", "description": "Words in the company name: bygg, consulting, Equinor." }, "legalForms": { "title": "Legal forms", "type": "array", "description": "Empty = every legal form except sole proprietorships (ENK), individuals and estates, which are never delivered.", "items": { "type": "string", "enum": [ "AS", "ASA", "ANS", "DA", "KS", "NUF", "SA", "BA", "SE", "STI", "FLI", "BRL", "BBL", "ESEK", "SAM", "PRE", "SPA", "GFS", "PK", "VPFO", "SF", "IKS", "KF", "FKF", "KOMM", "FYLK", "STAT", "ADOS", "ORGL", "KIRK", "SÆR", "OPMV", "EOFG", "ANNA", "IKJP", "KTRF", "UTLA" ], "enumTitles": [ "AS – private limited company", "ASA – public limited company", "ANS – general partnership (joint liability)", "DA – general partnership (shared liability)", "KS – limited partnership", "NUF – Norwegian branch of a foreign company", "SA – cooperative", "BA – company with limited liability", "SE – European company", "STI – foundation", "FLI – association, club or institution", "BRL – housing cooperative", "BBL – housing cooperative building association", "ESEK – owner-section condominium", "SAM – co-ownership", "PRE – shipping partnership", "SPA – savings bank", "GFS – mutual insurance company", "PK – pension fund", "VPFO – securities fund", "SF – state enterprise", "IKS – inter-municipal company", "KF – municipal enterprise", "FKF – county municipal enterprise", "KOMM – municipality", "FYLK – county", "STAT – the State", "ADOS – public administrative unit", "ORGL – organisational unit", "KIRK – Church of Norway", "SÆR – enterprise under a special act", "OPMV – separately divided unit (VAT)", "EOFG – European economic interest grouping", "ANNA – other legal person", "IKJP – other non-legal person", "KTRF – office community", "UTLA – foreign entity" ] } }, "status": { "title": "Status", "enum": [ "active", "bankrupt", "liquidation", "forcedDissolution", "distressed", "any" ], "type": "string", "description": "Active = not bankrupt and not being wound up. Bankrupt, in liquidation, forced dissolution (accounts or auditor missing), any distress, or all.", "default": "active" }, "minEmployees": { "title": "Minimum employees", "minimum": 0, "type": "integer", "description": "Only entities with at least this many employees. The register refuses searches between 1 and 4 employees (privacy), so 2-4 becomes 5." }, "maxEmployees": { "title": "Maximum employees", "minimum": 0, "type": "integer", "description": "Only entities with at most this many employees (0 = none registered; 1-3 becomes 4)." }, "foundedAfter": { "title": "Founded after", "type": "string", "description": "Only entities whose founding date (date of the memorandum of association) is on or after this day: a date or \"1 year\" (ago)." }, "foundedBefore": { "title": "Founded before", "type": "string", "description": "Only entities founded on or before this day, for example 2000-01-01 for long-established companies." }, "vatRegistered": { "title": "Registered for VAT", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Registered in the VAT register (a sign of real trading activity), not registered, or either.", "default": "any" }, "inBusinessRegister": { "title": "In the Register of Business Enterprises", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Registered in Foretaksregisteret (companies, partnerships and other businesses), not registered (most associations), or either.", "default": "any" }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "Postal codes of the business address, one per line (4 digits: 0150, 5003).", "items": { "type": "string" } }, "lastAccountsYears": { "title": "Last annual accounts filed for year", "type": "array", "description": "Only entities whose latest filed annual accounts are for one of these years (2025): companies that are up to date with their filings.", "items": { "type": "string" } }, "onlyWithWebsite": { "title": "Only entities with a website", "type": "boolean", "description": "Only entities with a registered website (about 89,000 of the 705,000 searchable entities). The free count includes this filter.", "default": false }, "sort": { "title": "Sort order", "enum": [ "newest", "oldest", "employees", "founded", "name", "number" ], "type": "string", "description": "Order of the results when you take fewer than all matching entities.", "default": "newest" }, "maxItems": { "title": "Maximum entities", "minimum": 0, "type": "integer", "description": "Stop after this many entities. 0 = all matching entities (above 10,000 the search runs in windows of registration dates).", "default": 500 }, "organisationNumbers": { "title": "Look up organisation numbers", "type": "array", "description": "Norwegian organisation numbers (9 digits: 923609016, also as NO 923 609 016 MVA or a register link), one per line. When set, every filter above is ignored.", "items": { "type": "string" } }, "countOnly": { "title": "Count only (free check)", "type": "boolean", "description": "Only count how many rows match your filters and estimate the cost at your price tier. Nothing is delivered and nothing is charged apart from the start event. Turn it off to get the data.", "default": false }, "onlyNew": { "title": "Only new rows since the last run", "type": "boolean", "description": "Remember the rows already delivered to you (in a key-value store in your Apify account) and deliver only rows that appeared since the last run with the same state key. The first run delivers everything that matches; later runs cost only the new rows. Ideal for schedules.", "default": false }, "stateName": { "title": "State name", "type": "string", "description": "Name of the memory used by \"Only new rows\". Use a different name for each schedule or search (for example `stockholm-python`) so they do not share one memory.", "default": "default" }, "notifyUrl": { "title": "Notify this URL when the run ends", "type": "string", "description": "A webhook address that receives one JSON POST with the number of new rows and links to the dataset: a Slack or Discord incoming webhook, a Make, n8n or Zapier catch hook, or your own endpoint. The message is also in the `text` (Slack) and `content` (Discord) fields." }, "notifyWhenEmpty": { "title": "Notify also when there are no new rows", "type": "boolean", "description": "By default the notification is sent only when at least one row was delivered.", "default": false }, "requestIntervalMs": { "title": "Delay between API requests (ms)", "minimum": 1000, "maximum": 10000, "type": "integer", "description": "Default 1000 ms (one request per second). Each search request returns up to 1,000 entities, so even large searches need few requests.", "default": 1000 } } }, "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 } } } } } } } } } }