{ "openapi": "3.0.1", "info": { "title": "Global Ai B2b Lead Enrichment Actor", "description": "Find, crawl, enrich, score, and prepare outreach for B2B sales leads.\n\nThis Actor is built for agencies, consultants, lead brokers, SEO teams, web design businesses, and SaaS outbound teams that need more than raw scraped URLs.", "version": "0.0", "x-build-id": "NiwJPDlhI9VSBS3m9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/josiah_essau~global-ai-b2b-lead-enrichment-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-josiah_essau-global-ai-b2b-lead-enrichment-actor", "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/josiah_essau~global-ai-b2b-lead-enrichment-actor/runs": { "post": { "operationId": "runs-sync-josiah_essau-global-ai-b2b-lead-enrichment-actor", "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/josiah_essau~global-ai-b2b-lead-enrichment-actor/run-sync": { "post": { "operationId": "run-sync-josiah_essau-global-ai-b2b-lead-enrichment-actor", "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": { "startUrls": { "title": "Company website URLs", "type": "array", "description": "Optional list of public company websites to crawl and enrich.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "manualLeads": { "title": "Manual leads", "type": "array", "description": "Optional JSON array of known leads. Each object can include businessName, website, category, city, country, phone, email, and notes.", "default": [] }, "discoveryProvider": { "title": "Discovery provider", "enum": [ "none", "serpapi", "googleCustomSearch", "bing" ], "type": "string", "description": "Optional search provider for finding company websites from queries.", "default": "none" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Optional list of search queries. If empty and a discovery provider is selected, queries are generated from countries and niches.", "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Countries used to generate search queries.", "items": { "type": "string", "enumSuggestedValues": [ "United States", "United Kingdom", "Canada", "Australia", "Germany", "United Arab Emirates", "South Africa", "Kenya", "Tanzania" ] }, "default": [ "United States", "United Kingdom", "Canada", "Australia" ] }, "niches": { "title": "High-value niches", "type": "array", "description": "Business niches to target and score highly.", "items": { "type": "string", "enumSuggestedValues": [ "dentists", "law firms", "roofing companies", "real estate agents", "clinics", "solar installers", "restaurants", "salons", "hotels", "SaaS companies" ] }, "default": [ "dentists", "law firms", "roofing companies", "real estate agents", "clinics" ] }, "maxSearchResultsPerQuery": { "title": "Max search results per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum URLs fetched per search query.", "default": 10 }, "maxResults": { "title": "Max output leads", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum final leads pushed to dataset.", "default": 100 }, "maxPagesPerWebsite": { "title": "Max pages per website", "minimum": 1, "maximum": 25, "type": "integer", "description": "Same-host pages to crawl for each website.", "default": 3 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum parallel crawling requests.", "default": 10 }, "includePersonalEmails": { "title": "Include personal-looking emails", "type": "boolean", "description": "When false, prefer generic business emails such as info@, sales@, hello@, contact@.", "default": false }, "outreachLanguage": { "title": "Outreach language", "enum": [ "English", "Swahili", "Spanish", "French", "German" ], "type": "string", "description": "Language used for outreach messages.", "default": "English" }, "outreachTone": { "title": "Outreach tone", "enum": [ "direct", "friendly", "consultative", "premium" ], "type": "string", "description": "Tone used for generated outreach copy.", "default": "consultative" }, "serpApiKey": { "title": "SerpApi key", "type": "string", "description": "Secret SerpApi API key." }, "googleApiKey": { "title": "Google API key", "type": "string", "description": "Secret Google Custom Search JSON API key." }, "googleCx": { "title": "Google Custom Search CX", "type": "string", "description": "Google Custom Search engine ID." }, "bingApiKey": { "title": "Bing Web Search API key", "type": "string", "description": "Secret Bing Web Search API key." }, "excludeDomains": { "title": "Exclude domains", "type": "array", "description": "Domains to exclude from discovery results.", "default": [ "facebook.com", "instagram.com", "linkedin.com", "youtube.com", "twitter.com", "x.com", "tiktok.com", "yelp.com", "tripadvisor.com", "yellowpages.com" ] }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy configuration for crawling.", "default": { "useApifyProxy": false } }, "debug": { "title": "Debug output", "type": "boolean", "description": "Include extraction evidence and diagnostics in each dataset item.", "default": 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 } } }, "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 } } } } } } } } } }