{ "openapi": "3.0.1", "info": { "title": "Canada New Incorporations — Company Leads + Directors", "description": "Daily feed of newly incorporated Canadian federal companies — name, business number, incorporation date, province, status. Optional director enrichment (names + addresses) turns each company into a contactable lead. Fresh B2B leads — JSON/CSV, ready for Clay, Make, n8n.", "version": "0.2", "x-build-id": "cmUxsRquqC7m17Fzd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truenorthdata~canada-new-incorporations/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truenorthdata-canada-new-incorporations", "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/truenorthdata~canada-new-incorporations/runs": { "post": { "operationId": "runs-sync-truenorthdata-canada-new-incorporations", "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/truenorthdata~canada-new-incorporations/run-sync": { "post": { "operationId": "run-sync-truenorthdata-canada-new-incorporations", "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": { "incorporatedWithinDays": { "title": "Incorporated within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Return only corporations incorporated in the last N days. WARNING: 0 does NOT mean 'no date filter applied' — it returns every active federal corporation ever registered (hundreds of thousands of records, a long and expensive run). For a fresh-lead feed use 1-30. For windows of 1-60 days the Actor also probes the live registry to catch companies incorporated in the last ~1-2 weeks that are not yet in the daily bulk file.", "default": 30 }, "freshFrontier": { "title": "Include just-incorporated (live registry probe)", "type": "boolean", "description": "Ignored unless 'Incorporated within (days)' is between 1 and 60 — outside that range this setting has no effect at all. When it does apply: the daily bulk file lags real incorporations by ~1-2 weeks, so the Actor probes the official live registry forward from the newest bulk record to add companies incorporated in the last few days, with their true incorporation date. Adds two to three minutes to the run, which can exceed the wait limit of some callers.", "default": true }, "provinces": { "title": "Provinces / territories", "uniqueItems": true, "type": "array", "description": "Two-letter codes of the registered office to include. Leave empty for all of Canada. Only the thirteen official codes are accepted; any other value is rejected rather than silently returning nothing.", "items": { "type": "string", "enum": [ "AB", "BC", "MB", "NB", "NL", "NS", "NT", "NU", "ON", "PE", "QC", "SK", "YT" ], "enumTitles": [ "Alberta", "British Columbia", "Manitoba", "New Brunswick", "Newfoundland and Labrador", "Nova Scotia", "Northwest Territories", "Nunavut", "Ontario", "Prince Edward Island", "Quebec", "Saskatchewan", "Yukon" ] } }, "keywords": { "title": "Keywords", "uniqueItems": true, "type": "array", "description": "Optional free-text filter on corporate name or city. Matches ANY keyword, not all of them (OR, not AND), and is case-insensitive. Example: ['consulting', 'holdings', 'Toronto'] returns records matching any one of the three. Leave empty to apply no name or city filter.", "items": { "type": "string" } }, "includeOtherTypes": { "title": "Include non-profits, co-ops, boards of trade", "type": "boolean", "description": "Also include 'other' active federal corporations (not-for-profit, cooperatives, boards of trade) in addition to business corporations. Off by default, so results are business corporations only.", "default": false }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "Incremental mode: return only corporations (by corporation number) not seen in previous runs of this Actor. Intended for a scheduled daily feed. Note that on a first run there is no history, so nothing is filtered out.", "default": false }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many corporations. This is the cost guard. WARNING: 0 does NOT mean 'no cap needed' — it means unlimited, and the run will return every matching record. Leave at 500 unless you have a reason.", "default": 500 }, "enrichDirectors": { "title": "Enrich with directors (names + addresses)", "type": "boolean", "description": "Requires 'Federal Corporation API key' to be set — turning this on without a key aborts the run with an explicit error rather than returning companies with no directors. Looks up each returned corporation in the official Corporations Canada API and attaches its directors (names and service addresses), turning a company into a contactable lead. The API is rate-limited to ~55 lookups per minute, so pair it with a small window, for example incorporatedWithinDays between 1 and 7.", "default": false }, "federalApiKey": { "title": "Federal Corporation API key", "type": "string", "description": "SECRET — do not guess, invent or construct this value, and do not ask for it to be pasted into a chat. It is a free 'user-key' obtained by the account owner from the ISED API catalogue (api.ised-isde.canada.ca, subscribe to the Federal Corporation API 'Public Plan') and is normally supplied out of band via the FEDERAL_API_KEY environment variable. Needed only when 'Enrich with directors' is on; leave empty otherwise." }, "maxEnrich": { "title": "Max director lookups", "minimum": 0, "type": "integer", "description": "Safety cap on how many corporations get a director API lookup per run. Each lookup is one throttled API call, so this bounds how long enrichment takes. Has no effect unless 'Enrich with directors' is on.", "default": 300 } } }, "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 } } } } } } } } } }