{ "openapi": "3.0.1", "info": { "title": "Leads Finder", "description": "Meet Leads Finder—the lean, powerful alternative to ZoomInfo, Lusha, and Apollo. Get instant access to verified B2B emails, active LinkedIn profiles, and deep firmographic insights at scale. No bloated contracts, no wasted budget—just the clean, actionable leads you need to fuel your pipeline.", "version": "0.0", "x-build-id": "HuyZZfjL4e6c5xEB0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lisbuenas~leads-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lisbuenas-leads-finder", "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/lisbuenas~leads-finder/runs": { "post": { "operationId": "runs-sync-lisbuenas-leads-finder", "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/lisbuenas~leads-finder/run-sync": { "post": { "operationId": "run-sync-lisbuenas-leads-finder", "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": [ "search_terms" ], "properties": { "search_terms": { "title": "🔎 Search terms (what to find)", "type": "array", "description": "Business types / services to look for on Google Maps (e.g. \"marketing agency\", \"dentist\", \"law firm\"). Each term is combined with each location.", "items": { "type": "string" } }, "contact_location": { "title": "🌍 Location (Region / Country / State)", "type": "array", "description": "Where to search (e.g. \"United States\", \"California\", \"London, UK\"). To target a single city, leave this empty and use City instead.", "items": { "type": "string" } }, "contact_city": { "title": "🏙️ City", "type": "array", "description": "One or more cities. Used instead of Location when set, for city-level targeting.", "items": { "type": "string" } }, "company_keywords": { "title": "🔑 Extra keywords", "type": "array", "description": "Optional extra keywords appended to every search term to refine results.", "items": { "type": "string" } }, "fetch_count": { "title": "#️⃣ Number of leads to fetch", "minimum": 1, "type": "integer", "description": "Maximum number of business leads to collect across all searches. The free Apify plan effectively caps results per run.", "default": 100 }, "file_name": { "title": "📁 File name / Run label", "type": "string", "description": "Custom run label attached to every record of this run." }, "scrape_website_contacts": { "title": "✉️ Scrape emails & socials from each website", "type": "boolean", "description": "When enabled, the actor visits each business website (home + contact page) to extract emails and social profiles. Disable for a faster, Maps-only run.", "default": true }, "require_email": { "title": "📧 Only keep leads with an email", "type": "boolean", "description": "Skip businesses where no email could be found on the website. Requires \"Scrape emails & socials\" to be enabled.", "default": false }, "language_code": { "title": "🌐 Language", "type": "string", "description": "Google interface language (hl parameter), e.g. \"en\", \"pt-BR\".", "default": "en" }, "max_concurrency": { "title": "⚙️ Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages to scrape in parallel. Keep low (1-3) to reduce the chance of being blocked.", "default": 1 } } }, "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 } } } } } } } } } }