# Social Username Checker (`maged120/social-username-checker`) Actor Check whether usernames are available or already taken across platforms: Twitte, Instagram, YouTube, GitHub, GitLab, Telegram, Snapchat, Mastodon, Bluesky, Linktree, About.me, Twitch, Vimeo, Dev.to, Replit, Docker Hub, Steam, Xbox, Chess.com, Minecraft, Lichess, SoundCloud, Patreon, and more - **URL**: https://apify.com/maged120/social-username-checker.md - **Developed by:** [Maged](https://apify.com/maged120) (community) - **Categories:** Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 95.8% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $9.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/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 **Username Availability Checker** tells you — in a single run — whether a **username (handle) is available or already taken** across 29+ of the most popular **social media, video, gaming, coding, music and creator platforms**. Feed it a list of usernames, pick the platforms you care about, and get a clean, structured table back showing exactly where each handle is free. Perfect for **securing a consistent brand name**, claiming a personal handle everywhere, or bulk-checking hundreds of usernames at once. Built on the Apify platform, it gives you **API access, scheduling, integrations** (Zapier, Make, Slack, Google Sheets), proxy rotation, and run monitoring out of the box — no code required. ### What does the Username Availability Checker do? This Actor takes one or more usernames and checks each of them against the platforms you select. For every username/platform combination it reports whether the handle is **available**, **taken**, or **unknown** (couldn't be confirmed at that moment), along with the public profile URL where that handle would live. **Supported platforms (29+):** Twitter / X, Instagram, YouTube, GitHub, GitLab, Telegram, Snapchat, Mastodon, Bluesky, Linktree, About.me, Twitch, Vimeo, Dev.to, Replit, Docker Hub, Steam, Xbox, Chess.com, Minecraft, Lichess, Dribbble, Gravatar, SoundCloud, Last.fm, Patreon, Tumblr, Flickr, and Substack. ### Why use the Username Availability Checker? - **Brand consistency** — make sure your business, product, or project name is free everywhere *before* you launch. - **Personal branding** — find a single handle you can claim across every network. - **Bulk username research** — check hundreds of names automatically instead of opening each site by hand. - **Availability monitoring** — schedule recurring runs to catch a handle the moment it frees up. - **Automation & integrations** — pipe results straight into Google Sheets, a database, or your own app via the Apify API. ### How to use the Username Availability Checker to check handles 1. Open the Actor in Apify Console. 2. In **Usernames to Check**, add the handles you want to look up (one per line). 3. Under **Platforms**, keep the popular defaults or select exactly which networks to check. 4. Choose your **Proxy Configuration** (Apify Proxy is recommended). 5. Click **Start** and watch results populate in the **Output** tab. Export anytime as JSON, CSV, Excel, or HTML. ### Input | Field | Type | Description | | --- | --- | --- | | `usernames` | array | The handles to check, one per line. | | `platforms` | array (multi-select) | Which platforms to check each username against. Defaults to the five most popular networks. | | `proxyConfiguration` | object | Proxy settings for the run. Apify Proxy is recommended. | #### Example input ```json { "usernames": ["johnsmith", "janedoe"], "platforms": ["Twitter / X", "Instagram", "GitHub", "YouTube", "Telegram"], "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Each row in the dataset is one username/platform result. **You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.** ```json { "username": "johnsmith", "platform": "GitHub", "category": "Coding", "available": false, "status": "taken", "url": "https://github.com/johnsmith", "note": null, "checkedAt": "2026-06-19T16:03:53.349Z", "quota": "Unlimited." } ``` ### Data table | Field | Description | | --- | --- | | `username` | The handle that was checked. | | `platform` | The platform the check was run against. | | `category` | Platform category (Social, Video, Coding, Gaming, Music, etc.). | | `available` | `true` if the handle is free, `false` if taken, `null` if undetermined. | | `status` | Human-readable status: `available`, `taken`, or `unknown`. | | `url` | The public profile URL for that handle. | | `note` | Extra context when a result couldn't be confirmed. | | `checkedAt` | Timestamp of the check (ISO 8601). | | `quota` | Always "Unlimited." — this Actor has no usage cap. | ### Usage limits There is **no usage limit** on this Actor — every account, free or paid, can run it without a monthly cap or result limit. The `quota` field on each result simply reads `Unlimited.`. You only pay for what you run (see pricing below). ### How much does it cost to check username availability? This Actor uses a simple **pay-per-result** model: you are charged **$1.00 per 1,000 results**, where one result is a single username checked on a single platform. There are no monthly fees — you only pay for what you run. **Example:** checking 100 usernames across the 5 default platforms = 500 results ≈ **$0.50**. Checking 1,000 usernames across all 29 platforms = 29,000 results ≈ **$29**. The Apify free tier includes monthly usage credits, which is enough to try the Actor and run small batches at no cost. To keep costs down, select only the platforms you actually need. ### Tips and advanced options - Start with the default platform selection for the fastest, cheapest runs, then widen coverage as needed. - Use **Apify Proxy** for the most reliable results, especially on larger batches. - **Schedule** recurring runs to be notified when a taken handle becomes available. - A `status` of `unknown` means the result couldn't be confirmed at that moment — simply re-run to retry. - Note that a few JavaScript-heavy platforms (such as X) always respond as if a profile exists, so they may lean toward reporting "taken" even for a free handle. ### FAQ, disclaimers, and support **Is availability guaranteed?** No. Results reflect a best-effort signal at check time; the only way to truly reserve a handle is to register it on the platform itself. Treat `unknown` results as "try again." **Is this legal?** The Actor only checks the public availability of handles and does not collect personal data. You are responsible for complying with each platform's Terms of Service. **Something looks off, or a platform is missing?** Open an issue from the Actor's **Issues** tab. Custom platform support and tailored solutions are available on request. # Actor input Schema ## `usernames` (type: `array`): The usernames (handles) you want to look up. Each one is checked against every platform you select below. ## `platforms` (type: `array`): Which platforms to check each username against. Leave the defaults for a quick check of the most popular networks, or select more for wider coverage. ## `proxyConfiguration` (type: `object`): Proxy settings used for the lookups. Apify Proxy is recommended for reliable, uninterrupted results. ## Actor input object example ```json { "usernames": [ "johnsmith", "janedoe" ], "platforms": [ "Twitter / X", "Instagram", "GitHub", "YouTube", "Telegram" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "usernames": [ "johnsmith" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maged120/social-username-checker").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 = { "usernames": ["johnsmith"] } # Run the Actor and wait for it to finish run = client.actor("maged120/social-username-checker").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 '{ "usernames": [ "johnsmith" ] }' | apify call maged120/social-username-checker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maged120/social-username-checker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Social Username Checker", "description": "Check whether usernames are available or already taken across platforms: Twitte, Instagram, YouTube, GitHub, GitLab, Telegram, Snapchat, Mastodon, Bluesky, Linktree, About.me, Twitch, Vimeo, Dev.to, Replit, Docker Hub, Steam, Xbox, Chess.com, Minecraft, Lichess, SoundCloud, Patreon, and more", "version": "0.1", "x-build-id": "ioMO4LlWFuhcbd2ge" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maged120~social-username-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maged120-social-username-checker", "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/maged120~social-username-checker/runs": { "post": { "operationId": "runs-sync-maged120-social-username-checker", "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/maged120~social-username-checker/run-sync": { "post": { "operationId": "run-sync-maged120-social-username-checker", "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": [ "usernames", "proxyConfiguration" ], "properties": { "usernames": { "title": "Usernames to Check", "type": "array", "description": "The usernames (handles) you want to look up. Each one is checked against every platform you select below.", "items": { "type": "string" } }, "platforms": { "title": "Platforms", "type": "array", "description": "Which platforms to check each username against. Leave the defaults for a quick check of the most popular networks, or select more for wider coverage.", "items": { "type": "string", "enum": [ "Telegram", "Twitter / X", "Instagram", "Snapchat", "Mastodon", "Bluesky", "Linktree", "About.me", "YouTube", "Twitch", "Vimeo", "GitHub", "GitLab", "Dev.to", "Replit", "Docker Hub", "Steam", "Xbox (Gamertag)", "Chess.com", "Minecraft", "Lichess", "Dribbble", "Gravatar", "SoundCloud", "Last.fm", "Patreon", "Tumblr", "Flickr", "Substack" ] }, "default": [ "Twitter / X", "Instagram", "GitHub", "YouTube", "Telegram" ] }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings used for the lookups. Apify Proxy is recommended for reliable, uninterrupted results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```