Identity & Verification · DomScan product

Social Handle Availability API

Check if a username is available across major social media platforms.

What you get

Check if a username is available across major social media platforms.

SynchronousBulkRESTMCPSDKInteractive tool

Choose this product when

Who it is for

Use the suite to improve form handling, prioritize manual review, enrich organizations, and connect website-declared assets.

Choose this product when

Choose this to classify supported public profiles or resources. Blocked, rate-limited, timeout, or ambiguous checks remain unknown and never prove claimability.

What you get

Check if a username is available across major social media platforms.

Endpoints

See what each endpoint accepts and returns, its modes and its limits before you integrate.

GET /v1/social View API reference
POST /v1/social/bulk View API reference
GET /v1/social/info View API reference

Credits and authentication

0-2 Authentication required. See the API reference for the exact cost, including any per-item pricing.

Example operation

Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.

GET /v1/social Credits: 2

Query parameters

Parameter Type required
handle string required
platforms string optional
resources string optional

Response fields

Field Type
handle string
checked_at string
availability object
resources object
resource_summary object
resource_summary.requested_count integer
resource_summary.checked_count integer
resource_summary.present_count integer
resource_summary.absent_count integer
resource_summary.unknown_count integer
resource_summary.cached_count integer
resource_summary.determinacy_rate number
summary object
summary.available_count integer
summary.unavailable_count integer
summary.unknown_count integer
summary_v2 object
summary_v2.requested_count integer
summary_v2.checked_count integer
summary_v2.available_count integer
summary_v2.unavailable_count integer
summary_v2.unknown_count integer
summary_v2.not_supported_count integer
summary_v2.determinacy_rate number
platform_summary object
platform_summary.requested_count integer
platform_summary.checked_count integer
platform_summary.available_count integer
platform_summary.unavailable_count integer
platform_summary.unknown_count integer
platform_summary.not_supported_count integer
platform_summary.cached_count integer
platform_summary.high_confidence_count integer
platform_summary.live_platform_count integer
platform_summary.experimental_count integer
platform_summary.blocked_count integer
platform_summary.beta_limited_count integer
platform_summary.determinacy_rate number
platform_summary.method_counts object
platform_summary.source_counts object
beta_notice string
meta object
meta.served_by string
meta.supported_platforms[] string[]
meta.supported_resources[] string[]
meta.unsupported_platforms[] string[]
meta.latency_ms integer

Example request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social?handle=myusername&platforms=github%2Cgitlab%2Cbitbucket%2Cdevto%2Chuggingface%2Cdribbble%2Csoundcloud%2Cgumroad%2Cbuymeacoffee%2Csubstack%2Citchio%2Chackernews%2Creddit%2Cbluesky%2Cpatreon%2Csnapchat%2Cyoutube&resources=github%3Arepository"
const response = await fetch("https://domscan.net/v1/social?handle=myusername&platforms=github%2Cgitlab%2Cbitbucket%2Cdevto%2Chuggingface%2Cdribbble%2Csoundcloud%2Cgumroad%2Cbuymeacoffee%2Csubstack%2Citchio%2Chackernews%2Creddit%2Cbluesky%2Cpatreon%2Csnapchat%2Cyoutube&resources=github%3Arepository", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/social?handle=myusername&platforms=github%2Cgitlab%2Cbitbucket%2Cdevto%2Chuggingface%2Cdribbble%2Csoundcloud%2Cgumroad%2Cbuymeacoffee%2Csubstack%2Citchio%2Chackernews%2Creddit%2Cbluesky%2Cpatreon%2Csnapchat%2Cyoutube&resources=github%3Arepository",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/social?handle=myusername&platforms=github%2Cgitlab%2Cbitbucket%2Cdevto%2Chuggingface%2Cdribbble%2Csoundcloud%2Cgumroad%2Cbuymeacoffee%2Csubstack%2Citchio%2Chackernews%2Creddit%2Cbluesky%2Cpatreon%2Csnapchat%2Cyoutube&resources=github%3Arepository", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/social?handle=myusername&platforms=github%2Cgitlab%2Cbitbucket%2Cdevto%2Chuggingface%2Cdribbble%2Csoundcloud%2Cgumroad%2Cbuymeacoffee%2Csubstack%2Citchio%2Chackernews%2Creddit%2Cbluesky%2Cpatreon%2Csnapchat%2Cyoutube&resources=github%3Arepository")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Example response

{
  "handle": "examplebrand",
  "checked_at": "2026-10-09T10:15:30.000Z",
  "availability": {
    "github": {
      "available": true,
      "profile_url": null,
      "checked": true,
      "method": "official_api",
      "confidence": "high",
      "latency_ms": 112,
      "evidence": {
        "source": "upstream"
      },
      "requested": true
    },
    "gitlab": {
      "available": false,
      "profile_url": "https://gitlab.com/examplebrand",
      "checked": true,
      "entity_type": "user",
      "canonical_handle": "examplebrand",
      "visibility": "public",
      "method": "official_api",
      "confidence": "high",
      "latency_ms": 96,
      "evidence": {
        "source": "upstream"
      },
      "requested": true
    },
    "reddit": {
      "available": null,
      "profile_url": null,
      "checked": false,
      "reason": "not_requested",
      "method": "public_endpoint",
      "confidence": "high",
      "latency_ms": 0,
      "evidence": {
        "source": "not_requested"
      },
      "requested": false
    }
  },
  "resources": {},
  "resource_summary": {
    "requested_count": 0,
    "checked_count": 0,
    "present_count": 0,
    "absent_count": 0,
    "unknown_count": 0,
    "cached_count": 0,
    "determinacy_rate": 0
  },
  "summary": {
    "available_count": 1,
    "unavailable_count": 1,
    "unknown_count": 34
  },
  "summary_v2": {
    "requested_count": 2,
    "checked_count": 2,
    "available_count": 1,
    "unavailable_count": 1,
    "unknown_count": 0,
    "not_supported_count": 0,
    "determinacy_rate": 1
  },
  "platform_summary": {
    "requested_count": 2,
    "checked_count": 2,
    "available_count": 1,
    "unavailable_count": 1,
    "unknown_count": 0,
    "not_supported_count": 0,
    "cached_count": 0,
    "high_confidence_count": 2,
    "live_platform_count": 2,
    "experimental_count": 0,
    "blocked_count": 0,
    "beta_limited_count": 0,
    "determinacy_rate": 1,
    "method_counts": {
      "official_api": 2
    },
    "source_counts": {
      "upstream": 2
    }
  },
  "beta_notice": "This endpoint is in beta. Supported platforms and coverage may expand as new checkers graduate to production.",
  "meta": {
    "supported_platforms": [
      "github",
      "gitlab",
      "bitbucket"
    ],
    "supported_resources": [
      "reddit:subreddit",
      "github:repository",
      "gitlab:project"
    ],
    "unsupported_platforms": [],
    "latency_ms": 412
  }
}

HTTP status codes

  • 200 OK
  • 400 Bad Request
  • 401 Unauthorized
  • 402 Payment Required
  • 429 Too Many Requests

Frequently asked questions

Where can I find the Social Handle Availability request and response reference?

Use the API reference for Social Handle Availability to review parameters, response fields, examples, status codes, and supported operation modes.

How should I interpret unknown or incomplete results from Social Handle Availability?

Unknown or partial means we could not fully confirm the result. Keep the status, confidence, freshness and any limits in mind when you act on it.

How is Social Handle Availability priced?

The price depends on the check and the mode you choose. The API reference shows the current credit cost, whether you need an API key, and any per-item pricing.

Used by people at these companies

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse