{ "openapi": "3.0.1", "info": { "title": "Firmfold — Company Enrichment API: Domain to Tech & Contacts", "description": "Get a full company profile from a domain, work email or company name: logo, tech stack, email security, domain age, contacts, socials, hiring and firmographics (founded, employees, HQ). B2B company data enrichment API, Clearbit alternative. $0.01 per company; misses free.", "version": "0.1", "x-build-id": "bIakC528UfsSPxSgC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cybermax~company-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cybermax-company-enrichment", "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/cybermax~company-enrichment/runs": { "post": { "operationId": "runs-sync-cybermax-company-enrichment", "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/cybermax~company-enrichment/run-sync": { "post": { "operationId": "run-sync-cybermax-company-enrichment", "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": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "One company per line: a domain (stripe.com), a website URL, a work email (jane@acme.com) or a company name (\"Acme Brick Company\", \"Monzo Bank | gb\" with an optional country). Names are turned into the official domain first (Namewhere). Personal email providers (gmail.com…) are skipped free.", "items": { "type": "string" } }, "modules": { "title": "What to include", "type": "array", "description": "Leave empty for everything. The domain check, tech stack, email security and domain age always run (they decide whether the company exists).", "items": { "type": "string", "enum": [ "logo", "tech", "contacts", "hiring", "firmographics" ], "enumTitles": [ "Logo, icon & brand colour (Logolark)", "Tech stack, email security, domain age (DomainDNA)", "Emails, phones, socials, address (Hollerdex)", "Open jobs & hiring activity (HireHeat)", "Founded, employees, HQ, industry, ticker (Wikidata)" ] }, "default": [ "logo", "tech", "contacts", "hiring", "firmographics" ] }, "country": { "title": "Default country for names (ISO code)", "type": "string", "description": "Optional, e.g. \"us\", \"gb\", \"de\". Helps turn ambiguous company names into the right domain." }, "monitor": { "title": "Monitor mode (only changed companies)", "type": "boolean", "description": "For scheduled CRM refreshes: return (and charge for) only companies that are new or whose profile changed since the last run with the same list, with changedModules saying what changed (new tech, new contacts, rebrand, hiring jump…). Unchanged companies are free.", "default": false }, "monitorKey": { "title": "Watchlist name (monitor mode)", "type": "string", "description": "Optional. Name your watchlist to keep its state when you edit the list." }, "includePersonalEmails": { "title": "Include named people's emails", "type": "boolean", "description": "Off by default: only role addresses (sales@, support@, press@…). Turn on to also return personal addresses the company itself publishes on its site.", "default": false }, "minDomainConfidence": { "title": "Minimum confidence for name → domain", "minimum": 0, "maximum": 0.99, "type": "number", "description": "Only used for company names. Below it the name is returned free as domain-not-found with its best guess.", "default": 0.6 }, "maxConcurrency": { "title": "Companies in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "5 is safe at 1 GB memory; raise memory with it.", "default": 5 }, "timeoutSecs": { "title": "Time budget per module (seconds)", "minimum": 5, "maximum": 90, "type": "integer", "description": "A slow part is cut off and reported in errors; the rest of the profile is still returned.", "default": 20 }, "maxContactPages": { "title": "Contact pages per site", "minimum": 1, "maximum": 8, "type": "integer", "description": "Homepage plus likely contact/about/imprint pages read for emails, phones and address.", "default": 4 }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Optional Apify Proxy for the contact pages of sites that block data-centre IPs. Off by default.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }