Ranktracker APIが公開されました — すべてのプランに利用権が含まれています

はじめに

Ranktracker APIが正式に公開されました。

すべてのRanktrackerプランにAPIアクセス権が含まれるようになり、お客様はRanktrackerを自社のダッシュボード、レポートプラットフォーム、社内システム、SEOワークフローに直接連携できるようになりました。

開発を開始するために、別途APIサブスクリプションやエンタープライズ限定アカウントは必要なくなりました。「Launch」、「Growth」、「Scale」、「Authority」のいずれのプランをご利用の場合でも、APIキーを作成し、Ranktrackerアカウント内のデータに対してプログラムによる操作を行うことができます。

このAPIは、各プランに含まれるキーワード、データ行、トラッキングの割り当て枠に基づいて構築されています。上位プランほど割り当て枠は大きくなりますが、APIへのアクセス機能はすべてのユーザーに提供されています。

開発者向けドキュメントの全容は、以下のURLでご確認ください。 developers.ranktracker.comで詳細な開発者向けドキュメントをご覧ください。

Ranktracker APIを開発した理由

SEOチームは、単一のプラットフォームの外で検索データを利用する必要性をますます高めています。

代理店は、クライアントポータル内にランキングデータを表示したいと考えています。社内チームは、ランキングデータを分析データ、リード、収益と統合したいと考えています。開発者は、反復的なプロジェクト管理タスクを自動化したいと考えています。大規模な組織は、SEOデータを自社のデータウェアハウスやビジネスインテリジェンスシステムに保存したいと考えています。

手動でのエクスポートも時折は有効ですが、数百のドメインや数千のキーワードにわたって毎日レポートを更新する必要がある場合、非効率的になってしまいます。

Ranktracker APIは、お客様のシステムがRanktrackerと直接通信できるようにすることで、この課題を解決します。

これにより、ダッシュボード内で同じ操作を手動で繰り返すことなく、ランキングデータの取得、追跡対象プロジェクトの管理、キーワードの整理、レポート作成ワークフローの構築が可能になります。

APIアクセスはすべてのRanktrackerプランに含まれています

APIへのアクセスは、最上位プランに限定されていません。

以下のプランに含まれています：

• Growth
• Growth
• スケール
• 権威

APIの利用状況は、ご契約に付随するキーワード、データ行、競合他社などの利用枠の範囲内で処理されます。

たとえば、API経由でキーワードを追加した場合、それらのキーワードは、Ranktrackerのインターフェース経由で追加されたキーワードと同様に、アカウントの割り当て枠にカウントされます。大規模なインポートを実行する前に、プログラムで現在の使用状況と残りの容量を確認できます。

これにより、企業の規模や技術リソースの有無にかかわらず、すべてのお客様が自動化を試す機会を得られます。

小規模な企業では、Ranktrackerをシンプルな社内ダッシュボードに連携させることができます。代理店では、クライアントのオンボーディングやレポート作成を自動化できます。大規模なチームでは、Ranktrackerアカウントを中心に完全なデータパイプラインを構築できます。

トップ100の完全なランキングデータ

Ranktrackerは、トップ100の完全な追跡を中核として構築されています。

Ranktrackerは、Googleの1ページ目だけで追跡を終了するのではなく、オーガニック検索結果の全10ページを追跡します。これにより、1ページ目に到達する前に認知度を高め始めているキーワードを特定することができます。

APIを通じて、追跡対象のキーワードに紐づく最新のランキング履歴を取得できます。これには以下のような情報が含まれます：

• 現在のオーガニック検索順位
• 絶対的なSERP順位
• ランキングURL
• 日次順位変動
• 週間の順位変動
• 月間ランキング変動
• 検索ボリューム
• 推定トラフィック
• クリック単価
• 競合状況
• キーワード難易度

また、追跡対象の各キーワードは、設定された検索エンジン、地域、言語、デバイスに関連付けることができます。これにより、チームは単なるキーワード順位の一覧にとどまらない、より詳細なレポートを作成することが可能になります。

107,000以上の地域を横断して追跡

Ranktrackerは、107,000以上の追跡可能な地域に対応しており、デスクトップおよびモバイルの追跡、幅広い言語のサポートも備えています。これにより、このAPIは次のような用途に適しています：

• ローカルSEOキャンペーン
• 国内検索モニタリング
• 国際SEO
• 多言語対応ウェブサイト
• フランチャイズおよび複数拠点を持つ企業
• 異なる市場でクライアントを管理する代理店

キーワードは、地域、言語、デバイスの複数の組み合わせで追跡可能です。

例えば、代理店はロンドン、マンチェスター、バーミンガムにおいて、デスクトップとモバイルの両方で同じキーワードを追跡できます。各組み合わせは個別の追跡行として保存されるため、代理店は市場ごとに検索パフォーマンスがどのように異なるかをより正確に把握できます。

Ranktracker APIでできること

このAPIにより、Ranktrackerアカウントで使用される主要なリソースにアクセスできます。

ドメインの管理

プログラムを介して、追跡対象のドメインを作成、取得、更新、削除することができます。

これにより、Ranktrackerを顧客のオンボーディングプロセスに連携させることが可能になります。社内システムにクライアントが追加されると、Ranktracker内でもそのドメインが自動的に作成されます。

ドメインレベルのエンドポイントでは、指定した期間におけるランキング履歴やシェア・オブ・ボイスデータも提供されます。履歴およびシェア・オブ・ボイスのリクエストは最大365日間の期間を対象とし、デスクトップ、モバイル、またはすべてのデバイスごとにフィルタリングが可能です。競合他社の管理

追跡対象の各ドメインに関連付けられた競合他社を追加、取得、更新、または削除できます。

これにより、新規プロジェクトの競合他社モニタリングを自動的に設定したり、Ranktrackerと他のプラットフォーム間でクライアント設定を同期させたりすることができます。

キーワードの追加と管理

ドメインの追跡対象キーワードを作成し、検索エンジン、地域、言語、デバイス、追跡頻度を指定します。

このAPIは、キーワードフレーズと検索エンジンの設定を組み合わせて一括作成することをサポートしています。何百もの個別のリクエストを送信する代わりに、複数のキーワードと追跡設定をまとめて送信できます。また、キーワードの一括一時停止、再開、削除もプログラムで実行可能です。

ランキング履歴の取得

ドメインに関連付けられたすべてのキーワードについて、最新のランキング結果を取得します。

このデータは以下の宛先に送信できます：

• クライアント向けレポートポータル
• Google スプレッドシート
• データウェアハウス
• ビジネスインテリジェンス（BI）ダッシュボード
• 社内通知システム
• カスタムSEOアプリケーション

ドキュメントには、毎日のランキングデータを抽出して、データウェアハウスやCSVベースのワークフローに読み込むための完全なチュートリアルが含まれています。SERP結果へのアクセス

追跡対象の各キーワードについて、最新の解析済み検索結果にアクセスできます。

これには、オーガニック検索結果およびそれらを取り巻くSERP機能が含まれます。Ranktrackerは、フィーチャードスニペット、地図検索結果、動画、ショッピング検索結果、「People Also Ask」の結果、AI概要などの機能を追跡します。サポートされている追跡対象キーワードについては、キャッシュされたSERP HTMLも利用可能です。これにより、ドメインの数値的なランキング以上の分析が可能になります。

また、どのような種類の検索結果が表示されているか、自社のリスティングを囲む競合他社は誰か、どのSERP機能がオーガニックのクリック率に影響を与えている可能性があるかを把握することもできます。

シェア・オブ・ボイスレポートの作成

シェア・オブ・ボイス（Share-of-Voice）エンドポイントは、全体的な可視性の数値、選択した期間におけるその変化、および自社ドメインと追跡対象の競合他社を比較した日次データシリーズを返します。

このデータは、チャートやレポート作成用にすでに構造化されています。これを使用して、競合ドメインに対して自社ブランドが優位に立っているか、あるいは劣勢に立たされているかを示す可視性のトレンドを作成できます。 タグでキーワードを整理

アカウントレベルのタグを作成し、異なるプロジェクトにまたがるキーワードに適用します。

タグは以下の分類に使用できます：

• ブランドキーワードおよび非ブランドキーワード
• 製品・サービス
• 国または地域
• キャンペーン
• 優先キーワード
• クライアントのレポートグループ
• ウェブサイトの各セクション

このAPIは一括タグ付けに対応しており、1回のリクエストで1つのタグを多数のキーワードに適用できます。 アカウントの使用状況を監視する

アカウント使用状況エンドポイントでは、プランの使用状況と残りの容量を確認できます。

以下の割り当て情報を報告します：

• アクティブなキーワード
• データ行
• オンデマンドチェック
• SERPアナライザーのクレジット

各割り当てには、現在の使用量、総上限、および残りの容量が表示されます。これは、大規模なキーワードリストをインポートする前に特に役立ちます。統合システムでは、まず利用可能な容量を確認することで、アカウントの割り当てを超えるインポートを試みることを回避できます。

代理店向けに設計

代理店は、この新しいAPIの恩恵を受けられる主要なグループの一つです。

典型的な自動化されたオンボーディングワークフローの例としては、次のようなものがあります。

1. クライアントのドメインを作成します。
2. 競合他社を追加します。
3. ターゲットキーワードをインポートします。
4. 地域、言語、デバイスを設定します。
5. クライアント固有のタグを作成します。
6. ランキングデータを社内ダッシュボードに送信します。
7. 定期的な可視性レポートを生成します。

以前は複数の手動ステップを必要としていたプロセスを、代理店独自のプロジェクト管理システムやクライアントオンボーディングシステムに連携できるようになりました。

また、代理店は毎日のランキングのスナップショットを自社のデータベースに取り込み、ホワイトラベルのポータル内でその情報を提示することも可能です。

社内SEOチーム向けに構築

社内チームは、ランキングデータをより広範なビジネスデータと連携させることができます。

例えば、キーワードのパフォーマンスを以下のデータと組み合わせることができます：

• Google Search Consoleのクリック数
• ウェブサイトのコンバージョン
• EC売上
• 生成されたリード
• ランディングページのパフォーマンス
• コンテンツの公開日
• テクニカルSEOの更新

これにより、孤立したランキングレポートにとどまらず、検索での可視性がビジネス成果全体にどのように寄与しているかを把握しやすくなります。

SEOプラットフォームおよび開発者向けに設計

開発者は、Ranktrackerを社内ツールや顧客向けアプリケーションの基盤となるランキングおよびSERPデータレイヤーとして活用できます。

APIは一貫したREST構造を採用しており、すべての本番用エンドポイントでは以下を使用します：

https://api.ranktracker.com/v1

レスポンスはJSON:API形式を採用しています。リソースは「data」の下に返され、そのフィールドは「attributes」オブジェクト内に格納されます。リストエンドポイントは1ページあたり最大1,000件のレコードに対するページネーションに対応しており、レスポンスヘッダーを通じて総件数を返します。 ドキュメントでは現在、以下の機能に関する実用的な例を提供しています：

• cURL
• Python
• Node.js

また、ドメインの作成、キーワードの追跡、データウェアハウスへのエクスポート、シェア・オブ・ボイス（Share-of-Voice）レポート、キーワードの一括タグ付けを網羅した完全なチュートリアルも含まれています。

APIキーの作成方法

開始するには、わずか数ステップで済みます：

1. Ranktrackerアカウントにログインしてください。
2. アカウント設定を開いてください。
3. 「API キー」セクションに移動します。
4. 新しい API キーを作成します。
5. キーをサーバー上で安全に保管してください。

APIキーの形式は次のとおりです：

tkn_usr_...

キーはAuthorizationヘッダーに直接指定してください。「Bearer」プレフィックスは不要です。以下は、アカウント内のドメインを一覧表示する基本的なリクエストの例です：

リクエストが成功すると、そのキーに関連付けられたアカウントが所有するドメインが返されます。

APIキーは常にパスワードと同様に扱う必要があります。公開リポジトリ、ブラウザのコード、またはモバイルアプリケーション内に配置してはなりません。

信頼性の高い自動化を想定して設計

このAPIは、標準的なHTTPメソッドと予測可能なレスポンス構造を採用しています。

以下の機能をサポートしています：

• リソースを取得するためのGET
• リソースの作成にはPOST
• PATCH：リソースの更新
• リソースを削除するにはDELETEを使用します

エラーには機械可読なコードと説明が含まれているため、統合システムは、リクエストの修正が必要か、アカウントが割り当て上限に達したか、あるいは一時的なリクエストを再試行すべきかを判断できます。k 操作、ページネーション、および使用状況レポートも、大規模なプロジェクトを管理する際に不要なリクエストを減らすのに役立ちます。

MCPに関する簡単な説明

Ranktrackerでは、対応しているAIツールやアシスタントをRanktrackerのデータに接続するためのMCPサーバーオプションも提供しています。

MCPサーバー、対応ツール、および接続手順については、別の記事で解説します。

Ranktracker API を使った開発を始めましょう

Ranktracker API を利用することで、SEO 担当者は検索データの収集、整理、活用方法をより細かく制御できるようになります。

順位追跡のワークフローを自動化したり、プロジェクトを同期させたり、トップ100の検索結果をすべて取得したり、SERPの機能を分析したり、シェア・オブ・ボイスを比較したり、組織がすでに使用しているシステムにSEOデータを連携させたりすることができます。

最も重要な点は、API アクセスがすべての Ranktracker プランに含まれるようになったことです。

RanktrackerアカウントからAPIキーを作成し、以下のドキュメントをご覧ください。 developers.ranktracker.comでドキュメントをご確認ください。