{ "openapi": "3.0.1", "info": { "title": "North Data Scraper - European Company Registry", "description": "European company register records from North Data, 26 countries: legal form, register court and HRB number, EUID, LEI, address, status, industry and officers. Revenue only where the company publishes accounts, which most small ones do not. No account. $2.55 per 1,000 companies.", "version": "0.1", "x-build-id": "UxAgH4EtmoxgQi1XN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~northdata-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-northdata-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/dami_studio~northdata-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-northdata-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/dami_studio~northdata-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-northdata-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": { "searchQueries": { "title": "Company names to search", "type": "array", "description": "Company names or keywords to look up on North Data. One per line. North Data serves anonymous callers roughly 59 results per search term, so use narrower terms if you need more.", "items": { "type": "string" } }, "startUrls": { "title": "North Data URLs", "type": "array", "description": "Optional. Paste company pages (https://www.northdata.com/Zalando%20SE,%20Berlin/HRB%20158855%20B) or search pages (https://www.northdata.com/?query=Zalando). Works alongside the search terms above. Person pages are not supported.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Optional. Restrict results to these countries. Leave empty to search all of North Data's coverage.", "items": { "type": "string", "enum": [ "AT", "BE", "CH", "CY", "CZ", "DE", "DK", "EE", "ES", "FI", "FR", "GB", "GR", "HR", "IE", "IL", "LT", "LU", "MT", "NL", "NO", "PL", "PT", "RO", "SE", "SK" ], "enumTitles": [ "Austria", "Belgium", "Switzerland", "Cyprus", "Czech Republic", "Germany", "Denmark", "Estonia", "Spain", "Finland", "France", "United Kingdom", "Greece", "Croatia", "Ireland", "Israel", "Lithuania", "Luxembourg", "Malta", "Netherlands", "Norway", "Poland", "Portugal", "Romania", "Sweden", "Slovakia" ] }, "default": [] }, "maxItems": { "title": "Maximum companies", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on company records returned across all searches and URLs. You are charged per company returned.", "default": 20 }, "includeDetails": { "title": "Open each company page", "type": "boolean", "description": "On (default): opens every company page and returns the full record - register number, EUID, LEI, full address, industry, corporate purpose, officers and revenue. Off: returns only what the search listing shows (name, city, country, register id, status), which is much faster.", "default": true }, "includeOfficers": { "title": "Include officers", "type": "boolean", "description": "Include the company's registered legal representatives (name and role only, as published in the commercial register). No contact details are collected.", "default": true }, "includePublications": { "title": "Include publications timeline", "type": "boolean", "description": "Include up to 25 register announcements per company (date, register, text): appointments, capital changes, annual reports, mergers, insolvency notices. Makes rows noticeably larger.", "default": false }, "includeFinancialHistory": { "title": "Include year-by-year financials", "type": "boolean", "description": "Include the full revenue and earnings series instead of just the latest year. Only companies that publish accounts have any figures at all.", "default": false }, "includeEvents": { "title": "Include register events", "type": "boolean", "description": "Add the dated register events North Data lists in the company's history: registration, name and legal form changes, capital, address moves, mergers and officer entries. It is the short list from the company page (12 entries at most in our tests), not the whole register file. Needs \"Open each company page\" on. Officer entries are left out when \"Include officers\" is off.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave this alone unless you need the run to go out through a particular network. Your own proxy servers are used exactly as given." } } }, "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 } } } } } } } } } }