ソーシャルハンドル可用性 APIリファレンス

リクエスト例

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))

レスポンス例

{
  "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 ステータスコード

• 200 成功
• 400 不正なリクエスト
• 401 未認証
• 402 支払いが必要
• 429 リクエスト過多