ウェブデータ

構造化データ検証API

ページからJSON-LD、Microdata、RDFaのすべての項目を抽出し、最も一般的なリッチリザルトのタイプに対するschema.orgのプロパティルールで検証します。エラー、警告、修正が必要なプロパティを正確に取得できます。

カテゴリ ウェブデータ
エンドポイント 1
主な機能 4
よくある質問 4

これらの企業の担当者に使われています

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

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

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に 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 に接続できます。

統合ワークフロー

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

1
一度認証する

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

2
例から問い合わせる

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

3
運用と監視

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

開発者キット

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

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

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

リクエストパラメータ

パラメータ

urlrender
レスポンスフィールド

レスポンス例

statussummarysummary.json_ldsummary.microdatasummary.rdfasummary.total_itemssummary.errorssummary.warningstypesitems
ステータス範囲

HTTP ステータスコード

200400401402429

エンドポイント

GET /v1/structured-data
クレジット: 2-6認証: 認証が必要です

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

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

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

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

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

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

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

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

アクティブ リクエスト例

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

主な機能

3つの形式に対応

@graphを展開したJSON-LDブロック、Microdataの項目、RDFaの項目を取得し、オファー、評価、著者などのネストされたオブジェクトは子要素として保持されます。

リッチリザルトのルール

Product、Offer、Article、Organization、LocalBusiness、BreadcrumbList、FAQPage、Event、Recipe、VideoObject、JobPostingなど、26種類のタイプの必須プロパティと推奨プロパティを検証します。

値のチェック

日付、価格、評価、URLの形式を確認し、無効なJSONやschema.org以外のコンテキストは、ブロック全体に対して報告されます。

レンダリング後のマークアップ

render=trueを指定すると、タグマネージャーやJavaScriptフレームワークがページの読み込み後に挿入する構造化データを読み取れます。

リクエスト例

GET /v1/structured-data?url=example.com/shoes/trail-runner bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/structured-data?url=example.com/shoes/trail-runner"

レスポンス例

200 OK json
{
  "status": "ok",
  "summary": { "json_ld": 2, "microdata": 1, "rdfa": 0, "total_items": 9, "errors": 1, "warnings": 5 },
  "types": ["AggregateRating", "BreadcrumbList", "ListItem", "Offer", "Product", "Review"],
  "items": [
    {
      "format": "json-ld",
      "types": ["Product"],
      "status": "warnings",
      "errors": [],
      "warnings": [{ "code": "missing_recommended", "property": "description" }]
    }
  ]
}

よくある質問

これはリッチリザルトの適格性テストと同じものですか?

いいえ。公開されているschema.orgのプロパティルールに照らしてマークアップを確認するものです。表示の可否は検索エンジンが独自のポリシーと品質シグナルで判断するため、有効な項目であってもリッチリザルトが保証されるわけではありません。

ルールのないタイプはどうなりますか?

すべてのプロパティを含めて抽出され、status uncheckedとして返されるため、誤ったエラーなしで内容を確認できます。

プロパティの値を確認できますか?

はい。すべての項目に、プロパティの一覧と、各テキスト値の最初の200文字のプレビューが含まれます。

何クレジットかかりますか?

生のHTMLは2クレジット、render=trueの場合は6クレジットです。status unknownで終わった結果は返金されます。

関連ツールとリソース

HTTP ステータスコード

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

成功 200

リクエスト成功

不正なリクエスト 400

無効なパラメータ

未認証 401

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

支払いが必要 402

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

リクエスト過多 429

レート制限を超過