{ "openapi": "3.0.1", "info": { "title": "Norway Companies Scraper", "description": "Scrape Norway's Brønnøysund company register by name or filter (legal form, NACE, municipality, employees, VAT, dates). Clean firmographics with CEO, board, annual accounts, address and share capital. Batch lookup by org number, sub-units of a parent, and a change feed for CRM sync.", "version": "1.0", "x-build-id": "tqA1agOnX3fWGZStJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~norway-companies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-norway-companies-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/normdata~norway-companies-scraper/runs": { "post": { "operationId": "runs-sync-normdata-norway-companies-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/normdata~norway-companies-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-norway-companies-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Caps how many rows this run writes to the dataset. Starts at 10 for a quick sample; raise it for a full run." }, "mode": { "title": "What to get", "enum": [ "search", "lookup", "subunits", "updates" ], "type": "string", "description": "Search filters the register. Look up takes exact organisation numbers. Sub-units returns the establishments of a company. Change feed returns entities registered or changed since a date." }, "query": { "title": "Company name (for Search)", "type": "string", "description": "Full or partial company name. Leave empty to search the whole register with the filters below." }, "municipality": { "title": "Municipality number (for Search)", "type": "string", "description": "Norwegian municipality number, e.g. 0301 for Oslo, 1103 for Stavanger." }, "industryCode": { "title": "Industry code (NACE) (for Search)", "type": "string", "description": "NACE / SN2007 code, e.g. 62.010 for computer programming. Prefix matches work (62 covers all of IT services)." }, "orgForm": { "title": "Legal form (for Search)", "type": "string", "description": "Organisation form code, e.g. AS (private limited), ASA (public limited), ENK (sole proprietorship), NUF (foreign branch)." }, "postalCode": { "title": "Postal code (for Search)", "type": "string", "description": "Four-digit Norwegian postal code." }, "employeesFrom": { "title": "Employees from (for Search)", "type": "integer", "description": "Minimum registered employee count." }, "employeesTo": { "title": "Employees to (for Search)", "type": "integer", "description": "Maximum registered employee count." }, "sectorCode": { "title": "Institutional sector code (for Search)", "type": "string", "description": "Institutional sector code, e.g. 2100 for private non-financial companies." }, "vatRegistered": { "title": "VAT (MVA) registration (for Search)", "enum": [ "any", "yes", "no" ], "type": "string", "description": "Filter by whether the company is in the VAT register." }, "bankruptOnly": { "title": "Only bankrupt companies (for Search)", "type": "boolean", "description": "Return only companies currently flagged as bankrupt.", "default": false }, "foundedFrom": { "title": "Founded from (for Search)", "type": "string", "description": "Earliest founding date, YYYY-MM-DD." }, "foundedTo": { "title": "Founded to (for Search)", "type": "string", "description": "Latest founding date, YYYY-MM-DD." }, "registeredFrom": { "title": "Registered from (for Search)", "type": "string", "description": "Earliest registration date in the entity register, YYYY-MM-DD." }, "registeredTo": { "title": "Registered to (for Search)", "type": "string", "description": "Latest registration date in the entity register, YYYY-MM-DD." }, "orgNumbers": { "title": "Organisation numbers (for Look up)", "type": "array", "description": "Nine-digit Norwegian organisation numbers. Spaces and other separators are stripped.", "items": { "type": "string" } }, "parentOrgNumber": { "title": "Parent organisation number (for Sub-units)", "type": "string", "description": "Return every establishment (sub-unit) registered under this company." }, "changedSince": { "title": "Changed since (for Change feed)", "type": "string", "description": "YYYY-MM-DD. Returns every entity registered or changed on or after this date, newest first." }, "includeRoles": { "title": "Include board and CEO (for Search, Look up, Sub-units)", "type": "boolean", "description": "Add the CEO, chair and full officer list (with roles and birth dates) to each company. Billed as a separate 'Detail record' event, and only for companies where role data is found. Turn off to skip it." }, "includeFinancials": { "title": "Include annual accounts (for Search, Look up)", "type": "boolean", "description": "Add the filed annual accounts (revenue, operating result, annual result, total assets, equity, debt) for the years on record. Billed as a separate 'Financials record' event, and only for companies that have filed accounts. Turn off to skip it." } } }, "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 } } }, "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 } } } } } } } } } }