{ "openapi": "3.0.1", "info": { "title": "Waterfall Lead Finder | With Emails | $3 / 1k", "description": "Get a clean, deduped list of B2B contacts with verified emails and rich company context, sourced from multiple places. Filter by title, seniority, location, industry, headcount and more. It validates, enrich, removes duplicates and provide the export ready list.", "version": "0.12", "x-build-id": "fgRyKehSteuwfehrF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~waterfall-lead-finder-with-emails/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-waterfall-lead-finder-with-emails", "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/fatihtahta~waterfall-lead-finder-with-emails/runs": { "post": { "operationId": "runs-sync-fatihtahta-waterfall-lead-finder-with-emails", "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/fatihtahta~waterfall-lead-finder-with-emails/run-sync": { "post": { "operationId": "run-sync-fatihtahta-waterfall-lead-finder-with-emails", "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": { "companyNameOrUrlOrTicker": { "title": "Company (Name / Domain / Ticker)", "type": "string", "description": "Company name (e.g., “Databricks”), bare domain (e.g., tesla.com — no http/https), or stock ticker (e.g., AAPL)." }, "industries": { "title": "Industry Keywords (e.g., 'software', 'automobile')", "type": "array", "description": "Matches organization tags and/or names (e.g., “software”, “automobile”).", "items": { "type": "string" } }, "employeeRanges": { "title": "Number of Employees", "uniqueItems": true, "type": "array", "description": "Company headcount buckets.", "items": { "type": "string", "enum": [ "1,10", "11,50", "51,200", "201,500", "501,1000", "1001,5000", "5001,10000", "10001,50000", "50001,100000", "100001,999999" ], "enumTitles": [ "1–10", "11–50", "51–200", "201–500", "501–1,000", "1,001–5,000", "5,001–10,000", "10,001–50,000", "50,001–100,000", "100,001+" ] } }, "organizationDomains": { "title": "Organization Domains (plain)", "type": "array", "description": "Enter plain company domains only (no http/https, no www). Example: “acme.com”.", "items": { "type": "string" } }, "companyTypes": { "title": "Organization Types", "uniqueItems": true, "type": "array", "description": "Filter by company ownership type.", "items": { "type": "string", "enum": [ "PRIVATE", "PUBLIC", "NONPROFIT", "GOVERNMENT", "EDUCATIONAL" ], "enumTitles": [ "Private", "Public", "Nonprofit", "Government", "Educational" ] } }, "revenueMin": { "title": "Revenue Min (USD)", "type": "integer", "description": "Minimum annual revenue (USD)." }, "revenueMax": { "title": "Revenue Max (USD)", "type": "integer", "description": "Maximum annual revenue (USD)." }, "contactNameOrEmail": { "title": "Contact (Name or Email)", "type": "string", "description": "Full name (e.g., “Ada Lovelace”) or an email (e.g., ada@acme.com)." }, "personTitles": { "title": "Person Titles", "uniqueItems": true, "type": "array", "description": "Exact job titles to include (e.g., “Head of Marketing”, “Staff Engineer”).", "items": { "type": "string" } }, "organizationLocations": { "title": "Company HQ Locations", "type": "array", "description": "Company headquarters locations (city, state, or country).", "items": { "type": "string" } }, "maxResults": { "title": "Maximum Contacts", "minimum": 100, "type": "integer", "description": "The maximum number of contacts to scrape.", "default": 50000 }, "getEmails": { "title": "Get Emails", "type": "boolean", "description": "When enabled, enrich contacts to reveal verified emails where possible.", "default": true }, "includeRiskyEmails": { "title": "Include “risky” emails", "type": "boolean", "description": "When enabled, enrich contacts to reveal verified emails where possible.", "default": true } } }, "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 } } } } } } } } } }