開発者向けリファレンス

クレジット&価格

DomScan APIでDomScan は月間 10,000 の無料クレジットを含みます。クレジットカード不要です。

クレジット&価格

DomScan は月間 10,000 の無料クレジットを含みます。クレジットカード不要です。

クレジットは登録記念日に毎月リフレッシュされます. さらにクレジットが必要ですか?期限切れにならないパックを購入します:

エンドポイント別クレジット

一般的なエンドポイントの料金は以下で確認できます。一部のリファレンスエンドポイントは無料です。機械可読形式の完全な料金表は /v1/pricing で確認してください。

エンドポイントクレジット説明
/v1/coverage 0 RDAPマッピングがあるTLDを一覧表示
/v1/tlds 0 TLD メタデータリスト
/v1/watchlist 1 ウォッチリストを表示
/v1/webhooks 2 Webhook エンドポイントに配信されたアラート 1 件あたりのクレジットです。配信に失敗した分は返金され、テストイベントは無料です。
/v1/status 1 ドメイン可用性を確認
/v1/health/quick 1 クイック健全性チェック
/v1/dns 1 DNS ルックアップ
/v1/dns/bulk 1/domain 一括DNSルックアップ(最大25ドメイン)
/v1/ip 1 IP ジオロケーション
/v1/value 2 ドメイン価値評価
/v1/prices 0-1/pair 登録価格
/v1/tlds/:tld 1 TLD 詳細
/v1/watchlist/check 1 ウォッチリスト項目をチェック
/v1/typos/permutations 1 タイポ置換
/v1/typos/score 1 タイポリスクスコア
/v1/email/check 1 メールブラックリストチェック
/v1/status/bulk 1/domain 複数のドメイン名の可用性を一度にチェックします。リクエストあたり最大 50 ドメインをサポートしています。
/v1/health 3 完全な健全性チェック
/v1/dns/all 2 すべての DNS レコード
/v1/profile 3 ドメインプロフィール
/v1/redirects 2 リダイレクトチェーン
/v1/tech 3-9 テックスタック検出
/v1/categorize 3 ウェブサイトカテゴリ化
/v1/similarity 2 ドメイン類似度
/v1/typos 2-3 タイポスクワッティング検出
/v1/reputation 3 ドメインレピュテーション
/v1/reputation/bulk 3/domain 一括ドメインレピュテーション(最大3ドメイン)
/v1/certificates 2 SSL 証明書
/v1/certificates/bulk 2/domain SSL 証明書
/v1/social 2 ソーシャルハンドルチェック
/v1/social/bulk 2/handle ソーシャルハンドルの一括チェック
/v1/company 3 企業ルックアップ
/v1/suggest 2-5 ドメイン提案
/v1/whois 3 WHOIS ルックアップ
/v1/whois/history 3 WHOIS変更履歴
/v1/whois/bulk 3/domain WHOIS一括検索(最大20ドメイン)
/v1/rdap/bulk 2/query WHOIS ルックアップ
/v1/prices/bulk 1/pair 一括価格設定
/v1/dns/security 3 DNS セキュリティ分析
/v1/dns/propagation 2 DNSリゾルバー比較
/v1/dns/propagation/bulk 2/domain DNSリゾルバー比較
/v1/email-auth/bulk 3/domain メール認証
/v1/hosting/bulk 3/domain ホスティング検出
/v1/value/bulk 2/domain 一括価値評価
/v1/health/bulk 3/domain 一括健全性チェック
/v1/subdomains 4-5 サブドメインファインダー
/v1/subdomains/bulk 4-5/domain サブドメインファインダー
/v1/report 5 包括レポート (個別呼び出しと比べて~10 クレジット節約)

クレジット制施行

クレジットがゼロに達すると、クレジットがかかるAPIリクエストはHTTP 402(支払い必須)を返します。無料ブラウザーベースのツールは影響を受けません。

HTTP 402 Payment Required
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}

さらにクレジットが必要ですか?期限切れにならないパックを購入します:

クレジットは登録記念日に毎月リフレッシュされます.

クレジット応答ヘッダー

認証されたすべてのAPI応答には、リクエスト後の現在のクレジット残高を示すX-Credits-Remainingヘッダーが含まれます。

X-Credits-Remaining: 9500

認証済みの /v1 レスポンスはすべて、エラーを含め、次のヘッダーを返します。

  • X-Credits-Charged: このリクエストで課金されたクレジット。同じリクエスト内で返金された分を差し引いた値です(課金なしの場合は0)。
  • X-Credits-Remaining: リクエスト後の残高。残高がまだ判明していないまれな場合は省略されます。
  • X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset: バースト容量、すぐに送信できる残りリクエスト数、容量が完全に回復するUnix時間(秒)。
  • HTTP経由のMCPは、各リクエスト内のツール呼び出しに対して X-Credits-Charged と X-Credits-Remaining を返します。

実行前にコストを見積もる

リクエストのメソッド、パス、クエリ、ボディを POST /v1/estimate に送信すると、課金されるクレジットが内訳と注記とともに返されます。何も実行されず、見積もり自体のコストは0クレジットです。最終的な課金額が結果に左右される場合、見積もりは上限となり、その理由が注記で説明されます。

POST /v1/estimate

リクエストボディ

パラメータタイプ説明
method 必須 string
許可された値 GETPOSTPUTPATCHDELETE
見積もり対象リクエストのHTTPメソッド。
path 必須 string 見積もり対象リクエストのパス。例: /v1/value/bulk。パス内のクエリ文字列も読み取られます。
query オプション object オブジェクト形式のクエリパラメータ。配列はカンマで連結されます。
body オプション any リクエストが送信するJSONボディ。

リクエスト例

curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'

レスポンス例

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["4xxステータスで拒否されたリクエストや5xxステータスで失敗したリクエストは、自動的に返金されます。"],
  "maximum": false,
  "rejected": false
}

レスポンスフィールド

フィールド タイプ
credits integer
breakdown[] object[]
breakdown[] object
breakdown[].component string
breakdown[].quantity integer
breakdown[].unit_credits number
breakdown[].credits integer
notes[] string[]
maximum boolean
rejected boolean
billing_model string
endpoint object
endpoint.method string
endpoint.path string
dry_run boolean

一括、比較、レシピ、価格のエンドポイントでも dry_run=true を使用できます。リクエストは実行もクレジット課金もされず、同じ見積もりに "dry_run": true を加えたものがHTTP 200で返されます。

クレジット計算機

一括操作のクレジット使用量を推定します:

必要な総クレジット
100
これは無料の月間クレジットの 1.0% に相当します

クレジットパック

さらにクレジットが必要ですか?期限切れにならないパックを購入します:

パック価格クレジットあたり
50,000クレジット €9 / £7.50 / ¥1,500 €0.00018
250,000クレジット €29 / £24 / ¥4,800 €0.000116
1,000,000クレジット €79 / £66 / ¥13,000 €0.000079