{ "openapi": "3.0.1", "info": { "title": "New Business Registrations: Fresh Company Leads", "description": "Newly registered companies from official open registers (Connecticut, Colorado, Norway, Finland) in one normalized format. Daily \"only new\" mode and filters by industry, place and keyword.", "version": "1.0", "x-build-id": "nGhYOT2mV7Zar5l9M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/italy~new-business-registrations/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-italy-new-business-registrations", "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/italy~new-business-registrations/runs": { "post": { "operationId": "runs-sync-italy-new-business-registrations", "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/italy~new-business-registrations/run-sync": { "post": { "operationId": "run-sync-italy-new-business-registrations", "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", "required": [ "sources" ], "properties": { "sources": { "title": "Registers", "type": "array", "description": "Which official registers to read. Connecticut gives the best leads: nearly every record has an email (free-mail addresses are dropped by default, see below) and an industry code. Colorado has an address only. Norway and Finland have contact details for a small share of companies.", "items": { "type": "string", "enum": [ "US-CT", "US-CO", "NO", "FI" ], "enumTitles": [ "United States: Connecticut", "United States: Colorado", "Norway (Brønnøysund)", "Finland (PRH)" ] }, "default": [ "US-CT" ] }, "daysBack": { "title": "Days back", "minimum": 0, "maximum": 366, "type": "integer", "description": "Companies registered in the last N days (including today). Ignored when you fill in both dates below.", "default": 7 }, "dateFrom": { "title": "From date (optional)", "type": "string", "description": "First registration date, YYYY-MM-DD. Overrides \"Days back\"." }, "dateTo": { "title": "To date (optional)", "type": "string", "description": "Last registration date, YYYY-MM-DD. Default: today. At most 366 days between the two dates." }, "legalForms": { "title": "Legal forms (optional)", "type": "array", "description": "Which kinds of entity to return. Default (empty or untouched): companies (LLC, corporation, partnership, cooperative, branch). Add non-profits or housing companies if you want them. Clear all to get everything.", "items": { "type": "string", "enum": [ "llc", "corporation", "partnership", "cooperative", "branch", "nonprofit", "housing", "other" ], "enumTitles": [ "LLC / limited liability", "Corporation / limited company", "Partnership", "Cooperative", "Branch of a foreign company", "Non-profit / association / foundation", "Housing company", "Other" ] } }, "includeInactive": { "title": "Include inactive records", "type": "boolean", "description": "Also return rejected, dissolved or bankrupt registrations. Off by default.", "default": false }, "onlyDomestic": { "title": "Only domestic companies", "type": "boolean", "description": "Skip branches and companies formed in another state or country.", "default": false }, "requireContact": { "title": "Require contact details", "enum": [ "none", "email", "any" ], "type": "string", "description": "Only return companies where the register has an email (email), or an email, phone or website (any).", "default": "none" }, "naicsPrefixes": { "title": "Industry filter: NAICS prefixes (US)", "type": "array", "description": "Only US records whose NAICS code starts with one of these, e.g. 238 (specialty contractors), 5413 (architecture), 722 (food service). Applies to Connecticut only (Colorado has no industry).", "items": { "type": "string" } }, "naceCodePrefixes": { "title": "Industry filter: NACE prefixes (Norway, Finland)", "type": "array", "description": "Only Norwegian and Finnish records whose NACE code starts with one of these, e.g. 41 (construction), 62 (software), 56 (restaurants).", "items": { "type": "string" } }, "postalCodePrefixes": { "title": "Postal code prefixes (optional)", "type": "array", "description": "Only companies whose postal code starts with one of these, e.g. 068 or 0150.", "items": { "type": "string" } }, "place": { "title": "Place (optional)", "type": "string", "description": "Only companies whose city, region or street contains this text (accents ignored), e.g. Stamford, Oslo, Espoo." }, "keywords": { "title": "Keywords (optional)", "type": "array", "description": "Only companies where the name, business purpose or industry contains one of these words, e.g. roofing, bakery, software.", "items": { "type": "string" } }, "includeContactDetails": { "title": "Include email, phone and website", "type": "boolean", "description": "Turn off to get company data only (flags such as hasEmail stay). Useful if you do not want to process contact data.", "default": true }, "businessEmailsOnly": { "title": "Business emails only (skip Gmail, Outlook, etc.)", "type": "boolean", "description": "Drops email addresses at free-mail providers (Gmail, Outlook, Yahoo, ...). Those are often private addresses of the owner, which are personal data and are treated more strictly by privacy and marketing law. On by default; the company stays in the result, just without that email. Switch off only if you have a lawful basis for processing such addresses.", "default": true }, "onlyNew": { "title": "Only companies I have not received before", "type": "boolean", "description": "Remembers delivered companies between runs (per tracking name) and returns only new ones. Ideal for a daily scheduled run: you only pay for fresh companies. The first run returns everything in the period.", "default": false }, "trackingName": { "title": "Tracking name", "type": "string", "description": "Name of this lead list. Use a different name per scheduled task with different filters, so their memory does not mix. Letters, numbers and dashes.", "default": "default" }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops after this many companies. Protects you from unexpected cost.", "default": 100 }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Free token from Socrata/Tyler for higher rate limits on the Connecticut and Colorado portals. Usually not needed." }, "apiBases": { "title": "API base URLs (advanced, for testing)", "type": "object", "description": "Override the register URLs. Leave empty.", "default": {} } } }, "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 } } } } } } } } } }