Sosyal Kullanıcı Adı Erişilebilirliği API ürünü
Bir kullanıcı adının başlıca sosyal medya platformlarında kullanılabilir olup olmadığını kontrol edin. Doğru uç noktayı seçmek ve tam olarak ne döndürdüğünü görmek için bu referansı kullanın.
İşlemler
GET /v1/social
GET
/v1/social
Kredi: 2
Sorgu parametreleri
| Parametre | Tür | gerekli |
|---|---|---|
| handle | string | gerekli |
| platforms | string | isteğe bağlı |
| resources | string | isteğe bağlı |
Yanıt alanları
| Alan | Tür |
|---|---|
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 |
Örnek istek
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))Örnek yanıt
{
"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 durum kodları
200OK400Hatalı İstek401Yetkisiz402Ödeme Gerekli429Çok Fazla İstek
POST /v1/social/bulk
POST
/v1/social/bulk
Kredi: 2/item
Sorgu parametreleri
| Parametre | Tür | gerekli |
|---|---|---|
| dry_run |
string
İzin verilen değerler
true
|
isteğe bağlı |
Gövde parametreleri
| Parametre | Tür | gerekli |
|---|---|---|
| handles | string[] | gerekli |
| platforms | string[] | isteğe bağlı |
| resources | string[] | isteğe bağlı |
Yanıt alanları
| Alan | Tür |
|---|---|
results[] |
unknown[] |
summary |
object |
summary.total |
integer |
summary.succeeded |
integer |
summary.failed |
integer |
beta_notice |
string |
meta |
object |
meta.served_by |
string |
meta.platforms[] |
string[] |
meta.resources[] |
string[] |
meta.max_handles |
integer |
meta.credits_per_handle |
integer |
meta.credits_required |
integer |
meta.latency_ms |
integer |
Örnek istek
curl -X POST "https://domscan.net/v1/social/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"handles": [
"mycompany",
"myproduct"
],
"platforms": [
"github",
"reddit",
"youtube"
]
}'const response = await fetch("https://domscan.net/v1/social/bulk", {
method: "POST",
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"handles": [
"mycompany",
"myproduct"
],
"platforms": [
"github",
"reddit",
"youtube"
]
}),
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.post(
"https://domscan.net/v1/social/bulk",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
json={
"handles": [
"mycompany",
"myproduct",
],
"platforms": [
"github",
"reddit",
"youtube",
],
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"handles": [
"mycompany",
"myproduct"
],
"platforms": [
"github",
"reddit",
"youtube"
]
}`)
req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/social/bulk", body)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
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/bulk")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
"handles" => [
"mycompany",
"myproduct"
],
"platforms" => [
"github",
"reddit",
"youtube"
]
})
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))Örnek yanıt
{
"results": [
{
"handle": "mycompany",
"availability": {
"github": {
"available": false,
"profile_url": "https://github.com/mycompany",
"checked": true,
"requested": true,
"method": "official_api",
"confidence": "high"
}
},
"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": 0,
"unavailable_count": 1,
"unknown_count": 0
},
"checked_at": "2026-07-09T20:45:00.000Z"
},
{
"handle": "myproduct",
"availability": {
"github": {
"available": true,
"profile_url": null,
"checked": true,
"requested": true,
"method": "official_api",
"confidence": "high"
}
},
"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": 0,
"unknown_count": 0
},
"checked_at": "2026-07-09T20:45:00.000Z"
}
],
"summary": {
"total": 2,
"succeeded": 2,
"failed": 0
},
"beta_notice": "Social handle checks are in beta; verify critical results directly.",
"meta": {
"served_by": "pop=MAD country=ES",
"platforms": [
"github"
],
"resources": [],
"max_handles": 10,
"credits_per_handle": 2,
"credits_required": 4,
"latency_ms": 420
}
}
HTTP durum kodları
200OK400Hatalı İstek401Yetkisiz402Ödeme Gerekli409HTTP 409422HTTP 422429Çok Fazla İstek
GET /v1/social/info
GET
/v1/social/info
Kredi: 0
Yanıt alanları
| Alan | Tür |
|---|---|
endpoint |
string |
description |
string |
parameters |
object |
bulk |
object |
bulk.endpoint |
string |
bulk.method |
string |
bulk.max_handles |
integer |
bulk.credits_per_handle |
integer |
bulk.pricing_formula |
string |
bulk.bulk_discount |
boolean |
bulk.invalid_handles_charged |
boolean |
bulk.partial_results |
boolean |
bulk.parameters |
object |
bulk.example_request |
object |
platforms |
object |
platforms.supported[] |
string[] |
platforms.coming_soon[] |
string[] |
platforms.experimental[] |
string[] |
platforms.planned[] |
string[] |
platforms.blocked[] |
string[] |
platforms.details[] |
object[] |
platforms.details[] |
object |
platforms.details[].id |
string |
platforms.details[].display_name |
string |
platforms.details[].aliases[] |
string[] |
platforms.details[].category |
string |
platforms.details[].tier |
integer |
platforms.details[].status |
string |
platforms.details[].method |
string |
platforms.details[].confidence |
string |
platforms.details[].logo_key |
string |
platforms.details[].profile_url_template |
string | null |
platforms.details[].docs_anchor |
string |
platforms.details[].caveat_codes[] |
string[] |
platforms.details[].cache_ttl_s |
object |
platforms.details[].cache_ttl_s.available |
integer |
platforms.details[].cache_ttl_s.taken |
integer |
platforms.details[].cache_ttl_s.unknown |
integer |
platforms.details[].cache_ttl_s.rate_limited |
integer |
platforms.details[].handle_rules |
object |
platforms.details[].handle_rules.min_length |
integer |
platforms.details[].handle_rules.max_length |
integer |
platforms.details[].handle_rules.description |
string |
resource_types |
object |
resource_types.supported[] |
string[] |
resource_types.details[] |
object[] |
resource_types.details[] |
object |
example_request |
string |
resource_example_request |
string |
example_response |
object |
Örnek istek
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/social/info"const response = await fetch("https://domscan.net/v1/social/info", {
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/info",
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/info", 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/info")
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))Örnek yanıt
{
"endpoint": "/v1/social",
"description": "Check if a username is available on supported social platforms.",
"parameters": {
"handle": {
"type": "string",
"required": true,
"description": "Username to check"
},
"platforms": {
"type": "string",
"required": false,
"description": "Comma-separated platform list",
"example": "github,gitlab,reddit"
},
"resources": {
"type": "string",
"required": false,
"description": "Comma-separated resource type list",
"example": "github:repository"
}
},
"bulk": {
"endpoint": "/v1/social/bulk",
"method": "POST",
"max_handles": 10,
"credits_per_handle": 2,
"pricing_formula": "valid_handle_count * credits_per_handle",
"bulk_discount": false,
"invalid_handles_charged": false,
"partial_results": true,
"parameters": {
"handles": {
"type": "array",
"required": true,
"min_items": 1,
"max_items": 10
},
"platforms": {
"type": "array",
"required": false
},
"resources": {
"type": "array",
"required": false
}
},
"example_request": {
"handles": [
"mycompany",
"myproduct"
],
"platforms": [
"github",
"reddit",
"youtube"
]
}
},
"platforms": {
"supported": [
"github",
"gitlab",
"bitbucket",
"devto",
"huggingface",
"dribbble",
"soundcloud",
"gumroad",
"buymeacoffee",
"substack",
"itchio",
"behance",
"dockerhub",
"hashnode",
"rubygems",
"hackernews",
"reddit",
"bluesky",
"twitter",
"instagram",
"facebook",
"threads",
"pinterest",
"snapchat",
"telegram",
"twitch",
"patreon",
"tiktok",
"youtube",
"linkedin",
"steam",
"tumblr",
"vimeo",
"letterboxd",
"linktree",
"kick",
"medium",
"mastodon",
"roblox",
"minecraft",
"chesscom",
"lichess",
"npm",
"discord",
"keybase",
"codeforces",
"gitee",
"lemmy",
"farcaster",
"opencollective"
],
"coming_soon": [],
"experimental": [],
"planned": [],
"blocked": [],
"details": [
{
"id": "github",
"display_name": "GitHub",
"aliases": [
"github"
],
"category": "developer",
"tier": 0,
"status": "live",
"method": "official_api",
"confidence": "high",
"logo_key": "github",
"profile_url_template": "https://github.com/{handle}",
"docs_anchor": "github",
"caveat_codes": [],
"cache_ttl_s": {
"available": 300,
"taken": 3600,
"unknown": 60,
"rate_limited": 60
},
"handle_rules": {
"min_length": 1,
"max_length": 39,
"description": "1-39 chars, alphanumeric and hyphens, cannot start/end with hyphen"
}
}
]
},
"resource_types": {
"supported": [
"reddit:subreddit",
"discord:invite",
"github:repository",
"gitlab:project",
"dockerhub:repository",
"activitypub:account",
"substack:profile"
]
},
"example_request": "/v1/social?handle=myusername&platforms=github,gitlab,reddit",
"resource_example_request": "/v1/social?handle=github/docs&resources=github:repository",
"example_response": {
"handle": "myusername",
"checked_at": "2026-07-14T12:00:00Z",
"availability": {
"github": {
"available": true,
"profile_url": null,
"checked": true,
"requested": true
},
"reddit": {
"available": false,
"profile_url": "https://reddit.com/user/myusername",
"checked": true,
"requested": true
},
"gitlab": {
"available": true,
"profile_url": null,
"checked": true,
"requested": true
}
},
"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": 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
}
}
}
HTTP durum kodları
200OK401Yetkisiz429Çok Fazla İstek