{ "openapi": "3.0.1", "info": { "title": "B2B Lead Enrichment Free", "description": "Turn a simple list of company domains into rich, actionable company profiles.\nUpload a CSV with company domains, and get back firmographic data, technology stacks, contact emails, social links, and industry classification. No paid API keys required. Everything runs on publicly available data.", "version": "1.0", "x-build-id": "z2FtzpEKGRReF0LLU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/teodor_banea~b2b-lead-enrichment-free/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-teodor_banea-b2b-lead-enrichment-free", "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/teodor_banea~b2b-lead-enrichment-free/runs": { "post": { "operationId": "runs-sync-teodor_banea-b2b-lead-enrichment-free", "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/teodor_banea~b2b-lead-enrichment-free/run-sync": { "post": { "operationId": "run-sync-teodor_banea-b2b-lead-enrichment-free", "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": { "inputCsvSource": { "title": "Input CSV source", "enum": [ "paste", "url", "keyValueStore" ], "type": "string", "description": "Where to read the input CSV from. 'Paste CSV' lets you paste content directly. 'Public URL' downloads from a URL. 'Key-Value Store' reads from the run's default store.", "default": "paste" }, "inputCsvContent": { "title": "CSV content", "type": "string", "description": "Paste your CSV content here. Must have a header row with at least a 'domain' column." }, "inputCsvUrl": { "title": "CSV URL", "type": "string", "description": "Public URL of the input CSV file. Used when Input CSV source is set to 'Public URL'." }, "inputCsvKey": { "title": "Key-value store key", "type": "string", "description": "Key in the default key-value store where the CSV is stored.", "default": "INPUT.csv" }, "columnMapping": { "title": "Column mapping", "type": "object", "description": "Map your CSV column headers to logical fields. Leave empty for auto-detection (looks for common names like 'domain', 'company', 'email')." }, "csvDelimiter": { "title": "CSV delimiter", "enum": [ ",", ";", "\t" ], "type": "string", "description": "Character used to separate columns in your CSV.", "default": "," }, "enableFirmographics": { "title": "Enable firmographic enrichment", "type": "boolean", "description": "Enrich company data: name, description, location, founding year, and more.", "default": true }, "enableContacts": { "title": "Enable contact enrichment", "type": "boolean", "description": "Find contact emails from company websites and generate email pattern candidates.", "default": true }, "enableTechnographics": { "title": "Enable technographic enrichment", "type": "boolean", "description": "Detect the technology stack from website headers, scripts, DNS records, and GitHub repos.", "default": true }, "googleKgApiKey": { "title": "Google Knowledge Graph API key", "type": "string", "description": "Optional. Free API key (100,000 requests/day) for richer company descriptions. Get one at console.cloud.google.com → APIs & Services → Knowledge Graph Search API." }, "githubToken": { "title": "GitHub personal access token", "type": "string", "description": "Optional. Free token increases GitHub rate limit from 60 to 5,000 requests/hour. Create one at github.com/settings/tokens." }, "enableGoogleKg": { "title": "Enable Google Knowledge Graph", "type": "boolean", "description": "Use Google Knowledge Graph for company descriptions and industry data. Requires an API key above.", "default": true }, "enableGithub": { "title": "Enable GitHub lookup", "type": "boolean", "description": "Look up company GitHub organizations for tech stack and company info. Disable to avoid rate limit issues.", "default": true }, "websiteScraperMaxPages": { "title": "Pages per company", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum number of pages to scrape per company website (homepage + about + contact).", "default": 3 }, "websiteScraperTimeoutSecs": { "title": "Page timeout", "minimum": 3, "maximum": 30, "type": "integer", "description": "Maximum time to wait for each page to load.", "default": 10 }, "maxRows": { "title": "Maximum companies to process", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Limit the number of companies to enrich. Set to 0 for unlimited (capped at 5,000 for safety).", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of companies to enrich in parallel. Higher values are faster but use more bandwidth.", "default": 3 }, "providerTimeoutSecs": { "title": "Provider timeout", "minimum": 5, "maximum": 60, "type": "integer", "description": "Maximum time to wait for each data source before skipping it.", "default": 15 }, "maxContactsPerCompany": { "title": "Max contacts per company", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of contacts to return for each company.", "default": 5 }, "includeRawResponses": { "title": "Include raw responses", "type": "boolean", "description": "Attach raw data from each provider to the output. Useful for debugging but increases output size.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies for website scraping. Recommended for production runs — company websites may block datacenter IPs.", "default": { "useApifyProxy": true } }, "enableWebsiteScraper": { "title": "Enable website scraper", "type": "boolean", "description": "Scrape company websites for firmographic data, contacts, and tech stack.", "default": true }, "enableDnsMx": { "title": "Enable DNS/MX analysis", "type": "boolean", "description": "Analyze DNS records to detect email providers and marketing tools.", "default": true }, "enableSslCert": { "title": "Enable SSL certificate analysis", "type": "boolean", "description": "Read SSL certificates for company legal name and location.", "default": true }, "enableEmailPattern": { "title": "Enable email pattern generator", "type": "boolean", "description": "Generate candidate email addresses from person names and company domains.", "default": true }, "firmographicProviderOrder": { "title": "Firmographic provider order", "type": "array", "description": "Order in which providers are queried for firmographic data.", "items": { "type": "string" }, "default": [ "website-scraper", "google-kg", "ssl-cert" ] }, "contactProviderOrder": { "title": "Contact provider order", "type": "array", "description": "Order in which providers are queried for contact data.", "items": { "type": "string" }, "default": [ "website-scraper", "email-pattern" ] }, "technographicProviderOrder": { "title": "Technographic provider order", "type": "array", "description": "Order in which providers are queried for technology stack data.", "items": { "type": "string" }, "default": [ "website-scraper", "dns-mx", "github" ] } } }, "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 } } } } } } } } } }