トピック
API + MCPこのエンドポイントは、リクエスト1回あたり基本で1000ユニットを消費し、スコアリング対象のURLをリクエストした場合はさらに500ユニットを消費します。
分析は、キーワードで現在上位にランクインしているページに対してオンデマンドで実行されるため、キーワードに対する最初のリクエストには数秒かかります。結果はキャッシュされ、以降のリクエストはキャッシュから無料で返されます。
使用するのはAhrefsがすでに収集済みのSERPのみで、新たにSERPを収集することはありません。キーワードと国について過去90日以内にSERPを収集している場合、このエンドポイントは
400エラーを返し、ユニットは消費されません。
クエリパラメータ
SERPを分析する対象のキーワード。
2文字の国コード（ISO 3166-1 alpha-2）。
分析する上位ページ数。ページ数を減らすと、網羅性は下がる代わりに分析が速くなります。
（500ユニット）同じトピックに照らしてスコアリングするご自身のページ。たとえば、執筆中の下書きや改善したいページなどです。ページはリアルタイムで取得されます。毎回、追加のAPIユニットが消費されます（スコアリング結果はキャッシュされません）。
出力形式。
応答
分析できたページにおける、このトピックの平均カバレッジスコア（0〜100）。値が高いほど、すでにランクインしているページでそのトピックが十分にカバーされていることを意味します。どのページも分析できなかった場合はnullになります。
競合ページから特定された、コアトピックの概要。
このトピックのページ別カバレッジ：url、position（そのページのSERP順位）、score（0〜100）、extracts（トピックをカバーしているページ内の抜粋）をフィールドに持つレコードです。コンテンツを取得できなかったページでは、scoreはnull、extractsは空になります。これはスコアが0のページとは別物です。
分析したページのうち、このトピックを少しでもカバーしている（スコアが0ではない）ページ数。
分析対象のSERPが収集された日付。
target_urlとして指定されたページがこのトピックをどのようにカバーしているか。target_urlが指定されていない場合はnullになります。
上位ページでカバーされているコアトピック名。