{ "openapi": "3.0.1", "info": { "title": "Website Contact Finder: Emails, Phones & Socials", "description": "Extract business emails, phone numbers (E.164), social links and contact page from any list of websites. Charged only for domains where contacts are found. Hard spending cap, dedupe and skip lists built in.", "version": "0.1", "x-build-id": "4CfoJ6vqxNMSaND20" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hgh_han~website-contact-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hgh_han-website-contact-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/hgh_han~website-contact-finder/runs": { "post": { "operationId": "runs-sync-hgh_han-website-contact-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/hgh_han~website-contact-finder/run-sync": { "post": { "operationId": "run-sync-hgh_han-website-contact-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", "properties": { "startUrls": { "title": "Website URLs", "type": "array", "description": "Homepages of the businesses to check.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "domains": { "title": "Domains (plain list)", "type": "array", "description": "Alternative to startUrls: bare domains like acme.com.", "items": { "type": "string" } }, "skipDomains": { "title": "Skip these domains", "type": "array", "description": "Domains already processed – they are not crawled and not charged.", "items": { "type": "string" } }, "skipDatasetId": { "title": "Skip domains from a previous dataset", "type": "string", "description": "ID of a dataset from an earlier run; every `domain` in it is skipped (no double charging)." }, "maxPagesPerSite": { "title": "Max pages per site", "minimum": 1, "maximum": 20, "type": "integer", "description": "Home page + up to N-1 contact/about/impressum/legal pages (depth 1).", "default": 5 }, "defaultCountry": { "title": "Default phone country (ISO-2)", "type": "string", "description": "Used to parse local phone numbers, e.g. US, GB, DE. If empty, inferred from the domain TLD, falling back to US." }, "checkMx": { "title": "Check MX records", "type": "boolean", "description": "Verify each email domain has mail servers (mxValid).", "default": true }, "requireEmail": { "title": "Only output domains with an email", "type": "boolean", "description": "Only output domains with an email", "default": false }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip subpages disallowed by robots.txt.", "default": false }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many output records (0 = no limit).", "default": 0 }, "maxChargeUsd": { "title": "Hard spending cap (USD)", "type": "number", "description": "Run stops before billable results would exceed this amount. Works in addition to Apify's own max-charge setting." }, "pricePerResultUsd": { "title": "Price per billable result (for the cap)", "type": "number", "description": "Must match the Actor's 'contact-found' event price.", "default": 0.003 }, "chargeOnlyWithContacts": { "title": "Charge only when contacts found", "type": "boolean", "description": "Keep true. Domains with no email/phone are free.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Most small-business sites work without proxy." } } }, "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 } } } } } } } } } }