{ "openapi": "3.0.1", "info": { "title": "Bulk Website Contact & Email Finder", "description": "Email and contact scraper for a list of websites or domains. One row per site: emails with likely owner and CEO addresses ranked above info@, plus phones and social profiles from the homepage and its contact and about pages. Optional MX check. Pay only per website with contacts.", "version": "0.1", "x-build-id": "phiQgy4hwcbV1jYeF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gersinhobdc~contact-email-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gersinhobdc-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/gersinhobdc~contact-email-finder/runs": { "post": { "operationId": "runs-sync-gersinhobdc-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/gersinhobdc~contact-email-finder/run-sync": { "post": { "operationId": "run-sync-gersinhobdc-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Websites / domains", "type": "array", "description": "Websites or domains to scan, one per line, or upload a CSV of URLs. Each one is read from the root of its domain (a path such as /blog is ignored and www. is dropped), and repeated entries for the same domain become one row. You are charged once per website that returns at least one email, phone or social profile; websites with nothing found cost nothing.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxPagesPerDomain": { "title": "Max pages per domain", "minimum": 1, "maximum": 20, "type": "integer", "description": "Pages read per website, homepage included. Contact and about pages linked from the homepage are followed first; common paths such as /contact or /about are tried only when the homepage links none. More pages find more contacts on large sites and add run time, but the price per website stays the same.", "default": 5 }, "extractEmails": { "title": "Extract emails", "type": "boolean", "description": "Collect email addresses from the page HTML, including mailto: links and simple [at]/[dot] obfuscation. Emails drawn as images or loaded by JavaScript are not seen.", "default": true }, "extractPhones": { "title": "Extract phone numbers", "type": "boolean", "description": "Collect phone numbers from tel: and callto: links only. Numbers printed as plain text on the page are not picked up.", "default": true }, "extractSocials": { "title": "Extract social profiles", "type": "boolean", "description": "Collect LinkedIn, X/Twitter, Facebook, Instagram, YouTube and TikTok profile links found on the scanned pages.", "default": true }, "verifyEmails": { "title": "Verify email deliverability (MX)", "type": "boolean", "description": "Look up the mail servers (MX records) of each email's domain. This confirms the domain accepts mail; it does not confirm that the mailbox exists. Each lookup can take up to 5 seconds. Billed per email with a definite answer (valid or invalid) as the email-verified event; lookups that time out are marked unknown and not charged.", "default": false }, "rankDecisionMaker": { "title": "Rank decision-maker emails first", "type": "boolean", "description": "Sort each website's emails by a 0 to 1 score so addresses like ceo@, founder@ or firstname.lastname@ come before role inboxes like info@ or support@. The score is read from the address itself; no names or job titles are looked up. When off, emails keep the order they were found in and score is 0.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many pages are fetched at the same time across all websites. Higher finishes long lists faster; lower is gentler on the sites you scan.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to fetch pages. Apify Proxy (default) helps with sites that block datacenter traffic. Pages are read as plain HTML without a browser, so sites that only show contacts after JavaScript runs may return nothing.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }