{ "openapi": "3.0.1", "info": { "title": "X / Twitter Profile Email Scraper", "description": "Twitter / X Profile Email Scraper extracts publicly available email addresses and contact information from X (Twitter) profiles at scale. Collect profile data, usernames, bios, websites, and business emails for lead generation, outreach, market research, and prospecting workflows.", "version": "2.0", "x-build-id": "iGV3yVnnT6d1vzaDR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapevanta~twitter-profile-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapevanta-twitter-profile-email-scraper", "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/scrapevanta~twitter-profile-email-scraper/runs": { "post": { "operationId": "runs-sync-scrapevanta-twitter-profile-email-scraper", "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/scrapevanta~twitter-profile-email-scraper/run-sync": { "post": { "operationId": "run-sync-scrapevanta-twitter-profile-email-scraper", "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": [ "keywords", "country", "emailType", "maxEmails" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Enter one or more keywords to search for on X (Twitter).", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "United States", "United Kingdom", "Canada", "Australia", "Germany", "France", "India", "Japan", "Brazil", "Italy", "Spain", "Netherlands", "Sweden", "Norway", "Denmark", "Finland", "Poland", "Czech Republic", "Hungary", "Romania", "Bulgaria", "Croatia", "Slovenia", "Slovakia", "Estonia", "Latvia", "Lithuania", "Portugal", "Greece", "Cyprus", "Malta", "Luxembourg", "Ireland", "Belgium", "Austria", "Switzerland", "Liechtenstein", "Iceland", "South Korea", "China", "Mexico", "Argentina", "Chile", "Colombia", "Peru", "Venezuela", "Ecuador", "Uruguay", "Paraguay", "Bolivia", "Guyana", "Suriname", "French Guiana", "Falkland Islands (Malvinas)", "South Georgia and the South Sandwich Islands", "Bonaire, Sint Eustatius and Saba", "Curaçao", "Aruba", "Sint Maarten (Dutch part)", "Turks and Caicos Islands", "British Virgin Islands", "Anguilla", "Montserrat", "Antigua and Barbuda", "Barbados", "Dominica", "Grenada", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Trinidad and Tobago", "Jamaica", "Bahamas", "Belize", "Costa Rica", "Guatemala", "Honduras", "Nicaragua", "Panama", "El Salvador", "Cuba", "Dominican Republic", "Haiti", "Puerto Rico", "U.S. Virgin Islands", "American Samoa", "Guam", "Northern Mariana Islands", "Saudi Arabia", "United Arab Emirates", "Bahrain", "Iraq", "Iran, Islamic Republic of", "Israel", "Jordan", "Kuwait", "Lebanon", "Oman", "Qatar", "Syrian Arab Republic", "Yemen", "Afghanistan", "Bangladesh", "Bhutan", "Maldives", "Nepal", "Pakistan", "Sri Lanka", "Myanmar", "Cambodia", "Lao People's Democratic Republic", "Thailand", "Viet Nam", "Malaysia", "Singapore", "Brunei Darussalam", "Philippines", "Indonesia", "Timor-Leste", "Papua New Guinea", "Fiji", "New Zealand", "Solomon Islands", "Vanuatu", "New Caledonia", "French Polynesia", "Wallis and Futuna", "Samoa", "Tonga", "Tuvalu", "Kiribati", "Nauru", "Federated States of Micronesia", "Marshall Islands", "Palau", "Cook Islands", "Niue", "Tokelau" ], "type": "string", "description": "Specify the country to target for Google search results.", "default": "United States" }, "emailType": { "title": "Email Type", "enum": [ "B2C", "B2B" ], "type": "string", "description": "Choose one — B2C or B2B.", "default": "B2C" }, "maxEmails": { "title": "Max Emails", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Enter the maximum number of emails to collect.", "default": 20 }, "verifyEmails": { "title": "Verify email addresses", "type": "boolean", "description": "Check each address: syntax, whether the domain publishes MX records and can receive mail at all, whether it is a throwaway inbox, a role mailbox or a free provider. Adds a DNS lookup per domain, cached across the run.", "default": true }, "minimumConfidence": { "title": "Minimum confidence (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Drop addresses scoring below this. A business address on a domain with MX records scores around 95; a role mailbox around 85; a throwaway 5.", "default": 0 }, "excludeRoleAccounts": { "title": "Exclude role mailboxes", "type": "boolean", "description": "Drop info@, sales@, support@ and similar. They reach an organisation rather than a person.", "default": false }, "excludeFreeProviders": { "title": "Exclude free providers", "type": "boolean", "description": "Drop Gmail, Outlook, Yahoo and similar, keeping only company domains.", "default": false }, "excludeDisposableEmails": { "title": "Exclude throwaway inboxes", "type": "boolean", "description": "Drop known temporary-email providers.", "default": true }, "requireMxRecord": { "title": "Only keep domains that accept mail", "type": "boolean", "description": "Drop addresses whose domain publishes no MX record, and those where the lookup could not be completed - an unknown result is not evidence the domain accepts mail.", "default": false }, "useDisposableBlocklist": { "title": "Load the public throwaway-domain list", "type": "boolean", "description": "Download the public blocklist of disposable email domains at the start of the run, on top of the built-in set.", "default": true }, "includeResultSnippet": { "title": "Include the result snippet", "type": "boolean", "description": "Keep the search-result text each address was found in, so a lead can be checked in context.", "default": true }, "emitRunSummary": { "title": "Append a run summary", "type": "boolean", "description": "Add a final record with totals, the category breakdown, top email domains, top profiles and how each query template performed.", "default": true }, "emitProfileRecords": { "title": "Append one record per profile", "type": "boolean", "description": "Group the addresses by the account they were found on and add a record per profile: every address on it, the departments reachable, the company domains and a 0-100 reachability score.", "default": 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 } } }, "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 } } } } } } } } } }