{
"openapi": "3.0.1",
"info": {
"title": "Website Contact Extractor — Emails, Phones & Socials",
"description": "Give it a list of website domains and get back business emails, phone numbers, LinkedIn and social profiles, the contact page URL and postal address, one row per domain. HTTP only, no browser, no login. You only pay for domains where something is found.",
"version": "0.1",
"x-build-id": "srrnnkBh0OoTV6JM1"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/insight.solutions~website-contact-extractor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-insight.solutions-website-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/insight.solutions~website-contact-extractor/runs": {
"post": {
"operationId": "runs-sync-insight.solutions-website-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/insight.solutions~website-contact-extractor/run-sync": {
"post": {
"operationId": "run-sync-insight.solutions-website-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",
"required": [
"domains"
],
"properties": {
"domains": {
"title": "Domains or URLs",
"minItems": 1,
"maxItems": 5000,
"type": "array",
"description": "One domain or URL per line, e.g. apify.com, www.example.co.uk or https://example.com/about. Bare domains are resolved automatically over https/http and with/without www.. Email addresses and bare IP addresses are rejected with a diagnostic row and are never charged.",
"items": {
"type": "string"
}
},
"maxPagesPerDomain": {
"title": "Max pages per domain",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Total pages fetched per domain, including the home page. The remaining budget is spent on the most promising contact/about/imprint links found on the home page. Raise it for sites that bury contact details; every extra page costs you nothing extra — pricing is per domain, not per page.",
"default": 4
},
"contactPathHints": {
"title": "Contact page path hints",
"type": "array",
"description": "Internal paths we prefer to follow when looking for contact details. Matching is case-insensitive and prefix-based, so /contact also matches /contact-us/. Anchor text containing contact/about/imprint/impressum/kontakt is also followed even if the path is not listed here.",
"default": [
"/contact",
"/contact-us",
"/about",
"/imprint",
"/impressum",
"/legal"
],
"items": {
"type": "string"
}
},
"includePersonalEmails": {
"title": "Include personal-looking email addresses",
"type": "boolean",
"description": "⚠️ Leave this OFF unless you have a lawful basis. By default only role-based and generic business addresses are returned (info@, sales@, careers@, …); switching it on also returns addresses shaped like a named individual (jane.doe@), which are personal data under the GDPR and the CCPA. Turn it on only if you are ready to be the data controller for them — the README's GDPR / CCPA notes set out what that means.",
"default": false
},
"extractPhones": {
"title": "Extract phone numbers",
"type": "boolean",
"description": "Parse tel: links, JSON-LD telephone values and visible text, then normalise to E.164 using the country hinted by the site's postal address or its top-level domain.",
"default": true
},
"extractSocials": {
"title": "Extract social profile links",
"type": "boolean",
"description": "Detect LinkedIn, X/Twitter, Facebook, Instagram, YouTube and GitHub profile links, normalised to the profile root. Share buttons and intent links are ignored.",
"default": true
},
"requestTimeoutSecs": {
"title": "Request timeout (seconds)",
"minimum": 5,
"maximum": 120,
"type": "integer",
"description": "Per-request timeout. Lower it to move faster through large lists of dead domains; raise it for slow servers.",
"default": 20
},
"maxRunSecs": {
"title": "Maximum run time (seconds)",
"minimum": 30,
"maximum": 3600,
"type": "integer",
"description": "Wall-clock budget for the whole run. When it is reached, no further domains are started; every domain already finished is in your dataset and the run ends SUCCEEDED with a status message saying how many were skipped. Skipped domains are never charged. Raise it for lists of more than a few thousand domains.",
"default": 240
}
}
},
"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
}
}
}
}
}
}
}
}
}
}