EN English ES Español DE Deutsch FR Français PT Português JP 日本語 CN 中文 IT Italiano KR 한국어 NL Nederlands
Identity & Business 2 Endpoints 7 Key Features

Social Handle Availability API

Check username availability across supported social media platforms. Check social handles alongside domain availability.

View documentation Try the free tool Explore all APIs
Category Identity & Business
Endpoints 2
Key Features 7
Frequently Asked Questions 2

Used by people at amazing companies

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

Trust signals before you integrate

Transparent docs, authenticated requests, and visible reliability details make it easier to evaluate DomScan before you ship.

Live Service status

Check live service health and documented failure responses before you integrate.

OpenAPI API artifacts

OpenAPI, Swagger, Postman, CLI, SDK, and MCP links are one click away.

API keys Protected access

Authenticated endpoints use API keys with clear credit costs before you call them.

10,000 Free allowance

Start with 10,000 monthly credits and upgrade only when usage grows.

What this API helps you ship

Use this page as a production brief: endpoints, examples, response shape, and the workflow pieces needed to plug DomScan into your own product.

Product workflows

Embed domain checks, DNS intelligence, risk signals, or enrichment into onboarding, search, and internal tools.

Analyst automation

Replace repeated manual lookups with scheduled jobs, alerting, and reproducible investigation steps.

Clean JSON data

Use predictable fields, documented status codes, and credit costs instead of scraping provider pages.

AI and ops tooling

Feed agents, dashboards, SOAR playbooks, and CRMs through OpenAPI, SDK, Postman, or MCP.

Integration workflow

A simple path from first request to repeatable production usage.

1
Authenticate once

Send your API key with the documented header and keep requests consistent across services.

2
Query with examples

Start from the curl and HTTP samples, then map the parameters into your application code.

3
Operate and monitor

Use status codes, credit costs, and response fields to build retries, logs, and alerts.

Developer kit

Jump from this page into machine-readable docs, request collections, SDKs, or agent tooling.

OpenAPI schema

Generate clients or inspect every request and response shape.

 Postman collection

Import ready-made requests for manual testing and team handoff.

 SDKs and CLI

Use maintained packages and command-line workflows instead of writing boilerplate.

 MCP integration

Expose domain intelligence to AI agents and internal assistant workflows.

Parameters and response map

Scan the inputs, output fields, and status codes before wiring the endpoint into your client.

Request parameters

Parameter

handleplatformsresourceshandles
Response fields

Example Response

handleavailabilityavailability.githubavailability.github.availableavailability.github.profile_urlavailability.github.checkedavailability.github.requestedavailability.github.methodavailability.github.confidenceavailability.github.latency_msavailability.github.evidenceavailability.reddit
Status coverage

HTTP Status Codes

200400401402429

Endpoints

GET /v1/social
Credits: 2Authentication: Authentication required
handleplatformsresources
POST /v1/social/bulk
Credits: 2/itemAuthentication: Authentication required
handlesplatformsresources

Social Handle Availability

GitHub

github

1-39 chars, alphanumeric and hyphens, cannot start/end with hyphen

GET /v1/social?handle=mybrand&platforms=github https://github.com/mybrand

GitLab

gitlab

1-255 chars, letters, numbers, underscores, hyphens, and periods; cannot start with hyphen or end with period, .git, or .atom

GET /v1/social?handle=mybrand&platforms=gitlab https://gitlab.com/mybrand

Bitbucket

bitbucket, bb

1-255 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=bitbucket https://bitbucket.org/mybrand/

Dev.to

devto, dev.to

2-30 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=devto https://dev.to/mybrand

Hugging Face

huggingface, hf

1-39 chars, alphanumeric and hyphens, cannot start/end with hyphen

GET /v1/social?handle=mybrand&platforms=huggingface https://huggingface.co/mybrand

Dribbble

dribbble

1-40 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=dribbble https://dribbble.com/mybrand

SoundCloud

soundcloud

1-40 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=soundcloud https://soundcloud.com/mybrand

Gumroad

gumroad

1-63 chars, letters, numbers, and hyphens; cannot start or end with a hyphen

GET /v1/social?handle=mybrand&platforms=gumroad https://mybrand.gumroad.com/

Buy Me a Coffee

buymeacoffee, bmc

1-40 chars, letters and numbers only

GET /v1/social?handle=mybrand&platforms=buymeacoffee https://buymeacoffee.com/mybrand

Substack

substack

1-63 chars, letters and numbers only

GET /v1/social?handle=mybrand&platforms=substack https://mybrand.substack.com/

itch.io

itchio, itch.io

1-30 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=itchio https://mybrand.itch.io/

Behance

behance

1-40 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=behance https://www.behance.net/mybrand

Docker Hub

dockerhub, docker

4-30 chars, lowercase letters and numbers only

GET /v1/social?handle=mybrand&platforms=dockerhub https://hub.docker.com/u/mybrand

Hashnode

hashnode

1-39 chars, letters, numbers, and hyphens; cannot start or end with a hyphen

GET /v1/social?handle=mybrand&platforms=hashnode https://hashnode.com/@mybrand

RubyGems

rubygems, ruby-gems

2-64 chars, letters, numbers, underscores, and hyphens; must include a letter

GET /v1/social?handle=mybrand&platforms=rubygems https://rubygems.org/profiles/mybrand

Hacker News

hackernews, hn

1-20 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=hackernews https://news.ycombinator.com/user?id=mybrand

Reddit

reddit

3-20 chars, alphanumeric, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=reddit https://reddit.com/user/mybrand

Bluesky

bluesky, bsky

3-253 chars, domain-style handle with letters, numbers, hyphens, and periods

GET /v1/social?handle=mybrand&platforms=bluesky https://bsky.app/profile/mybrand

X / Twitter

x, twitter

1-15 chars, alphanumeric and underscores

GET /v1/social?handle=mybrand&platforms=twitter https://x.com/mybrand

Instagram

instagram, ig

1-30 chars, alphanumeric, underscores, and periods

GET /v1/social?handle=mybrand&platforms=instagram https://instagram.com/mybrand

Facebook

facebook, fb

4-50 chars, alphanumeric and periods

GET /v1/social?handle=mybrand&platforms=facebook https://www.facebook.com/mybrand

Threads

threads

1-30 chars, alphanumeric, underscores, and periods

GET /v1/social?handle=mybrand&platforms=threads https://www.threads.com/@mybrand

Pinterest

pinterest

2-30 chars, alphanumeric, underscores, and periods

GET /v1/social?handle=mybrand&platforms=pinterest https://www.pinterest.com/mybrand/

Snapchat

snapchat, snap

3-15 chars, start with a letter, letters, numbers, hyphens, underscores, and periods, end with a letter or number

GET /v1/social?handle=mybrand&platforms=snapchat https://www.snapchat.com/@mybrand

Telegram

telegram, tg

3-32 chars, start with a letter, letters, numbers, single underscores only, no trailing underscore

GET /v1/social?handle=mybrand&platforms=telegram https://t.me/mybrand

Twitch

twitch

3-25 chars, alphanumeric and underscores

GET /v1/social?handle=mybrand&platforms=twitch https://www.twitch.tv/mybrand

Patreon

patreon

1-100 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=patreon https://www.patreon.com/mybrand

TikTok

tiktok

2-24 chars, alphanumeric, underscores, and periods

GET /v1/social?handle=mybrand&platforms=tiktok https://www.tiktok.com/@mybrand

YouTube

youtube, yt

3-30 chars, alphanumeric, underscores, periods, and hyphens

GET /v1/social?handle=mybrand&platforms=youtube https://youtube.com/@mybrand

LinkedIn

linkedin

3-100 chars, alphanumeric and hyphens

GET /v1/social?handle=mybrand&platforms=linkedin https://www.linkedin.com/company/mybrand

Steam

steam, steamcommunity

2-64 chars, letters, numbers, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=steam https://steamcommunity.com/id/mybrand

Tumblr

tumblr

1-32 chars, letters, numbers, and internal hyphens

GET /v1/social?handle=mybrand&platforms=tumblr https://www.tumblr.com/mybrand

Vimeo

vimeo

1-64 chars, letters, numbers, underscores, and hyphens; must contain a letter

GET /v1/social?handle=mybrand&platforms=vimeo https://vimeo.com/mybrand

Letterboxd

letterboxd, lb

2-15 chars, letters, numbers, and underscores

GET /v1/social?handle=mybrand&platforms=letterboxd https://letterboxd.com/mybrand/

Linktree

linktree

1-80 chars, letters, numbers, periods, underscores, and hyphens

GET /v1/social?handle=mybrand&platforms=linktree https://linktr.ee/mybrand

Platform Resources

Check scoped identities such as repositories, subreddits, Discord invites, Substack profiles, and federated accounts without changing endpoints.

Reddit subreddit

subreddit

programming

GET /v1/social?handle=programming&resources=reddit:subreddit method=public_profile confidence=high

Discord invite

invite

midjourney

GET /v1/social?handle=midjourney&resources=discord:invite method=official_api confidence=high

GitHub repository

repository

github/docs

GET /v1/social?handle=github%2Fdocs&resources=github:repository method=official_api confidence=high

GitLab project

project

gitlab-org/gitlab

GET /v1/social?handle=gitlab-org%2Fgitlab&resources=gitlab:project method=official_api confidence=high

Docker Hub repository

repository

library/ubuntu

GET /v1/social?handle=library%2Fubuntu&resources=dockerhub:repository method=official_api confidence=high

ActivityPub account

account

[email protected]

GET /v1/social?handle=Gargron%40mastodon.social&resources=activitypub:account method=public_endpoint confidence=high

Substack profile

profile

platformer

GET /v1/social?handle=platformer&resources=substack:profile method=public_profile confidence=high

Trust signals before you integrate

Transparent docs, authenticated requests, and visible reliability details make it easier to evaluate DomScan before you ship.

Service status API artifacts

OpenAPI, Swagger, Postman, CLI, SDK, and MCP links are one click away.

API keys Protected access

Authenticated endpoints use API keys with clear credit costs before you call them.

Free allowance Sign Up for Free

Start with 10,000 monthly credits and upgrade only when usage grows.

Active Example Request

Start from the curl and HTTP samples, then map the parameters into your application code.

Key Features

Multi-Platform

Check GitHub, Reddit, and more platforms.

Instant Results

Get availability status across all platforms in seconds.

Profile Links

Direct links to existing profiles for taken handles.

Summary Stats

Quick overview of available vs. taken platforms.

Brand Consistency

Ensure your brand name is available everywhere.

API Access

Integrate into your brand research workflow.

Combine with Domains

Check social handles alongside domain availability.

Example Request

GET /v1/social bash 
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social?handle=mycompany&platforms=github,reddit,youtube"
POST /v1/social/bulk bash 
curl -X POST "https://domscan.net/v1/social/bulk" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handles":["mycompany","myproduct"],"platforms":["github","reddit","youtube"]}'
GET /v1/social?resources=github:repository bash 
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social?handle=github%2Fdocs&resources=github%3Arepository"

Example Response

200 OK json 
{
  "handle": "mycompany",
  "availability": {
    "github": {
      "available": false,
      "profile_url": "https://github.com/mycompany",
      "checked": true,
      "requested": true,
      "method": "official_api",
      "confidence": "high",
      "latency_ms": 120,
      "evidence": { "source": "upstream" }
    },
    "reddit": {
      "available": true,
      "profile_url": null,
      "checked": true,
      "requested": true,
      "method": "public_endpoint",
      "confidence": "high",
      "latency_ms": 95,
      "evidence": { "source": "upstream" }
    },
    "youtube": {
      "available": true,
      "profile_url": null,
      "checked": true,
      "requested": true,
      "method": "public_profile",
      "confidence": "high",
      "latency_ms": 102,
      "evidence": { "source": "upstream" }
    }
  },
  "summary": {
    "available_count": 2,
    "unavailable_count": 1,
    "unknown_count": 0
  },
  "summary_v2": {
    "requested_count": 3,
    "checked_count": 3,
    "available_count": 2,
    "unavailable_count": 1,
    "unknown_count": 0,
    "not_supported_count": 0,
    "determinacy_rate": 1
  },
  "checked_at": "2025-01-05T12:00:00.000Z"
}

Frequently Asked Questions

Why should I check social handle availability?

Brand consistency matters. If your company is called "acme", ideally you want acme.com, @acme on social platforms, and /acme on GitHub. Checking early helps you pivot if needed.

Can I check multiple handles at once?

Yes. Send up to 10 handles to POST /v1/social/bulk, with an optional platform list. Bulk checks use the same per-handle credit rate as single checks.

Related Tools & Resources

View documentationTry the free toolExplore all APIs

HTTP Status Codes

We document the HTTP status codes you should handle so you can distinguish successful responses, auth issues, credits, rate limits, missing data, and upstream failures.

OK 200

Request successful

Bad Request 400

Invalid parameters

Unauthorized 401

Missing or invalid API key/session.

Payment Required 402

Not enough credits to run this request.

Too Many Requests 429

Rate limit exceeded

Check Social Handle Availability

Start Free View documentation Try the free tool