Docs
ドキュメントを検索...⌘K

変更履歴

2026年9月15日

ウェブアナリティクス API エンドポイントの source_channel 列挙型から unknown の値が削除されました。 unknown で引き続きフィルタリングしているリクエストは、referral として扱われます。

2026年9月4日

新しいコンテンツヘルパーのトピックエンドポイントをリリースしました。キーワードに対して上位表示されているページが扱っているトピックを特定し、それらに照らして対象URLをスコアリングできます。

サイトエクスプローラーAPIのエンドポイントにおけるtraffic_modeのデフォルト値が、staticからadaptiveに変更されました。以前のオーガニックトラフィックの計算モデルを引き続き使用するには、明示的にtraffic_mode=staticを指定してください。

2026年9月2日

search_volume_type=keyword_volume オプションは、2026年9月30日までブランドレーダー API エンドポイントで引き続き利用できます。それ以降は、すべてのリクエストでAI調整済みボリュームが使用されます。

2026年8月31日

ブランドレーダーのプロンプト エンドポイント が、各プロンプトの tags フィールドを返すようになりました。新しい ブランドレーダーのプロンプトを更新するエンドポイント では、プロンプトに割り当てられた国とタグを更新できます。

2026年8月27日

SA プロジェクトの問題エンドポイント が、問題カテゴリーとして AI Discoverability を返すようになりました。

2026年8月26日

SE AI レスポンス数エンドポイント が、select 内の all_platforms をサポートし、統合された citations と pages の件数を返すようになりました。

substring および isubstring のフィルター演算子は、ブランドレーダー API エンドポイントの search_queries フィールドではサポートされなくなりました。代わりに phrase_match または iphrase_match を使用してください。

2026年8月24日

SE クロール済みページエンドポイント が、languages、page_category、page_type、publish_date フィールドを返すようになりました。これらのフィールドは、選択、フィルタリング、並び替えにも使用できます。

2026年8月20日

バッチ分析エンドポイント が top_countries パラメータをサポートし、org_traffic_top_by_country フィールドで最大10か国を返せるようになりました。

2026年8月19日

substring および isubstring のフィルター演算子は、ブランドレーダー API エンドポイントの topic フィールドではサポートされなくなりました。代わりに phrase_match または iphrase_match を使用してください。

2026年8月10日

無料のドメインレーティングのエンドポイントでAPIキーが必要になりました。リクエストは引き続き無料で、APIユニットも消費しません。レスポンスから、未認証アクセスに関するwarningフィールドが削除されました。

2026年8月7日

SMM投稿メトリクスのエンドポイントは、YouTube投稿のコメント数を含むyoutube_metricsフィールドを返すようになりました。

2026年8月4日

SE の Metrics、Metrics by country、Metrics history、Organic competitors、オーガニックキーワード、Pages by traffic、上位ページ の各エンドポイントに、traffic_mode パラメータが追加されました。これにより、オーガニックトラフィックの計算モードとして static（デフォルト）または adaptive を選択でき、オーガニックトラフィックとトラフィック値に影響します。

2026年7月31日

新しい ドメインレーティング別上位ドメインエンドポイント がリリースされました。ドメインレーティングで順位付けされた上位 100万件のドメインを返し、from と to を使って順位範囲を指定してリクエストできます。

2026年7月30日

SE 上位ページ エンドポイント では、AI プラットフォームごとの AI による引用数（ai_responses_chatgpt、ai_responses_copilot、ai_responses_gemini、ai_responses_google_ai_mode、ai_responses_google_ai_overviews、ai_responses_grok、ai_responses_perplexity）が返されるようになりました。

2026年7月29日

SE オーガニックキーワード エンドポイント では、CSV は output の受け付け可能な値ではなくなりました。サポートされる値は json、php、xml です。

2026年7月27日

KE Overview エンドポイント の target_mode パラメータは mode に名称変更されました。

2026年7月24日

Update project エンドポイント で folder 操作が利用可能になり、folder_id を使ってプロジェクトをフォルダに移動したり、フォルダツリーから削除したりできるようになりました。

2026年7月14日

新しいプロジェクトの削除エンドポイントがリリースされ、project_ids パラメータを使用してプロジェクトを削除できるようになりました。

2026年7月13日

  • Claude が、ブランドレーダーのすべてのエンドポイントでデータソースとして利用できるようになりました。
  • SERP の概要エンドポイント で、SERP の機能別に結果を絞り込むための type パラメータがサポートされるようになりました。

2026年7月8日

  • ブランドレーダーの AI responses、Cited domains、Cited pages エンドポイントに、検出されたものの引用されていないブランドに一致する brand_filter フィルターが追加されました。
  • SA Page Explorer エンドポイント が、許可およびブロックされている AI 検索ボット／トレーニングボットのフィールドを返すようになりました。

2026年6月26日

SMM Post metrics エンドポイント に TikTok の指標が含まれるようになりました。

2026年6月25日

SE ドメインレーティングエンドポイント から protocol パラメータが削除されました。

2026年6月23日

Projects エンドポイント が folder フィールドを返すようになり、Create project エンドポイント では folder_id を受け付けてプロジェクトをフォルダーに配置できるようになりました。

2026年6月22日

新しい SE AI responses count エンドポイント がリリースされました。ターゲットに言及している AI 応答の数を返します。

2026年6月11日

ブランドレーダーの Citations エンドポイントがリリースされました：

2026年6月8日

新しい無料の ドメインレーティングエンドポイント がリリースされました。サブスクリプションなしで、指定したドメインのドメインレーティングを返します。

2026年5月29日

ランクトラッカーのプロジェクト内キーワードのタグを管理する API エンドポイントをリリースしました：

2026年5月27日

API と MCP の使用上限が引き上げられました。各プランの最新の上限については、料金ページをご覧ください。

2026年5月25日

ブランドレーダーのレポートエンドポイント全体で、2 つの追加データソース google_ai_mode_keywords と google_ai_overviews_keywords が有効になりました。これらは、プロンプトではなく Google 検索クエリ（キーワード）から算出した AIによる概要／AI Mode の可視性をレポートします。

2026年5月22日

新しい RT Competitors Domains エンドポイント がリリースされました。ランクトラッカーのプロジェクトについて、ドメイン別の競合指標を返します。

2026年5月18日

2026年5月15日

ブランドレーダーのレポートエンドポイントの更新：

2026年5月13日

ライト+プランで、ダイレクト API アクセスが利用できるようになりました！

管理エンドポイントの更新：

2026年5月11日

ソーシャルメディアの投稿を管理するエンドポイントをリリースしました：

2026年5月6日

ブランドレーダーの POST エンドポイントで、リクエストボディ内の tags_filter フィルターを使って、タグで結果を絞り込めるようになりました。例：AI 応答。

2026年4月27日

GSC Keywords エンドポイントで、新しい keyword_lists および keyword_list_id パラメータを使ってキーワードリストでフィルタリングできるようになり、keyword_list_labels フィールドも返すようになりました。

2026年4月24日

Grok が、ブランドレーダーのすべてのエンドポイントでデータソースとして利用できるようになりました。

2026年4月20日

ソーシャルメディア API がリリースされ、ソーシャルメディアマネージャーの UI で利用できるものと同じレポートにプログラムからアクセスできるようになりました。

2026年4月17日

ブランドレーダー API エンドポイントが、既存の GET エンドポイントの POST 版を通じて、ブランドバリエーションとブランド Web サイトに対応しました。

2026年4月13日

新しい SE クロール済みページエンドポイントがリリースされました。 Ahrefs が対象に対してクロールしたページを返します。

2026年4月10日

BR 引用ページエンドポイントで、追跡対象 URL によって結果を絞り込むための tracked_urls パラメータがサポートされるようになりました。

2026年3月31日

ブランドレーダーのレポートを管理するための API エンドポイントがリリースされました：

2026年3月30日

GSC Pages エンドポイントに traffic_value フィールドが含まれるようになりました。

2026年3月19日

GSC インサイト API がリリースされ、Google Search Console データにプログラムからアクセスできるようになりました：

2026年3月17日

2 つのレポート関連エンドポイントが拡張されました。

2026年3月12日

tags フィールドが BR AI 応答エンドポイントに追加されました。

2026年3月11日

ブランドレーダーのカスタムプロンプトを管理するための API エンドポイントがリリースされました：

2026年3月9日

search_queries フィールドが BR AI 応答エンドポイントに追加されました。このフィールドは、チャットボットが応答に必要な情報を探す際に使用した検索クエリに対応します。

2026年2月27日

わかりやすくするため、次の2つのSEエンドポイントの名称が変更されました（従来のパスも引き続き機能します）：

2026年2月25日

SA プロジェクトエンドポイントは、新しい project_name および project_url パラメータを使用して、プロジェクトを名前とURLでフィルタリングできるようになりました。

2026年2月4日

ウェブアナリティクス APIがリリースされ、ウェブアナリティクス UIで利用できるものと同じレポートにプログラムからアクセスできるようになりました：

各レポートには時系列の -chart バリエーションも用意されています。また、全体の訪問者チャートも利用できます。

2026年1月2日

ブランドレーダー API の追加エンドポイントをリリースしました：

  • 引用ドメイン：AIの回答で引用されたドメインを、メンション数、ページ数、回答数、ボリューム数とともに返します。
  • 引用ページ：AIの回答で引用されたページを、同じ指標とともに返します。

2025年12月19日

SE オーガニックキーワードエンドポイントに keyword_language フィールドが追加されました。このフィールドはフィルターとしても使用できます。

2025年12月17日

新しいBR シェアオブボイス履歴エンドポイントがリリースされました。 AIクライアント全体にわたるシェアオブボイス指標を時系列で返します。

2025年12月3日

SA Projects エンドポイントが大幅に改善されました：

  • 履歴クロールデータに対応。
  • 特定のプロジェクトをクエリできる機能。
  • Always-on Audit（AOA）に対応。
  • クロール済みURL数、エラー数、警告数、通知数などの追加メトリクス。

2025年12月1日

ブランドレーダー API の追加エンドポイントをリリースしました：

2025年11月7日

初のブランドレーダー統計エンドポイントをリリースしました：

  • インプレッション概要: UI と同じフィルターで、AI クライアント全体のブランドインプレッションを返します。

2025年10月9日

新しいRT 競合統計エンドポイントをリリースしました。ランクトラッカーのプロジェクトから、SoV、トラフィック、順位数などの競合他社メトリクスを返します。

2025年10月2日

新しいSA Page Explorer エンドポイントをリリースしました。 Page Explorer のメトリクスへプログラムからアクセスでき、履歴比較および問題に基づくURLフィルタリングに対応しています。

2025年9月29日

is_spam フィールドを、すべての被リンク関連 API エンドポイントに追加しました。このフィールドは、サイトエクスプローラー UI で利用できるスパムフィルターに対応します。

2025年9月8日

ブランドレーダー API の最初のエンドポイントがリリースされました：

  • AI レスポンス：UI と同じ列とフィルターで、AI 生成の応答を返します。

2025年7月22日

新しい SA Issues エンドポイント がリリースされました。サイト監査プロジェクトの問題一覧を返し、新規に影響を受けた URL や修正済み URL などの指標を用いた履歴比較にも対応しています。

2025年7月3日

新しい SA ページコンテンツ エンドポイント がリリースされました。サイト監査のクロールから、生の HTML、レンダリング済み HTML、または抽出したテキストコンテンツを取得できます。確認済みプロジェクトについては、過去のスナップショットも利用できます。

2025年7月2日

APIv3 にいくつかの更新が加えられました：

2025年6月9日

キーワードエクスプローラーのキーワードリストを管理するための新しい API エンドポイントがリリースされました：

2025年5月22日

ランクトラッカーのプロジェクトを管理するための第 2 弾のエンドポイントがリリースされました。これらのエンドポイントを使うと、RT プロジェクトをプログラムから変更できます：

2025年5月2日

新しい volume_monthly_history フィールドが KE Overview エンドポイントに追加されました。 volume_monthly_date_from と volume_monthly_date_to パラメータで設定した期間に基づき、指定したキーワードの月次の過去検索ボリュームを返します。

2025年4月21日

RT Competing pages エンドポイントがリリースされました。

2025年3月3日

RTプロジェクトを管理するためのAPIエンドポイント第1弾がリリースされました：

  • GET projects: ワークスペース内のすべてのプロジェクトを一覧表示します。デフォルトではすべてのプロジェクトを返しますが、アクセス種別、オーナー、特定のプロジェクトIDなどでフィルタリングできます。
  • GET project-keywords: 指定したプロジェクトのすべてのRTキーワードを一覧表示します。
  • GET project-competitors: 指定したプロジェクトのすべてのRT競合他社を一覧表示します。
  • GET locations: サポートされているすべての国、ロケーション、言語の辞書を提供するヘルパーエンドポイントです。これは次のバッチのエンドポイントで役立ちます。RTプロジェクトへのキーワードの追加や、プロジェクトへのロケーションの割り当てが可能になります。

2024年12月9日

APIv3の更新内容：

  • APIv3における合計SVの推移: total-search-volume-history エンドポイント は、対象が上位10位または100位以内にランクインしているキーワードの合計SVを返します。
  • OKエンドポイントでのモバイル／デスクトップ内訳: organic-keywords エンドポイント に、volume_mobile_pct と volume_desktop_pct の2つの新フィールドが追加されました。モバイルおよびデスクトップ端末からの検索ボリュームの割合を返します。
  • OKエンドポイントの検索意図: KEエンドポイントに検索意図が追加されたのに続き、organic-keywords エンドポイント でも検索意図が返されるようになりました。そのための is_commercial、is_informational などの新しいブール値フィールドがいくつかあります。

2024年12月3日

SE Organic competitors エンドポイントがリリースされました。レポート本体と同様に、このエンドポイントは、指定したキーワードでトップ10にランクインしている上位競合他社のリストを返します。

2024年11月29日

ランクトラッカー API向けのcompetitors-overview エンドポイントがリリースされました。ランクトラッカーの「競合の概要」レポートと同様に、追跡しているキーワードから競合が得ている順位と推定トラフィックを提供します。

2024年11月28日

KE Overview エンドポイントおよび Keyword ideas エンドポイントに、intents フィールドが追加されました。

2024年11月8日

KE Overview エンドポイントおよび Keyword ideas エンドポイントに、以下の新機能が追加されました。

  • ターゲットフィルター: APIで、ターゲットのランキング順位に基づいてキーワードをフィルタリングできるようになりました。これに伴い、target、target_mode、target_position の新しいクエリパラメータが追加されました。
  • keywordsパラメータの空値サポート: 前述のtargetパラメータを指定した場合、keywords パラメータに空の値を渡すこともサポートされるようになりました。この2つの機能を組み合わせることで、ターゲットがランクインしているすべてのキーワードのKE指標を取得するクエリを実行できます。
  • モバイル／デスクトップ内訳: volume_desktop_pct と volume_mobile_pct の2つの新フィールドが追加されました。デスクトップおよびモバイル端末で行われたキーワードの検索の割合を返します。
  • 月間ボリューム: 平均検索ボリュームに加え、新しい volume_monthly フィールドで、直近1か月におけるキーワードの検索数を確認できるようになりました。

2024年8月5日

2024年5月31日

offset パラメータは非推奨となり、すべてのAPIエンドポイントから削除されました。

2024年5月8日

Metrics history エンドポイントで select パラメータが利用できるようになりました。

2024年4月26日

ランクトラッカーの概要レポート向けの新しいエンドポイントが追加されました。

2024年3月21日

  • 発リンク数を返す新しいエンドポイントが追加されました。
  • また、Keywords history endpoint が select パラメータに対応し、新しいランキンググループ top11_20、top21_50、top51_plus が追加されました。

2024年3月11日

サイト監査のヘルススコアを含むワークスペースのプロジェクト一覧を返す新しいエンドポイントが追加されました。

2024 年 30 月 1 日

外部アンカーレポート向けの新しいエンドポイントが追加されました。

2024 年 17 月 1 日

アンカーレポート向けの新しいエンドポイントが追加されました。

2023年12月5日

AhrefsBot が使用する IP 範囲を返す新しいエンドポイントが追加されました。

2023年11月23日

DR履歴チャート向けの新しいエンドポイントが追加されました。

2023年11月16日

サブスクリプションとAPIの利用状況に関する情報を提供する新しい制限と使用状況エンドポイントが追加されました。

2023年9月18日

API エンドポイントは、すべての出力形式で米ドル（USD）の値をセント単位で返すようになりました。

2023年6月16日

キーワードエクスプローラーの関連用語および検索候補（サジェスト）レポート向けの新しいエンドポイントが追加されました。

2023年6月9日

キーワードエクスプローラーのフレーズ一致レポート向けの新しいエンドポイントが追加されました。

2023年5月26日

ユニットを消費しない無料のテストクエリの限定セットを実行して Ahrefs APIv3 をテストできる機能が追加されました。

2023年3月7日

SERP の概要向けの新しいエンドポイントが追加されました。

2023年3月6日

被リンク数の多いページおよび壊れた被リンクレポート向けの新しいエンドポイントが追加されました。

2023年2月27日

リンクドメインレポート向けの新しいエンドポイントが追加されました。

2022年11月25日

キーワードエクスプローラー向けの新しいエンドポイントを3つリリースしました。単一キーワードまたはキーワードリストに対応したキーワード指標、単一キーワードに対応したボリューム履歴、同じく単一キーワードに対応した国別ボリュームです。

2022年11月10日

UR履歴チャート用の新しいエンドポイントが追加されました。

2022年10月11日

上位順位別キーワードチャート用の新しいエンドポイントが追加されました。

2022年9月8日

APIv3をリリースしました。サイトエクスプローラーの概要、被リンク、参照ドメイン、オーガニックキーワード、上位ページ、および有料ページレポートに対応したエンドポイントが利用可能になりました。