# Website Contact Scraper — Email, Phone & Social Finder (`blackfalcondata/website-contact-scraper`) Actor

Turn any list of websites into outreach-ready contacts: emails, phones, social profiles, structured company data (legal name, address, VAT) and named people. Optional email verification flags deliverability, role, disposable and free addresses. CRM-ready JSON.

- **URL**: https://apify.com/blackfalcondata/website-contact-scraper.md
- **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 website scanneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

### What does Website Contact Scraper do?

Website Contact Scraper turns a list of website URLs into outreach-ready contact records. Results include emails, phone numbers, and social profiles pulled from every crawled page, plus structured company data (legal name, address, VAT ID) from JSON-LD. Optional email verification adds a deliverability confidence score and role, disposable, and free-provider flags.

### How to use this actor

- 👉 **Register for a free Apify account** — no credit card required.
- 🎉 Just click **[Sign up free on Apify →](https://console.apify.com/sign-up?fpr=1h3gvi&fp_sid=ctarich)** and complete a quick signup.
- 💰 A free Apify account includes $5 in monthly credits — enough to test this actor.
- ⏳ Scrape during the free trial, with no commitment or upfront payment required.

### Key features

<!-- KEY_FEATURES:START -->
- **📧 Email + phone extraction** — extract public emails and phone numbers from every page crawled — from `mailto:` / `tel:` links and visible text, with obfuscation (name [at] domain [dot] com) decoded and tracking / system addresses filtered out. Optionally verify each email (MX and SMTP checks) with a confidence score plus role, disposable and free-provider flags.
- **🔗 URL + social-profile extraction** — capture social profiles across 11 platforms — LinkedIn, X/Twitter, Facebook, Instagram, YouTube, TikTok, GitHub, Xing, Bluesky, Threads and Mastodon.
- **🏢 Company data from JSON-LD** — harvest structured company data from JSON-LD / schema.org that most scrapers ignore — legal name, postal address, VAT / registration ID, founding date and opening hours — and, optionally, named people (name, title, personal LinkedIn) from team and about pages. One outreach-ready row per website, with the best email and phone ranked first.
- **🔔 Notifications** — Telegram, Slack, Discord, WhatsApp Cloud API, and generic webhook out of the box. Pair with incremental for daily new-listing alerts without pipeline glue.
- **📦 Compact mode** — AI-agent and MCP-friendly payloads with core fields only.
<!-- KEY_FEATURES:END -->

### What data can you get for each website?

Each result includes Core listing fields (`domain`, `finalUrl`, `socialLinks`, `pagesCrawled`, and `crawledAt`) and contact information (`emails`, `phones`, `primaryEmail`, and `contactPageUrl`). All fields are always present — unavailable data points are returned as `null`, never omitted.

### Input

Configure the actor through the input schema in Apify Console.

Key parameters:

- **`startUrls`** — Company websites or domains to scan. One per line. A bare domain (acme.com) is treated as https://acme.com.
- **`maxPagesPerSite`** — How many internal pages to crawl per website. Contact, about, and team pages are visited first. (default: `20`)
- **`requestTimeoutSecs`** — Per-request timeout before a page is skipped. (default: `15`)
- **`useProxy`** — Route requests through a rotating proxy pool to reduce blocking on sites that limit automated access. (default: `false`)
- **`includePeople`** — Best-effort extraction of named people (name, title, personal LinkedIn) from team and about pages. Fill-rate varies by site. (default: `false`)
- **`verifyEmails`** — Check discovered emails for deliverability and flag role, disposable, and free-provider addresses. (default: `false`)
- **`verificationLevel`** — format = syntax only; mx = mail server exists (recommended); smtp = mailbox probe (slower, often blocked by mail servers). (default: `"mx"`)
- **`excludeEmptyFields`** — Drop empty fields from each record before output. Smaller payloads for AI agents and dashboards. (default: `false`)
- **`telegramToken`** — Telegram bot token (from @BotFather). Required for Telegram notifications.
- **`telegramChatId`** — Telegram chat or channel ID (e.g. "-100123456789"). Required when telegramToken is set.
- **`discordWebhookUrl`** — Discord incoming webhook URL. Server Settings → Integrations → Webhooks → New Webhook.
- **`slackWebhookUrl`** — Slack incoming webhook URL. api.slack.com/messaging/webhooks.
- ...and 3 more parameters

### Input example

**Basic search** — Fetch companies from the provided start URL.

→ Full payload per result — all standard fields populated where the source provides them.

```json
{
  "startUrls": [
    "https://stripe.com",
    "https://www.smashingmagazine.com"
  ]
}
````

### Output

Each run produces a dataset of structured listing records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console.

### Example listing record

```json
{
  "domain": "smashingmagazine.com",
  "finalUrl": "https://www.smashingmagazine.com",
  "emails": [
    "hello@smashingconf.com",
    "mac@smashingmagazine.com"
  ],
  "socialLinks": {
    "facebook": "https://www.facebook.com/smashmag",
    "mastodon": "https://mastodon.social/@smashingmag",
    "linkedin": "https://www.linkedin.com/in/jarijnnijkamp",
    "twitter": "https://www.twitter.com/smashingmag",
    "bluesky": "https://bsky.app/profile/charismagic.bsky.social",
    "youtube": "https://www.youtube.com/@SmashingMagazineVideos"
  },
  "primaryEmail": "hello@smashingconf.com",
  "contactPageUrl": "https://www.smashingmagazine.com/contact/",
  "pagesCrawled": 8,
  "emailVerification": [
    {
      "email": "hello@smashingconf.com",
      "format": true,
      "mx": true,
      "confidence": 0.6,
      "isRole": true,
      "isDisposable": false,
      "isFree": false
    },
    {
      "email": "mac@smashingmagazine.com",
      "format": true,
      "mx": true,
      "confidence": 0.6,
      "isRole": false,
      "isDisposable": false,
      "isFree": false
    }
  ],
  "crawledAt": "2026-07-18T13:03:42.551Z"
}
```

### How to scan websites

1. Go to [Website Contact Scraper](https://apify.com/blackfalcondata/website-contact-scraper?fpr=1h3gvi) in Apify Console.
2. Configure the input.
3. Set `maxResults` to control how many results you need.
4. Click **Start** and wait for the run to finish.
5. Export the dataset as JSON, CSV, or Excel.

### Use cases

- Extract listing data from website contact scraper for market research and competitive analysis.
- Export clean, structured data to dashboards, spreadsheets, or data warehouses.

### How much does it cost to scan websites?

Website Contact Scraper uses [pay-per-event](https://docs.apify.com/platform/actors/paid-actors/pay-per-event) pricing. You pay a small fee when the run starts and then for each result that is actually produced.

- **Run start:** $0.035 per run
- **Per listing (primary event):** $0.001

You are billed only for the events your run actually triggers. Prices below are the Free plan tier; higher Apify plans (Bronze → Diamond) pay progressively less per event, down to roughly 5× lower on the top tier.

| Event | Price (Free tier) | Charged when |
|---|---|---|
| Run start | $0.035 | Charged once when a run starts. |
| Website scanned | $0.001 | Charged per website processed (one result row). |
| Verified email | $0.002 | Charged per email verified (only when email verification is enabled). |

Example costs (primary event only — other events above add cost when they fire):

- 10 results: **$0.045**
- 25 results: **$0.06**
- 100 results: **$0.14**
- 200 results: **$0.24**
- 500 results: **$0.54**

### FAQ

#### How many websites can I check per run?

Every website in your input list is checked — there is no fixed cap, so the number of websites per run is limited only by your list size and the run's time budget.

#### Can I integrate Website Contact Scraper with other apps?

Yes. Website Contact Scraper works with Apify's [integrations](https://apify.com/integrations?fpr=1h3gvi) to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes.

#### Can I use Website Contact Scraper with the Apify API?

Yes. You can start runs, manage inputs, and retrieve results programmatically through the [Apify API](https://docs.apify.com/api/v2). Client libraries are available for JavaScript, Python, and other languages.

#### Can I use Website Contact Scraper through an MCP Server?

Yes. Apify provides an [MCP Server](https://apify.com/apify/actors-mcp-server?fpr=1h3gvi) that lets AI assistants and agents call this actor directly. Use `excludeEmptyFields` to keep payloads manageable for LLM context windows.

#### Is it legal to scan websites?

This actor queries publicly available DNS, WHOIS, certificate and reputation data for the websites you provide. Looking up public domain data is generally legal, but you should ensure your use complies with applicable laws and the queried services' terms, including GDPR where relevant.

#### Your feedback

If you have questions, need a feature, or found a bug, please [open an issue](https://apify.com/blackfalcondata/website-contact-scraper/issues?fpr=1h3gvi) on the actor's page in Apify Console. Your feedback helps us improve.

### You might also like

- [FirmenABC.at Scraper – Austrian Business Directory](https://apify.com/blackfalcondata/firmenabc-at-scraper?fpr=1h3gvi) — Scrape FirmenABC.at — Austria's largest business directory with 800,000+ companies. Includes full.
- [Google Maps Email Extractor — Verified Business Emails](https://apify.com/blackfalcondata/google-maps-email-extractor?fpr=1h3gvi) — Extract business emails from Google Maps (google.com/maps) — each business website is mined.
- [Google Maps Home Services Lead Scraper](https://apify.com/blackfalcondata/google-maps-home-services-lead-scraper?fpr=1h3gvi) — Find home-services contractors (plumbers, roofers, electricians, HVAC, landscapers) on Google Maps.
- [Google Maps No-Website Leads Scraper](https://apify.com/blackfalcondata/google-maps-no-website-leads-scraper?fpr=1h3gvi) — Find local businesses with NO website on Google Maps (google.com/maps) — name, category, address,.
- [Google Maps Real Estate Lead Scraper](https://apify.com/blackfalcondata/google-maps-real-estate-lead-scraper?fpr=1h3gvi) — Find real-estate agents, realtors and brokers on Google Maps (google.com/maps) — name, category,.
- [Google Maps Scraper — Places, Contacts & Lead Score](https://apify.com/blackfalcondata/google-maps-scraper?fpr=1h3gvi) — Scrape Google Maps (google.com/maps) places by search term + location — name, category, address,.
- [Google Maps Unclaimed Business Leads Scraper](https://apify.com/blackfalcondata/google-maps-unclaimed-leads-scraper?fpr=1h3gvi) — Find businesses on Google Maps (google.com/maps) with an UNCLAIMED Google Business Profile — name,.
- [WLW Scraper – B2B Supplier Leads Germany](https://apify.com/blackfalcondata/wlw-scraper?fpr=1h3gvi) — Scrape wlw.de — the leading DACH B2B supplier directory — and extract phone number, address.
- [Shopify Store Scraper](https://apify.com/blackfalcondata/shopify-store-scraper?fpr=1h3gvi) — Catalog, variants, and store contact data from any Shopify store.
- [Clutch Scraper](https://apify.com/blackfalcondata/clutch-scraper?fpr=1h3gvi) — B2B company and agency profiles with services, reviews, and locations.

### Getting started with Apify

New to Apify? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=1h3gvi\&fp_sid=ctarich) — no credit card required.

1. Sign up — $5 platform credit included
2. Open this actor and configure your input
3. Click **Start** — export results as JSON, CSV, or Excel

Need more later? [See Apify pricing](https://apify.com/pricing?fpr=1h3gvi).

# Actor input Schema

## `startUrls` (type: `array`):

Company websites or domains to scan. One per line. A bare domain (acme.com) is treated as https://acme.com.

## `maxPagesPerSite` (type: `integer`):

How many internal pages to crawl per website. Contact, about, and team pages are visited first.

## `requestTimeoutSecs` (type: `integer`):

Per-request timeout before a page is skipped.

## `useProxy` (type: `boolean`):

Route requests through a rotating proxy pool to reduce blocking on sites that limit automated access.

## `includePeople` (type: `boolean`):

Best-effort extraction of named people (name, title, personal LinkedIn) from team and about pages. Fill-rate varies by site.

## `verifyEmails` (type: `boolean`):

Check discovered emails for deliverability and flag role, disposable, and free-provider addresses.

## `verificationLevel` (type: `string`):

format = syntax only; mx = mail server exists (recommended); smtp = mailbox probe (slower, often blocked by mail servers).

## `excludeEmptyFields` (type: `boolean`):

Drop empty fields from each record before output. Smaller payloads for AI agents and dashboards.

## `telegramToken` (type: `string`):

Telegram bot token (from @BotFather). Required for Telegram notifications.

## `telegramChatId` (type: `string`):

Telegram chat or channel ID (e.g. "-100123456789"). Required when telegramToken is set.

## `discordWebhookUrl` (type: `string`):

Discord incoming webhook URL. Server Settings → Integrations → Webhooks → New Webhook.

## `slackWebhookUrl` (type: `string`):

Slack incoming webhook URL. api.slack.com/messaging/webhooks.

## `webhookUrl` (type: `string`):

Receives a JSON POST with {metadata, items} after each run. Universal escape hatch for n8n / Make / Zapier / custom backends.

## `webhookHeaders` (type: `object`):

Optional JSON object of custom headers (e.g. {"Authorization":"Bearer ..."}).

## `notificationLimit` (type: `integer`):

Maximum number of websites included in each notification message (1–20).

## Actor input object example

```json
{
  "startUrls": [
    "https://stripe.com",
    "https://www.smashingmagazine.com"
  ],
  "maxPagesPerSite": 20,
  "requestTimeoutSecs": 15,
  "useProxy": false,
  "includePeople": false,
  "verifyEmails": false,
  "verificationLevel": "mx",
  "excludeEmptyFields": false,
  "notificationLimit": 5
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://stripe.com",
        "https://www.smashingmagazine.com"
    ],
    "useProxy": false,
    "includePeople": false,
    "verifyEmails": false,
    "excludeEmptyFields": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("blackfalcondata/website-contact-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [
        "https://stripe.com",
        "https://www.smashingmagazine.com",
    ],
    "useProxy": False,
    "includePeople": False,
    "verifyEmails": False,
    "excludeEmptyFields": False,
}

# Run the Actor and wait for it to finish
run = client.actor("blackfalcondata/website-contact-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://stripe.com",
    "https://www.smashingmagazine.com"
  ],
  "useProxy": false,
  "includePeople": false,
  "verifyEmails": false,
  "excludeEmptyFields": false
}' |
apify call blackfalcondata/website-contact-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=blackfalcondata/website-contact-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Website Contact Scraper — Email, Phone & Social Finder",
        "description": "Turn any list of websites into outreach-ready contacts: emails, phones, social profiles, structured company data (legal name, address, VAT) and named people. Optional email verification flags deliverability, role, disposable and free addresses. CRM-ready JSON.",
        "version": "0.1",
        "x-build-id": "eMa5ZUNe3xKGp5BgA"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/blackfalcondata~website-contact-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-blackfalcondata-website-contact-scraper",
                "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/blackfalcondata~website-contact-scraper/runs": {
            "post": {
                "operationId": "runs-sync-blackfalcondata-website-contact-scraper",
                "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/blackfalcondata~website-contact-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-blackfalcondata-website-contact-scraper",
                "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": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "🔗 Website URLs",
                        "type": "array",
                        "description": "Company websites or domains to scan. One per line. A bare domain (acme.com) is treated as https://acme.com.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxPagesPerSite": {
                        "title": "📄 Max Pages Per Site",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "How many internal pages to crawl per website. Contact, about, and team pages are visited first.",
                        "default": 20
                    },
                    "requestTimeoutSecs": {
                        "title": "⏱️ Request Timeout (seconds)",
                        "minimum": 5,
                        "maximum": 60,
                        "type": "integer",
                        "description": "Per-request timeout before a page is skipped.",
                        "default": 15
                    },
                    "useProxy": {
                        "title": "🛡️ Use Proxy",
                        "type": "boolean",
                        "description": "Route requests through a rotating proxy pool to reduce blocking on sites that limit automated access.",
                        "default": false
                    },
                    "includePeople": {
                        "title": "👤 Extract People",
                        "type": "boolean",
                        "description": "Best-effort extraction of named people (name, title, personal LinkedIn) from team and about pages. Fill-rate varies by site.",
                        "default": false
                    },
                    "verifyEmails": {
                        "title": "✅ Verify Emails",
                        "type": "boolean",
                        "description": "Check discovered emails for deliverability and flag role, disposable, and free-provider addresses.",
                        "default": false
                    },
                    "verificationLevel": {
                        "title": "🔬 Verification Depth",
                        "enum": [
                            "format",
                            "mx",
                            "smtp"
                        ],
                        "type": "string",
                        "description": "format = syntax only; mx = mail server exists (recommended); smtp = mailbox probe (slower, often blocked by mail servers).",
                        "default": "mx"
                    },
                    "excludeEmptyFields": {
                        "title": "📦 Exclude Empty Fields",
                        "type": "boolean",
                        "description": "Drop empty fields from each record before output. Smaller payloads for AI agents and dashboards.",
                        "default": false
                    },
                    "telegramToken": {
                        "title": "🔑 Telegram Bot Token",
                        "type": "string",
                        "description": "Telegram bot token (from @BotFather). Required for Telegram notifications."
                    },
                    "telegramChatId": {
                        "title": "💬 Telegram Chat ID",
                        "type": "string",
                        "description": "Telegram chat or channel ID (e.g. \"-100123456789\"). Required when telegramToken is set."
                    },
                    "discordWebhookUrl": {
                        "title": "🎮 Discord Webhook URL",
                        "type": "string",
                        "description": "Discord incoming webhook URL. Server Settings → Integrations → Webhooks → New Webhook."
                    },
                    "slackWebhookUrl": {
                        "title": "💼 Slack Webhook URL",
                        "type": "string",
                        "description": "Slack incoming webhook URL. api.slack.com/messaging/webhooks."
                    },
                    "webhookUrl": {
                        "title": "🪝 Generic Webhook URL",
                        "type": "string",
                        "description": "Receives a JSON POST with {metadata, items} after each run. Universal escape hatch for n8n / Make / Zapier / custom backends."
                    },
                    "webhookHeaders": {
                        "title": "📋 Webhook Headers",
                        "type": "object",
                        "description": "Optional JSON object of custom headers (e.g. {\"Authorization\":\"Bearer ...\"})."
                    },
                    "notificationLimit": {
                        "title": "📊 Max Items Per Notification",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Maximum number of websites included in each notification message (1–20).",
                        "default": 5
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
