{ "openapi": "3.0.1", "info": { "title": "Lead Enrichment API Multi-Provider B2B Data Enrichment", "description": "Enrich your leads w/company & contact data from 10+ enrichment providers. Perfect for sales prospecting, lead scoring, CRM enrichment, and account-based marketing. 10 Provider Integrations: Apollo, Clearbit, ZoomInfo, IPinfo, FullContact, Hunter, Lusha, Snov, RocketReach & People Data Labs", "version": "1.1", "x-build-id": "mYRbwaEvVtBu9PhoY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~lead-enricher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-lead-enricher", "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/alizarin_refrigerator-owner~lead-enricher/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-lead-enricher", "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/alizarin_refrigerator-owner~lead-enricher/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-lead-enricher", "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": { "demoMode": { "title": "Demo Mode (start here)", "type": "boolean", "description": "Leave this ON for your first run. It returns realistic sample enriched leads so you can see the output format with no API keys and no charges. Turn it OFF only when you have added at least one provider API key below and want to enrich your real leads.", "default": true }, "leads": { "title": "Leads to Enrich", "type": "array", "description": "The leads you want to enrich, one object per lead. Each lead needs at least an email or a company domain. Ignored while Demo Mode is on." }, "enrichmentProviders": { "title": "Enrichment Providers", "type": "array", "description": "Which data providers to try, in priority order. The actor tries them top to bottom and stops at the first one that returns data. You only need a key for the providers you list here, so most users pick one or two.", "items": { "type": "string", "enum": [ "apollo", "clearbit", "zoominfo", "ipinfo", "fullcontact", "hunter", "lusha", "snov", "rocketreach", "peopledatalabs" ] }, "default": [ "apollo", "clearbit", "fullcontact" ] }, "apolloApiKey": { "title": "Apollo.io API Key", "type": "string", "description": "Bring your own key. This actor uses YOUR provider accounts, so real enrichment needs at least one key from this section. Every key here is optional: add only the ones you have. Get an Apollo.io key at https://app.apollo.io/#/settings/integrations/api" }, "clearbitApiKey": { "title": "Clearbit API Key", "type": "string", "description": "Your Clearbit API key. Get one at https://dashboard.clearbit.com/api" }, "zoominfoApiKey": { "title": "ZoomInfo API Key", "type": "string", "description": "Your ZoomInfo API key. Contact ZoomInfo sales for access." }, "ipinfoToken": { "title": "IPinfo Token", "type": "string", "description": "Your IPinfo access token. Get one at https://ipinfo.io/account" }, "fullcontactApiKey": { "title": "FullContact API Key", "type": "string", "description": "Your FullContact API key. Get one at https://platform.fullcontact.com/" }, "hunterApiKey": { "title": "Hunter.io API Key", "type": "string", "description": "Your Hunter.io API key. Get one at https://hunter.io/api_keys" }, "lushaApiKey": { "title": "Lusha API Key", "type": "string", "description": "Your Lusha API key. Get one from your Lusha dashboard." }, "snovApiKey": { "title": "Snov.io API Key", "type": "string", "description": "Your Snov.io API key. Get one at https://app.snov.io/api" }, "snovUserId": { "title": "Snov.io User ID", "type": "string", "description": "Your Snov.io user ID (required with Snov.io API key)" }, "rocketreachApiKey": { "title": "RocketReach API Key", "type": "string", "description": "Your RocketReach API key. Get one at https://rocketreach.co/api" }, "peopledatalabsApiKey": { "title": "People Data Labs API Key", "type": "string", "description": "Your People Data Labs API key. Get one at https://www.peopledatalabs.com/" }, "enrichCompanyData": { "title": "Enrich Company Data", "type": "boolean", "description": "Fetch company information (industry, size, revenue, tech stack, etc.)", "default": true }, "enrichContactData": { "title": "Enrich Contact Data", "type": "boolean", "description": "Fetch contact information (job title, phone, social profiles, etc.)", "default": true }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to send results to when the actor finishes" } } }, "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 } } } } } } } } } }