{
  "openapi": "3.0.1",
  "info": {
    "title": "Bulk Website Contact Extractor & Email Finder",
    "description": "Extract public business website contacts for CRM enrichment. Review HubSpot company CSV updates before import. Export emails, phones, social links and CRM import files. Optional website email MX checks report domain mail routing. Pay per useful website and qualifying optional events.",
    "version": "1.10",
    "x-build-id": "or2y6hOyuy07JFi4U"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/harvestlab~contact-extractor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-harvestlab-contact-extractor",
        "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/harvestlab~contact-extractor/runs": {
      "post": {
        "operationId": "runs-sync-harvestlab-contact-extractor",
        "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/harvestlab~contact-extractor/run-sync": {
      "post": {
        "operationId": "run-sync-harvestlab-contact-extractor",
        "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": {
          "urls": {
            "title": "Company website or contact-page URLs",
            "type": "array",
            "description": "Full public website URLs to analyze. Start with the prefilled contact page, then replace it with your own URLs. Clear this sample before using Domains instead.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs (alias for Website URLs)",
            "type": "array",
            "description": "Alternative field name for Website URLs, provided for compatibility with Apify's common 'startUrls' convention (e.g. https://example.com). The canonical field is `urls` above - prefer that. If both are supplied, they are merged.",
            "items": {
              "type": "string"
            }
          },
          "url": {
            "title": "URL (CLI alias)",
            "type": "string",
            "description": "CLI alias for a single website URL. Hidden from Console form."
          },
          "website": {
            "title": "Website (CLI alias)",
            "type": "string",
            "description": "CLI alias for a single website URL. Hidden from Console form."
          },
          "domains": {
            "title": "Company website domains",
            "type": "array",
            "description": "Domains without protocol (e.g. example.com). HTTPS is added automatically. Clear the sample in Website URLs before using this alternative; when both fields are supplied, URLs are processed first and duplicate domains are merged.",
            "items": {
              "type": "string"
            }
          },
          "sourceWebsiteDataset": {
            "title": "Source dataset of websites (read only)",
            "type": "string",
            "description": "Select one completed dataset you are authorized to read. The Actor reads only website, skips missing values and keeps the first URL per domain. Clear every URL and domain input first. Up to 1,000 rows and maxWebsites unique sites. Use URLs up to 2,048 characters without queries or fragments. Invalid or oversized cohorts stop before crawling."
          },
          "maxWebsites": {
            "title": "Website Limit per Run",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "The Console starter sets this limit to 1. For your own website list, set it to the number of distinct sites you intend to process, up to 200. The Actor deduplicates website inputs and processes only the first sites within this limit. API inputs that omit this field use 50.",
            "default": 50
          },
          "maxPagesPerSite": {
            "title": "Max Pages Per Site",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum number of pages to crawl per website. Higher values find more contacts but take longer.",
            "default": 5
          },
          "includeSubpages": {
            "title": "Include Subpages",
            "type": "boolean",
            "description": "Automatically crawl /contact, /about, /imprint, and similar pages to find additional contact information.",
            "default": true
          },
          "detectTechStack": {
            "title": "Detect Tech Stack",
            "type": "boolean",
            "description": "Detect CMS, frameworks, analytics, and other public technology signals. Confidently detected Shopify stores can also return public store name, canonical URL, currency, and business country when available from pages already fetched. This uses enriched-mode pricing: $0.01 per useful website instead of $0.0015 basic discovery.",
            "default": false
          },
          "validatePhones": {
            "title": "Validate and Format Phones",
            "type": "boolean",
            "description": "The Console starter switches this off for raw phones only, with no phone-validation charge. If omitted from API input, this defaults true for compatibility: format-valid phones are normalized to E.164 with country and line type at $0.02 per number, in addition to the base website event. This is not a reachability or carrier check.",
            "default": true
          },
          "verifyEmails": {
            "title": "Verify Email Deliverability (MX-record check)",
            "type": "boolean",
            "description": "Check domain MX records, flag typos/disposable inboxes, and tag emails HIGH / MEDIUM / LOW / UNKNOWN. Adds emails_verified. Cost: $0.01 only for HIGH/MEDIUM emails with valid MX and no disposable/typo flag; LOW/UNKNOWN are free. MX resolution does not prove that a mailbox exists. Enables $0.01 enriched base pricing per useful website.",
            "default": false
          },
          "maxEmailsToVerify": {
            "title": "Max Emails To Verify Per Run",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Bill-safety cap for MX and SMTP email verification across the whole run. Raw extracted emails are still returned; only verification is capped. Default 50, maximum 500.",
            "default": 50
          },
          "deepEmailVerification": {
            "title": "Deep SMTP Probe - Real Mailbox Verification (v1.7)",
            "type": "boolean",
            "description": "Opt-in: run an async SMTP RCPT TO probe against the primary MX host for every MX-cleared email. Classifies each email as deliverable / undeliverable / catchall / greylisted / port_blocked. Reputation-safe: per-MX-host probe history persists across runs (named KV store), capped at 10 probes/host/day with 10s cooldown between probes to the same host. Port 25 is frequently blocked on Apify datacenter egress; when it is, every entry returns `port_blocked` (free). Cost: $0.02 per email that receives a definitive verdict (deliverable or undeliverable) - catch-all, greylisted, and non-verdict results are free. Requires `verifyEmails: true`.",
            "default": false
          },
          "exportCrm": {
            "title": "Export company and contact CSV files for CRM import",
            "type": "boolean",
            "description": "Save deduplicated company and selected-contact CSV files plus merge-ready JSON in this run's key-value store. At most one selected email per website observation; no extra Actor event, CRM login, or destination write. Files exclude diagnostics and failed email checks. CSV export adds only normal storage usage.",
            "default": false
          },
          "crmRequireMx": {
            "title": "Export Only MX-Qualified Emails",
            "type": "boolean",
            "description": "Filter CRM contacts to existing HIGH/MEDIUM email checks with valid MX and no typo/disposable flag. This filter does not enable paid verification. With Verify Email Deliverability off, unchecked emails are excluded and the contacts CSV can be empty. MX does not prove mailbox existence.",
            "default": false
          },
          "crmMxReservePerSite": {
            "title": "Reserve One MX Attempt per Website",
            "type": "boolean",
            "description": "Spread the existing check budget across the website list before spending it on extra addresses. Requires CRM export, MX-qualified contacts, MX checks on, and deep SMTP off. The budget may run out and an attempted check may be unavailable or unqualified.",
            "default": false
          },
          "enableAiAnalysis": {
            "title": "Enable AI Contact Enrichment",
            "type": "boolean",
            "description": "Use an LLM to classify each email by role (sales/support/hr/legal/executive/general/personal), group near-duplicate team addresses, flag non-monitored no-reply inboxes, and pick the single best primary contact for B2B outreach. When `verifyEmails` is also enabled, the AI picks the primary contact only from HIGH/MEDIUM deliverability emails. Hosted providers require your own API key; self-hosted Ollama needs no API key. Cost: $0.05 per website analyzed.",
            "default": false
          },
          "llmProvider": {
            "title": "LLM Provider",
            "enum": [
              "openrouter",
              "anthropic",
              "google",
              "openai",
              "ollama"
            ],
            "type": "string",
            "description": "Choose the provider for email role classification, deduplication, and primary-contact selection. Hosted providers require your own API key; provider token charges are separate from the Actor AI event and depend on model and usage. Self-hosted Ollama needs no API key.",
            "default": "openrouter"
          },
          "llmModel": {
            "title": "LLM Model",
            "type": "string",
            "description": "Specific model to use. Leave empty for the provider default (google/gemini-3.8-flash for OpenRouter, claude-sonnet-5-5 for Anthropic, gemini-3.8-flash for Google AI, gpt-4o-mini for OpenAI, llama3.1 for Ollama)."
          },
          "openrouterApiKey": {
            "title": "OpenRouter API Key",
            "type": "string",
            "description": "Your OpenRouter API key. Get one at openrouter.ai/keys"
          },
          "anthropicApiKey": {
            "title": "Anthropic API Key",
            "type": "string",
            "description": "Your Anthropic API key. Get one at console.anthropic.com"
          },
          "googleApiKey": {
            "title": "Google AI API Key",
            "type": "string",
            "description": "API key for Google AI (Gemini). Get one at aistudio.google.com/app/apikey"
          },
          "openaiApiKey": {
            "title": "OpenAI API Key",
            "type": "string",
            "description": "API key from platform.openai.com (required if using OpenAI provider)"
          },
          "ollamaBaseUrl": {
            "title": "Ollama Base URL",
            "type": "string",
            "description": "Base URL for Ollama API. Default: http://localhost:11434"
          },
          "outputConnectors": {
            "title": "MCP Output Connectors",
            "maxItems": 5,
            "uniqueItems": true,
            "type": "array",
            "description": "Optional MCP connectors for contact extraction summaries. Choose Slack, Notion, GitHub, Sheets, CRM, or another compatible connector. At the end of the run, the actor sends a compact contact summary plus structured payload through each connector. Connector failures never fail the scrape. Billed at $0.002 per successful connector dispatch."
          },
          "connectorAlertTarget": {
            "title": "Connector Target",
            "type": "string",
            "description": "Optional connector destination such as a Slack channel, Notion database ID, sheet name, table, or CRM list. Leave empty when the selected connector already has a default target."
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Proxy settings. Automatic Apify Proxy selection is the compatible default. Choose residential proxy for websites that block datacenter traffic."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}