{ "openapi": "3.0.1", "info": { "title": "North Data Scraper - European Company Registry", "description": "Revenue is on a North Data page only where the company publishes accounts. The register fields are always there: registered name, legal form, register court and HRB number, EUID, LEI, address, status, industry, officers with roles. 26 countries, no account. $2.55 per 1,000.", "version": "0.1", "x-build-id": "LJlDkhWPbKmRUfhhY" }, "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 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The actor already uses its own egress; leave this alone unless you need to exit from a specific network." } } }, "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 } } } } } } } } } }