# Gmail Username Checker — Bulk Availability Lookup (`maged120/gmail-availability`) Actor

Gmail username checker: check whether Gmail usernames are available for new account registration, in bulk. Paste a list and see which addresses are free or taken, without creating any accounts. Export to CSV, JSON, Excel or API.

- **URL**: https://apify.com/maged120/gmail-availability.md
- **Developed by:** [Maged](https://apify.com/maged120) (community)
- **Categories:** Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 260 total users, 5 monthly users, 97.3% runs succeeded, 5 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Gmail Username Checker do?

**Gmail Username Checker** tells you whether Gmail addresses are still free to register, in bulk, without creating any account. Give it a list of usernames or full addresses (`joe` or `joe@gmail.com` both work) and you get one row each with `available: true` or `false`.

It runs on [Apify](https://apify.com), so you can call it from the API, schedule it, or send the results to Google Sheets, Make, Zapier or n8n.

### What people use it for

- **Brand protection:** check whether your brand or product names are still free on Gmail before someone else takes them.
- **Picking a username:** test a list of ideas at once instead of trying them one by one in the sign-up form.
- **Account and lead hygiene:** see which addresses in a list exist as Gmail accounts at all (a taken name is a registered account).
- **Name research:** check one handle across services, together with the other username checkers below.

### How to use it

1. Click **Try for free**.
2. Paste your usernames or Gmail addresses into **emails or/and usernames**, one per line.
3. Click **Start**. Results appear in the **Output** tab as they're checked.
4. Download as JSON, CSV or Excel, or use the API.

### Input

```json
{
  "emails": ["mybrand2026", "jane@gmail.com", "joe"]
}
```

| Field | Type | Description | Default |
|---|---|---|---|
| `emails` | array | Usernames or Gmail addresses to check, up to 1,000 per run. You can also pass one comma- or newline-separated string | required |

### Output

One row per checked name:

```json
{
  "email": "mybrand2026",
  "available": true,
  "quota": "Paid plan: unlimited usage."
}
```

| Field | Type | Description |
|---|---|---|
| `email` | string | The username or address you gave |
| `available` | boolean | `true` if it can still be registered, `false` if it's taken |
| `quota` | string | Your plan's usage note (see below) |

If Gmail doesn't answer for a name after several tries, that name isn't saved or charged. It's listed in the run's status message so you can run it again.

### Free plan limit

On Apify's free plan you can check **20 names every 30 days**. Paid Apify plans have no limit. When the free limit is used up, the run ends with a message saying so, and nothing is charged.

### How many results will I get?

One row per name, up to 1,000 per run. You pay per result; your plan's rates are on the **Pricing** tab.

### FAQ

**Does it create accounts or send anything to the person?**
No. It asks Gmail's sign-up form whether a name is free, like typing it in yourself, and stops there.

**Can I check other email providers?**
No, Gmail only. The related tools below cover other sites.

**Is it maintained?**
Yes, I keep it running. If something breaks, open an issue in the **Issues** tab and I'll look at it.

**Need a custom feature?**
Open an issue or message me on Discord: **maged03211**

***

⭐ **Found it useful?** A short review on the Store helps other people find it, and it tells me what to improve next.

### Related tools

- [Instagram Username Checker – bulk availability](https://apify.com/maged120/instagram-username-checker)
- [Discord Username Checker – bulk availability](https://apify.com/maged120/discord-username-checker)

# Actor input Schema

## `emails` (type: `array`):

list of emails or/and usernames to check for Gmail availability.

## Actor input object example

```json
{
  "emails": [
    "sdoifjasdo@gmail.com",
    "aosdifjadsoifjasdo",
    "joe",
    "jane@gmail.com",
    "goodemail"
  ]
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "emails": [
        "sdoifjasdo@gmail.com",
        "aosdifjadsoifjasdo",
        "joe",
        "jane@gmail.com",
        "goodemail"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("maged120/gmail-availability").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "emails": [
        "sdoifjasdo@gmail.com",
        "aosdifjadsoifjasdo",
        "joe",
        "jane@gmail.com",
        "goodemail",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("maged120/gmail-availability").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "emails": [
    "sdoifjasdo@gmail.com",
    "aosdifjadsoifjasdo",
    "joe",
    "jane@gmail.com",
    "goodemail"
  ]
}' |
apify call maged120/gmail-availability --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,maged120/gmail-availability"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/L7nbaGvrawAhwbn4S/builds/zWuGasSDc4bKoICXE/openapi.json