{ "openapi": "3.0.1", "info": { "title": "Website Contact Details Scraper — Emails, Phones, Socials", "description": "Find e-mails, phone numbers, social profiles (LinkedIn, X, Facebook, Instagram, YouTube…) and addresses on any list of websites. Checks contact, imprint and about pages automatically. Pay only for websites where contacts are found.", "version": "0.3", "x-build-id": "aMGjJ3xzjxDqg8Re6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tacps126~contact-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tacps126-contact-details", "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/tacps126~contact-details/runs": { "post": { "operationId": "runs-sync-tacps126-contact-details", "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/tacps126~contact-details/run-sync": { "post": { "operationId": "run-sync-tacps126-contact-details", "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": "Websites", "type": "array", "description": "Website addresses or domains, one per line — e.g. `apify.com`, `https://www.zalando.de`. Any page of the site works; the Actor finds the contact pages itself. Or leave empty and pick a dataset below.", "items": { "type": "string" } }, "datasetId": { "title": "…or websites from another scraper's results", "type": "string", "description": "Pick a dataset (for example from a Google Maps or company-list scrape) and every row's website is checked. Filled in automatically when this Actor runs as an integration after another Actor. Each result keeps the row's name / id in `source` so you can match it back." }, "websiteField": { "title": "Website column", "type": "string", "description": "Only if the websites aren't found automatically: the column that holds them (dots for nested fields, e.g. `company.website`). By default `website`, `url`, `domain` and similar columns are used; map, social and job-board links are skipped." }, "maxPagesPerSite": { "title": "Pages per website", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many pages to check on each website, starting with the given page and then the most promising ones (contact, imprint, about, team…). 5 finds most contacts; raise it for large sites.", "default": 5 }, "maxItems": { "title": "Max websites", "minimum": 1, "type": "integer", "description": "Maximum number of websites to return.", "default": 1000 }, "sameDomainEmailsOnly": { "title": "Only the website's own e-mail addresses", "type": "boolean", "description": "Keep only addresses on the website's domain (e.g. drop the web agency's or a Gmail address).", "default": false }, "requireEmail": { "title": "Only websites with an e-mail", "type": "boolean", "description": "Report (and charge) a website only if at least one e-mail address was found.", "default": false }, "requirePhone": { "title": "Only websites with a phone number", "type": "boolean", "description": "Report (and charge) a website only if at least one phone number was found.", "default": false }, "includeEmpty": { "title": "Include websites with no contacts", "type": "boolean", "description": "Also list websites where nothing was found (free of charge), so every input gets a row.", "default": false }, "onlyNew": { "title": "Only new websites", "type": "boolean", "description": "Skip websites an earlier run with the same input has already delivered — handy when you re-run a growing list.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name for the “only new” history, so several lists can run side by side." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for most websites. Turn on for large lists or websites that limit repeated visits.", "default": { "useApifyProxy": false } }, "tenantId": { "title": "Tenant ID", "type": "string", "description": "Optional label used to keep separate histories for different clients or teams." }, "debug": { "title": "Debug", "type": "boolean", "description": "Save extra diagnostics with the run (for support requests).", "default": false } } }, "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 } } } } } } } } } }