ライブ
サービスステータス
統合前に、現在のサービス稼働状況と文書化されたエラー応答を確認してください。
ウェブデータ
Hreflang検証API
HTMLとHTTPヘッダーからページのhreflangアノテーションを検証し、最大20件の代替ページを取得して、それぞれが相互にリンクしているかを確認します。無効なコード、x-defaultの欠落、自己参照の欠落、相互リンクの切れを検出できます。
カテゴリ
ウェブデータ
エンドポイント
1
主な機能
4
よくある質問
4
これらの企業の担当者に使われています
統合前に確認できる信頼シグナル
透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。
OpenAPI
API アーティファクト
OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。
API キー
保護されたアクセス
認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。
10,000
無料枠
毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。
この API で実装できること
このページを本番導入向けの概要として使えます。エンドポイント、例、レスポンス形状、DomScan を製品に組み込むためのワークフローをまとめています。
ドメイン確認、DNS インテリジェンス、リスクシグナル、エンリッチメントをオンボーディング、検索、社内ツールに組み込めます。
繰り返しの手動検索を、スケジュールジョブ、アラート、再現可能な調査手順に置き換えます。
提供元ページをスクレイピングせず、予測可能なフィールド、文書化済みステータスコード、クレジットコストを使えます。
OpenAPI、SDK、Postman、MCP を通じて、エージェント、ダッシュボード、SOAR プレイブック、CRM に接続できます。
統合ワークフロー
最初のリクエストから本番で繰り返し使える状態までのシンプルな流れです。
一度認証する
文書化されたヘッダーで API キーを送信し、サービス間で一貫したリクエストを保ちます。
例から問い合わせる
curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。
運用と監視
ステータスコード、クレジットコスト、レスポンスフィールドを使ってリトライ、ログ、アラートを構築します。
開発者キット
機械可読なドキュメント、リクエスト集、SDK、エージェント用ツールへすぐ移動できます。
パラメータとレスポンスのマップ
クライアントに接続する前に、入力、出力フィールド、ステータスコードを確認できます。
パラメータ
urlmax_alternates
レスポンス例
statusentriesself_referencex_defaultissuesreturn_linksreturn_links.checkedreturn_links.confirmedreturn_links.missingreturn_links.unknown
HTTP ステータスコード
200400401402429
エンドポイント
GET
/v1/hreflang
統合前に確認できる信頼シグナル
透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。
サービスステータス
API アーティファクト
OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。
API キー
保護されたアクセス
認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。
無料枠
無料でサインアップ
毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。
アクティブ
リクエスト例
curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。
主な機能
コードの検証
言語、スクリプト、地域のサブタグを確認し、en-GBの代わりにen-UKを使用する、ハイフンの代わりにアンダースコアを使用するといった、よくある誤りも検出します。
相互リンクのチェック
代替ページを取得して、このページへ相互にリンクしているかを確認し、リダイレクト、他のURLを指すcanonical、言語の不一致を検出します。
HTMLとHTTPヘッダー
アノテーションをlinkタグとHTTPのLinkヘッダーから読み取り、各エントリには検出された場所が表示されます。
セット全体の問題
自己参照の欠落、x-defaultの欠落、相対URL、1つのコードが複数のURLを指している問題を、セット全体に対して報告します。
リクエスト例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/hreflang?url=example.com/shoes/trail-runner"レスポンス例
{
"status": "ok",
"entries": [
{ "hreflang": "en", "url": "https://example.com/shoes/trail-runner", "valid_code": true },
{ "hreflang": "es-ES", "url": "https://example.com/es/zapatillas/trail-runner", "valid_code": true },
{ "hreflang": "x-default", "url": "https://example.com/shoes/trail-runner", "valid_code": true }
],
"self_reference": true,
"x_default": true,
"issues": [],
"return_links": { "checked": 1, "confirmed": 1, "missing": 0, "unknown": 0 }
}よくある質問
missing_return_linksとはどういう意味ですか？
少なくとも1つの代替ページが読み取られ、監査対象のページへ相互にリンクされていないことを示します。hreflangのアノテーションは相互になっている必要があり、そうでない場合は検索エンジンに無視されることがあります。
代替ページを読み取れない場合はどうなりますか？
相互リンクの欠落ではなく、理由付きの不明として報告されます。そのため、ブロックされたページや遅いページが誤ったエラーを生むことはありません。
XMLサイトマップのhreflangエントリも確認されますか？
このAPIが確認するのは、ページのHTMLとHTTPヘッダーです。サイトマップにhreflang拡張が含まれているかどうかは、サイトマップ監査APIで確認してください。
何クレジットかかりますか？
1回の監査につき3クレジットで、最大20件の代替ページの相互リンクチェックも含まれます。status unknownで終わった結果は返金されます。
関連ツールとリソース
HTTP ステータスコード
正常な応答、認証の問題、クレジット不足、レート制限、データ未検出、上流サービス障害を判別できるよう、クライアントで処理すべきHTTPステータスコードを明記しています。
成功
200
リクエスト成功
不正なリクエスト
400
無効なパラメータ
未認証
401
APIキーまたはセッションが不足しているか無効です。
支払いが必要
402
このリクエストを実行するためのクレジットが不足しています。
リクエスト過多
429
レート制限を超過