ドメイン検索レシピ API

Q: どのエンドポイントが含まれていますか？

このガイドでは 4 個の公開エンドポイントを扱います: POST /v1/domain-discovery/jobs , GET /v1/batches/:job_id , GET /v1/batches/:job_id/results , DELETE /v1/batches/:job_id .

Q: この API に認証は必要ですか？

はい。ドメイン検索レシピ を呼び出す際は、`X-API-Key` または `Authorization: Bearer` ヘッダーで API キーを送信してください。

Q: 完全なパラメータや関連エンドポイントはどこで確認できますか？

ドメイン検索レシピ の完全なドキュメントを使って、パラメータの詳細、認証に関する注意事項、同じ API ファミリー内の関連エンドポイントを確認してください。

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \ -H "X-API-Key: $DOMSCAN_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: discovery-com-io-1" \ -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

{ "job": { "id": "bat_...", "status": "queued", "total": 50, "status_url": "https://domscan.net/v1/batches/bat_...", "results_url": "https://domscan.net/v1/batches/bat_.../results" }, "discovery": { "page_words": 25, "tlds": ["com", "io"], "domain_checks": 50, "credits_per_domain": 1, "next_cursor": "..." } }

カテゴリ ドメイン検索・料金

エンドポイント 4

クレジット 0-1/item

認証 認証が必要です

素晴らしい企業の人々に使用されています

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

ライブ サービスステータス

統合前に、現在のサービス稼働状況と文書化されたエラー応答を確認してください。

OpenAPI API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

10,000 無料枠

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

この API で実装できること

このページを本番導入向けの概要として使えます。エンドポイント、例、レスポンス形状、DomScan を製品に組み込むためのワークフローをまとめています。

プロダクトワークフロー

ドメイン確認、DNS インテリジェンス、リスクシグナル、エンリッチメントをオンボーディング、検索、社内ツールに組み込めます。

アナリスト自動化

繰り返しの手動検索を、スケジュールジョブ、アラート、再現可能な調査手順に置き換えます。

クリーンな JSON データ

提供元ページをスクレイピングせず、予測可能なフィールド、文書化済みステータスコード、クレジットコストを使えます。

AI と運用ツール

OpenAPI、SDK、Postman、MCP を通じて、エージェント、ダッシュボード、SOAR プレイブック、CRM に接続できます。

統合ワークフロー

最初のリクエストから本番で繰り返し使える状態までのシンプルな流れです。

一度認証する

文書化されたヘッダーで API キーを送信し、サービス間で一貫したリクエストを保ちます。

例から問い合わせる

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

運用と監視

ステータスコード、クレジットコスト、レスポンスフィールドを使ってリトライ、ログ、アラートを構築します。

開発者キット

機械可読なドキュメント、リクエスト集、SDK、エージェント用ツールへすぐ移動できます。

OpenAPI スキーマ

クライアント生成やリクエスト/レスポンス形状の確認に使えます。

Postman コレクション

手動テストやチーム共有用のリクエストをすぐインポートできます。

SDK と CLI

ボイラープレートを書く代わりに、保守済みパッケージとコマンドラインワークフローを使えます。

MCP 統合

ドメインインテリジェンスを AI エージェントや社内アシスタントに公開します。

パラメータとレスポンスのマップ

クライアントに接続する前に、入力、出力フィールド、ステータスコードを確認できます。

リクエストパラメータ

パラメータ

tldslimitcursormin_lengthmax_lengthsingular_onlyjob_idafterformat

レスポンスフィールド

レスポンス例

jobjob.idjob.statusjob.totaljob.status_urljob.results_urldiscoverydiscovery.page_wordsdiscovery.tldsdiscovery.domain_checksdiscovery.credits_per_domaindiscovery.next_cursor

ステータス範囲

HTTP ステータスコード

200202400401402409429

エンドポイント

POST /v1/domain-discovery/jobs

クレジット: 1/item認証: 認証が必要です

tldslimitcursormin_lengthmax_lengthsingular_only

GET /v1/batches/:job_id

クレジット: 0認証: 認証が必要です

job_id

GET /v1/batches/:job_id/results

クレジット: 0認証: 認証が必要です

job_idafterlimitformat

DELETE /v1/batches/:job_id

クレジット: 0認証: 認証が必要です

job_id

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

サービスステータス API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

無料枠 無料でサインアップ

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

アクティブ リクエスト例

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

主な機能

エンドポイント

POST /v1/domain-discovery/jobs • GET /v1/batches/:job_id • GET /v1/batches/:job_id/results • DELETE /v1/batches/:job_id

パラメータ

tlds, limit, cursor, min_length, max_length, singular_only, job_id, after, format

HTTP ステータスコード

200, 202, 400, 401, 402, 409, 429

クレジット / 認証

0-1/item / 認証が必要です

リクエスト例

POST /v1/domain-discovery/jobs bash

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: discovery-com-io-1" \
  -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

レスポンス例

202 Accepted json

{
  "job": {
    "id": "bat_...",
    "status": "queued",
    "total": 50,
    "status_url": "https://domscan.net/v1/batches/bat_...",
    "results_url": "https://domscan.net/v1/batches/bat_.../results"
  },
  "discovery": {
    "page_words": 25,
    "tlds": ["com", "io"],
    "domain_checks": 50,
    "credits_per_domain": 1,
    "next_cursor": "..."
  }
}

よくある質問

どのエンドポイントが含まれていますか？

このガイドでは 4 個の公開エンドポイントを扱います: POST /v1/domain-discovery/jobs, GET /v1/batches/:job_id, GET /v1/batches/:job_id/results, DELETE /v1/batches/:job_id.

この API に認証は必要ですか？

はい。ドメイン検索レシピを呼び出す際は、`X-API-Key` または `Authorization: Bearer` ヘッダーで API キーを送信してください。

どれくらいのクレジットを使用しますか？

これらのガイドのリクエストは、エンドポイントに応じて 0-1/item クレジットを使用します。バルクエンドポイントでは、クレジットは標準のアイテム単位レートで計算されます。

完全なパラメータや関連エンドポイントはどこで確認できますか？

ドメイン検索レシピの完全なドキュメントを使って、パラメータの詳細、認証に関する注意事項、同じ API ファミリー内の関連エンドポイントを確認してください。

HTTP ステータスコード

正常な応答、認証の問題、クレジット不足、レート制限、データ未検出、上流サービス障害を判別できるよう、クライアントで処理すべきHTTPステータスコードを明記しています。

成功 200

リクエスト成功

受理済み 202

キャッシュ専用のサブドメイン要求でキャッシュ未命中となり、バックグラウンド更新を受理しました。クレジットは消費されません。Retry-After の時間後に再試行してください。

不正なリクエスト 400

無効なパラメータ

未認証 401

APIキーまたはセッションが不足しているか無効です。

支払いが必要 402

このリクエストを実行するためのクレジットが不足しています。

HTTP 409 409

リクエスト過多 429

レート制限を超過

毎月10,000クレジットを無料で利用できます。すべての公開APIを利用でき、必要なときだけクレジットを追加できます。

無料で開始ドキュメントを見る

サポート

ドメイン検索レシピ API

統合前に確認できる信頼シグナル

この API で実装できること

統合ワークフロー

開発者キット

パラメータとレスポンスのマップ

エンドポイント

統合前に確認できる信頼シグナル

主な機能

リクエスト例

レスポンス例

よくある質問

関連ツール＆リソース

HTTP ステータスコード