はじめに

Ahrefs API を使えば、Ahrefs ワークスペースのデータを活用して、カスタム統合や自動化を構築できます。現在、API v3 では、サイトエクスプローラー、キーワードエクスプローラー、SERP の概要、ランクトラッカー、サイト監査、ブランドレーダー、ソーシャルメディア管理の各エンドポイントからデータを取得できるほか、ランクトラッカーのプロジェクトやキーワードエクスプローラーのリストを管理することもできます。

サイトエクスプローラー：概要統計と過去のチャート、被リンク、オーガニックおよび有料トラフィックのレポート
キーワードエクスプローラー：単一キーワードまたはキーワードリストの指標、検索ボリューム履歴と国別検索ボリューム、キーワードアイデアのレポート
サイト監査：プロジェクトのヘルススコア、問題の詳細レポート、クロールしたページのコンテンツ
SERP の概要：SERP 上位100件の結果
ランクトラッカー：プロジェクトの概要、競合レポート、ランクトラッカーの SERP
バッチ分析：リクエスト1回につき最大100件のターゲットの指標
ブランドレーダー：ブランドの概要統計、過去のパフォーマンスチャート、複数の AI エージェントにまたがる引用付きの実際のプロンプト
ソーシャルメディア管理：接続されたソーシャルメディアアカウントのチャネル、投稿、アクティビティ履歴、および指標
管理：ランクトラッカーのプロジェクトとキーワードエクスプローラーのリストを管理するためのエンドポイント
サブスクリプション情報：API の制限と使用状況
公開エンドポイント：当社クローラーの IP アドレスと範囲

利用資格

Ahrefs API は、対象となる有料プランで利用できます。その他のすべてのプランでも、無料テストクエリの限定セットにアクセスできます。

プランの上限

無料テストクエリと Rank Tracker、Management、Public、および その他一部 のエンドポイントを除くすべてのリクエストは、API ユニットを消費します。コストは、レスポンスの行数とリクエストしたフィールドによって決まります。どのリクエストでも最小コストは 50 ユニットです。エンドポイントが無料の場合は、ドキュメントページにその旨の注記が表示されます。無料でない場合はユニットを消費します。

API キー

Ahrefs APIにリクエストを送信するには、APIキーが必要です。 APIキーを作成・管理できるのは、ワークスペースのオーナーと管理者のみです。これは、アカウント設定 / APIキーで行えます。

関連ガイド：APIキーの作成と管理

基本的な使い方

AhrefsレポートのこれらのAPIボタンで、手軽に始められます。クリックすると、リクエストがcURLコマンドとして表示されます。

API button

これらのボタンはクエリビルダーとしても使えます。レポートに適用したフィルターに応じて、cURLコマンドが動的に更新されるためです。

cURLには、現在のレポートに表示されているすべてのフィールドと指標が含まれている点に注意してください。不要なフィールドを削除すれば、リクエストのコストを抑えられます。

詳細な使い方については、このドキュメント内のAPIリファレンスをご覧ください。このリファレンスには、各エンドポイントのリクエスト／レスポンス形式を示すOpenAPI互換の仕様が含まれています。

レート制限

Ahrefs APIは、デフォルトで1分あたり60リクエストに制限されています。この上限を超えると、APIはHTTP 429ステータスコード（Too Many Requests）を返します。

また、最適なパフォーマンスとシステムの安定性を維持するため、スロットリングにより、同じHTTP 429ステータスコードでAPIリクエストが拒否されることがあります。スロットリングは、リアルタイムのシステム負荷、リソースの可用性、リクエストの計算負荷に応じて動的に発生します。