{ "openapi": "3.0.1", "info": { "title": "🌟 Contact Details Scraper Pro", "description": "Email extractor and lead scraper to extract and download emails, phone numbers, Facebook, Twitter, LinkedIn, Instagram, Threads, Snapchat, and Telegram profiles from any website. Extract contact information at scale from lists of URLs and download the data as Excel, CSV, JSON, HTML, and XML.", "version": "0.0", "x-build-id": "PenusLqLrXoLV6gpB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/databuddy~contact-details-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-databuddy-contact-details-scraper-pro", "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/databuddy~contact-details-scraper-pro/runs": { "post": { "operationId": "runs-sync-databuddy-contact-details-scraper-pro", "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/databuddy~contact-details-scraper-pro/run-sync": { "post": { "operationId": "run-sync-databuddy-contact-details-scraper-pro", "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 URLs or plain domains (example.com). Also link-in-bio pages (linktr.ee/…, beacons.ai/…) — every site they link to is crawled too.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxRequestsPerStartUrl": { "title": "Max pages per website", "minimum": 1, "type": "integer", "description": "Pages to load per website. Contact, team, about and imprint pages are visited first, so 5–10 is usually enough.", "default": 20 }, "maxDepth": { "title": "Max link depth", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many clicks away from the start page to go. 0 = start page only.", "default": 2 }, "maxRequests": { "title": "Max pages in total", "minimum": 0, "type": "integer", "description": "Stop after this many loaded pages across all websites. 0 = no limit.", "default": 0 }, "sameDomain": { "title": "Stay within the website's domain", "type": "boolean", "description": "Follow only links of the same website (subdomains included). Link-in-bio pages are still followed.", "default": true }, "mergeContacts": { "title": "One merged row per website", "type": "boolean", "description": "All contacts of a website in one row (no separate merge actor needed). Turn off for one row per page, like the original.", "default": true }, "followLinkInBio": { "title": "Follow link-in-bio pages", "type": "boolean", "description": "When a site (or your input) is a Linktree / Beacons / lnk.bio page, crawl the sites it links to. Each becomes its own row with \"discoveredVia\".", "default": true }, "verifyEmails": { "title": "Verify emails (MX records)", "type": "boolean", "description": "Free: checks that each email domain can receive mail, marks role vs personal, free-mail and disposable addresses, and adds the website's email provider, SPF and DMARC.", "default": true }, "detectTechnologies": { "title": "Detect website technologies", "type": "boolean", "description": "Free: CMS, e-commerce, analytics, chat and marketing tools found in the website's code (e.g. Shopify, WordPress, HubSpot).", "default": true }, "includeUncertainPhones": { "title": "Include uncertain phone numbers", "type": "boolean", "description": "Number-like text without a \"phone\" cue goes to \"phonesUncertain\" (as in the original). Confirmed numbers are always in \"phones\".", "default": true }, "onlySameDomainEmails": { "title": "Only emails on the website's own domain", "type": "boolean", "description": "Drop emails of other domains (agencies, vendors, platforms).", "default": false }, "ignoreEmailDomains": { "title": "Ignore email domains", "type": "array", "description": "Email domains to drop, e.g. wixpress.com, sentry.io (common placeholders are already removed).", "default": [], "items": { "type": "string" } }, "onlyResultsWithContacts": { "title": "Only websites with contacts", "type": "boolean", "description": "Leave out rows without any email, phone or social profile. Pages loaded for them are still charged.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify's datacenter proxy (default) works for most websites. Use RESIDENTIAL only for sites behind bot protection: each page then also counts as a \"residential-page\" event, because residential traffic costs ~10× more.", "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 } } } } } } } } } }