{ "openapi": "3.0.1", "info": { "title": "Website Contact Email Finder", "description": "Give it website URLs; get the contact emails on each site's home and contact pages, with the page each came from. USD 0.00149 per website with a new email, nothing otherwise. New = not yet delivered in this run, or in earlier runs using the same dedupeStoreName. No deliverability check.", "version": "0.1", "x-build-id": "hfLZKgbVpNIBLfP2Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datadelight~website-contact-email-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datadelight-website-contact-email-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/datadelight~website-contact-email-finder/runs": { "post": { "operationId": "runs-sync-datadelight-website-contact-email-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/datadelight~website-contact-email-finder/run-sync": { "post": { "operationId": "run-sync-datadelight-website-contact-email-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": [ "websites" ], "properties": { "websites": { "title": "Website URLs", "type": "array", "description": "Websites to check, one per entry (for example https://example-bakery.com). A bare domain such as example-bakery.com also works. Only http and https pages on ports 80 and 443 are fetched; addresses with a username or password, private or internal addresses, and non-web links are refused and counted in the OUTPUT summary. Two entries for the same website (www or not, http or https, with or without tracking parameters) are checked once.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum websites with emails", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The run stops once this many websites have been saved with a new email. This is also the most you can be charged for in one run.", "default": 100 }, "maxPagesPerWebsite": { "title": "Pages per website", "minimum": 1, "maximum": 8, "type": "integer", "description": "Most pages fetched per website, including the home page. The rest are same-site links whose address or link text names contact, about, imprint (impressum), team or support. 1 reads only the home page.", "default": 3 }, "maxEmailsPerWebsite": { "title": "Emails per website", "minimum": 1, "maximum": 20, "type": "integer", "description": "Most emails kept for one website, best first: addresses on the website's own domain, then by how they were found (mailto link, page text, structured data, protected, written out as 'name [at] domain').", "default": 5 }, "dedupeStoreName": { "title": "Remember results between runs (store name)", "pattern": "^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$", "type": "string", "description": "Optional. Name of a key-value store in your account (3 to 63 lowercase letters, digits and hyphens). Websites already delivered in earlier runs that used the same name are skipped and never charged again, and so are emails already delivered. Emails are stored as hashes, websites as domains. Leave empty to de-duplicate within this run only." }, "includeEmptyRows": { "title": "Also save websites without a new email", "type": "boolean", "description": "Adds a row, never charged, for every checked website that had no new email, with its status and reason. The OUTPUT summary counts them either way.", "default": false }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skips pages a site's robots.txt disallows for crawlers in general. A robots.txt that cannot be read because the server errors counts as disallowing the whole site, as the standard says. Switch off only for sites you are entitled to read this way.", "default": true }, "maxConcurrency": { "title": "Websites checked at once", "minimum": 1, "maximum": 25, "type": "integer", "description": "Websites are checked in parallel; pages of one website are fetched one after another.", "default": 10 }, "requestTimeoutSecs": { "title": "Page timeout (seconds)", "minimum": 3, "maximum": 60, "type": "integer", "description": "How long to wait for one page before giving up on it.", "default": 15 }, "siteTimeoutSecs": { "title": "Website timeout (seconds)", "minimum": 10, "maximum": 300, "type": "integer", "description": "Longest time spent on one website, all its pages included.", "default": 60 } } }, "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 } } } } } } } } } }