DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API マイクロデータ
クロール済みの 1 つの url の構造化データを検証します。完了したクロールを読み取るため、post_dataforseo_on_page_submit が返す id が必要です。crawl_progress と、max_crawl_pages・pages_in_queue・pages_crawled を含む crawl_status を返します。少ない結果を信じる前にこれらを確認してください。実行中のクロールは報告できる内容が少ないだけです。⚠️ そのページはクロールに含まれていた必要があります。含まれない URL を要求すると、HTTP 200 の中で status_code 40406、Requested page was not submitted for crawling が返ります。目的のページがない場合は max_crawl_pages を増やすか、送信呼び出しで start_url を設定してください。💰 アップストリームは無料：完了したクロールの照会には費用がかからず、費用がかかるのはクロール自体だけです。
料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.012 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- id型: string
- tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - url型: string
リソースの URL
必須フィールド
この URL は、Pages エンドポイントのレスポンスで取得できます
例：https://dataforseo.com/apis
- 型: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_OnPageMicrodataTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- crawl型: string | null
_progress クロールセッションのステータス
可能な値：in_progress、finished - crawl型: object | null · Response36Afe1097B20_CrawlStatusInfo
_status クロールセッションの詳細
- max型: integer | null 形式: int64
_crawl _pages クロールするページ数の上限 タスク設定時に指定した max_crawl_pages の制限を示します
- pages型: integer | null 形式: int64
_crawled クロール済みのページ数
- pages型: integer | null 形式: int64
_in _queue 現在クロールキューにあるページ数
- items型: array (object | null)[] | null
項目の配列
- inspection型: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info マイクロデータ検証に関する情報
- fields型: array (object | null)[] | null
マイクロデータ フィールド
特定のマイクロデータ型に関連するデータ フィールドを含むオブジェクトの配列- fields型: array (object | null)[] | null
マイクロデータ フィールド
特定のマイクロデータ型に関連するデータ フィールドを含むオブジェクトの配列- fields型: array (object | null)[] | null
マイクロデータ フィールド
特定のマイクロデータ型に関連するデータ フィールドを含むオブジェクトの配列 - name型: string | null
フィールド名
データ フィールドの名前 - test型: object | null · Response36Afe1097B20_MessageInfo
_results マイクロデータ検証テストの結果
検出されたエラーと関連メッセージを含む、マイクロデータのサブタイプ テスト結果- level型: string | null
エラーのレベル 次の値を取ることができます：fatal、error、warning、info
- message型: string | null
エラーに関連付けられたメッセージ 検出されたエラーの詳細を提供するメッセージ
- types型: array (string | null)[] | null
マイクロデータ型のリスト
- value型: string | null
マイクロデータ値 対象のウェブページで指定されたマイクロデータ値
- name型: string | null
フィールド名
データ フィールドの名前 - test型: object | null · Response36Afe1097B20_MessageInfo
_results マイクロデータ検証テストの結果
検出されたエラーと関連メッセージを含む、マイクロデータのサブタイプ テスト結果- level型: string | null
エラーのレベル 次の値を取ることができます：fatal、error、warning、info
- message型: string | null
エラーに関連付けられたメッセージ 検出されたエラーの詳細を提供するメッセージ
- types型: array (string | null)[] | null
マイクロデータ型のリスト
- value型: string | null
マイクロデータ値 対象のウェブページで指定されたマイクロデータ値
- types型: array (string | null)[] | null
- type型: string | null
要素の種類
- items型: integer | null 形式: int64
_count 結果配列内の項目数
- test型: object | null · Response36Afe1097B20_TestSummary
_summary マイクロデータ検証テストの結果
- error型: integer | null
重大なマイクロデータエラーの数
- fatal型: integer | null
致命的なマイクロデータエラーの数
- info型: integer | null
マイクロデータ情報フラグの数
- warning型: integer | null
マイクロデータ警告の数
- result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/microdata \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "02241700-1535-0216-0000-034137259bc1",
"url": "https://dataforseo.com/apis"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"test_summary": {
"fatal": null,
"error": null,
"warning": null,
"info": null
},
"items_count": null,
"items": [
{
"type": null,
"inspection_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}