Skip to content
SEO Optimizer is live, Audit on page SEO and AI-search readiness. Try it free
Scanverra
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": [...]
}

statusrunningdonefailedのいずれかです。pageDatafindingsaiSuggestionsstatusdoneになって初めて値が入ります。

サンプル

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では見逃されるコンテンツを取得できます。