SEO Optimizer
APIリファレンス
SEOオプティマイザー
ページのオンページSEO、GEO/AI検索対応度、E-E-A-T信頼シグナルを分析します。JavaScriptのオプションレンダリング、キーワード/競合比較、Google Search Consoleデータに対応。
POST
/api/seo-optimizerasyncスキャンを開始 - オンページSEO、GEO、E-E-A-T、オプションのJSレンダリング
docsApiSeoOptimizer.scanCallout
リクエストボディ
{
"url": "https://example.com/page",
"keyword": "target keyword",
"competitorUrl": "https://competitor.com/page",
"renderJs": false
}レスポンス(即時)
{
"scanId": "clxyz..."
}サンプル
curl -X POST https://www.scanverra.com/api/seo-optimizer \
-H "X-API-Key: sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/page","keyword":"widgets"}'GET
/api/seo-optimizersynchronous完了後にスキャンのステータスと全結果を取得
クエリパラメータ
?id={scanId}レスポンス
{
"id": "clxyz...",
"status": "done",
"score": 88,
"pageData": {...},
"findings": [...],
"keywordAnalyses": [...],
"crawlability": {...},
"aiSuggestions": {...},
"competitorPageData": {...},
"competitorFindings": [...]
}statusはrunning、done、failedのいずれかです。pageData、findings、aiSuggestionsはstatusがdoneになって初めて値が入ります。
サンプル
curl "https://www.scanverra.com/api/seo-optimizer?id=clxyz..." \ -H "X-API-Key: sk_live_..."
オプションのリクエストフィールド
keyword: 配置・密度をチェックする対象キーワード(カンマ区切り)。competitorUrl: 同じレポート内でスキャンして比較する2つ目のURL。renderJs: trueに設定すると、先にヘッドレスブラウザでページをレンダリングします - 処理は遅くなりますが、React/Vue/SPAサイトで単純なfetchでは見逃されるコンテンツを取得できます。