# GClean - Email Validator (`gitdevaldo/gclean`) Actor Say no more to bounce rate! GClean will handle your email list and we just give you the valid one. Don't worry, we're easy to use and cheap (psstttt). - **URL**: https://apify.com/gitdevaldo/gclean.md - **Developed by:** [Aldo Dwi Kristian](https://apify.com/gitdevaldo) (community) - **Categories:** Automation, Lead generation, Integrations - **Stats:** 3 total users, 1 monthly users, 66.7% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $12.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## GClean ✉️ **Version:** `1.1` **Say no to bounce emails. Forever.** You've been there — you blast out a campaign, and half your emails bounce. Your sender reputation tanks, your ESP flags your account, and you're left wondering why you even bothered. GClean fixes that. Before you send a single email, run your list through GClean and only keep the ones that are actually worth sending to. Fast, easy, and brutally honest about your email list. --- ### What does it do? GClean takes your email list and tells you which ones are safe to send to and which ones aren't. That's it. No complicated setup, no technical knowledge needed. Just drop in your emails and get clean results back. Whether you have 10 emails or 100,000, GClean handles it and gives you a clear answer for each one — valid or not valid. --- ### How we check This isn't just a "does it have an @ sign" kind of check. GClean goes deep on every single email so you can actually trust the results. **Format** The obvious first step. If the email isn't even structured correctly, we catch it right away before wasting time on anything else. **Domain existence** A lot of fake emails use made-up domains. We verify the domain actually exists on the internet before going any further. **MX records** Having a domain is one thing, being set up to receive email is another. We check if the domain actually has mail servers configured behind it. No mail servers means no real inbox. **Disposable and temp mail** People use services like Mailinator, Guerrilla Mail, 10minutemail, and hundreds of others to sign up without giving their real email. We flag all of them so they don't pollute your list. **Role-based addresses** Addresses like `admin@`, `info@`, `support@`, and `noreply@` are technically valid but almost never belong to a real individual. They're shared inboxes, mailing lists, or bots. We flag these so you know what you're dealing with. **SMTP verification** We knock on the door of the actual mail server and ask if the mailbox exists, without sending a real email. A lot of addresses pass every other check but still don't have an active inbox behind them. This step catches those. **Pwned check** We cross-reference against known data breach databases. If the address appeared in a breach, it's a signal the email is real and active — useful to know either way. **Catch-all domain detection** Some domains are set up to accept literally every email sent to them, no matter what. So you can't fully trust a "valid" result on those domains. We detect and flag them so you're never caught off guard. **Spam trap detection** Spam traps are decoy addresses maintained by ISPs and anti-spam organizations to catch senders with dirty lists. Hitting one is a fast track to getting blacklisted. We check against known trap patterns so you never accidentally walk into one. --- ### Why GClean? Because bounce rates are silent killers. Every bounce hurts your sender reputation, and once that's damaged it takes a long time to recover. Most people don't realize their list has a problem until it's already too late. GClean gives you the confidence to send knowing your list is clean. No guessing, no hoping, no nasty surprises after you hit send. And honestly? It's cheap. Way cheaper than the damage a bad list does to your deliverability. --- ### Input | Field | Type | Required | Description | |---|---|---|---| | emails | Array | Yes | A JSON array of emails. Use one item for single validation or multiple items for bulk | Set the actor secret in environment variables as: `VALIDATION_API_TOKEN` --- ### Output Each result row contains: - `email` - `status` (raw value from API `results[].status`, unchanged) - `valid` (`true`, `false`, or `error` as text) - flattened `flags_*` columns from API `results[]` --- ### Use cases - Cleaning your email list before a campaign - Validating signups in real time before they hit your CRM - Scrubbing a purchased list before you use it - Reducing bounce rates and protecting your sender score - Keeping your ESP account healthy and out of trouble --- ### License MIT — use it however you want. # Actor input Schema ## `emails` (type: `array`): List of email addresses to validate. ## Actor input object example ```json {} ```` # Actor output Schema ## `overview` (type: `string`): No description ## `rawItems` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("gitdevaldo/gclean").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("gitdevaldo/gclean").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call gitdevaldo/gclean --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gitdevaldo/gclean", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GClean - Email Validator", "description": "Say no more to bounce rate! GClean will handle your email list and we just give you the valid one. Don't worry, we're easy to use and cheap (psstttt).", "version": "0.0", "x-build-id": "bjPe6Lwc7wVwCUaa1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gitdevaldo~gclean/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gitdevaldo-gclean", "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/gitdevaldo~gclean/runs": { "post": { "operationId": "runs-sync-gitdevaldo-gclean", "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/gitdevaldo~gclean/run-sync": { "post": { "operationId": "run-sync-gitdevaldo-gclean", "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": [ "emails" ], "properties": { "emails": { "title": "Emails", "type": "array", "description": "List of email addresses to validate.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```