参照
AhrefsバックリンクレポートとAPI出力の比較：アクションの参照
Ahrefsバックリンクレポートのエクスポートに慣れている場合、この参照資料は、どの部分を当社のアクションで再構築できるか、各呼び出しの費用、および主要なツールが優位性を保っている箇所を示します。
アクション、価格、およびレポートでの対応箇所
| アクション | クレジット | 一般的なレポートの対応箇所 | 備考 |
|---|---|---|---|
| domain, overview, stats, suggest | 0 | 見出しの計数 | キー不要 |
| bulk_dr | 1 | リスト用のDR列 | 1回の呼び出しで最大2,000ドメイン |
| compare | 1 | 並列ドメイン比較 | 最大20ドメイン |
| top, dr_distribution, tld_breakdown | 1 | 要約チャート | 分布形式の要約 |
| refdomains | 2 | 被リンク元ドメインタブ | ページネーション対応 |
| backlinks | 2 | バックリンクタブ | ページネーション対応 |
| anchors, anchor_cloud | 2 | アンカーテキストタブ | クラウド表示用 |
| toppages | 2 | 被リンク数上位ページ | リンクを獲得しているページ |
| intersect | 2 | リンク共通部分（インタセクト） | 2〜10ドメイン |
| search, keyword | 3 | 直接的な対応なし | アンカーテキスト、タイトル、URL検索 |
レポートタブと当社のアクションのマッピング
レポートのエクスポートは通常タブ形式で提供され、各タブにはおおむね対応するAPIアクションが存在します。完全な複製ではありません。あるタブに存在するフィールドが、当社のレスポンスに全く存在しない場合もあるため、マッピングを出発点としてお読みください。
被リンク元ドメインタブ
DR順に並べられた被リンク元ドメインで開くレポートを想像してください。最も近い対応はrefdomains（2クレジット）で、同様にソート可能です。行のフィールド名はアクションによって異なるため、スクリプト内で列名を一部変更する必要があることを想定してください。
月間でのソート順序を統一してください。ある月はDR順、翌月はトラフィック順で並べられたリストは、正確に差分比較できません。ファイル名にソートキーを明記してください。
アンカーテキストタブと、クラウド表示の目的
anchorsはアンカーテキストタブ用の呼び出しで、2クレジットです。anchor_cloudも同額ですが、上記の表にある通り、これは表示用です。数値に基づく判断が必要な場合は、プレーンリストを読み取ってください。
アンカーテキストを読む際は「実際のライターがこれらを入力するか？」という視点で確認してください。ブランド名や単なるURLは通常通過しますが、複数のドメインにわたって同じ金銭的なフレーズが繰り返されているブロックは通過せず、まずそのブロックを確認する必要があります。
上位ページと2〜10ドメインの比較
toppagesは「被リンク数上位ページ」タブに最も近い機能です。どのページがリンクを獲得しているかを示し、サイトの特定のフォルダに順位変動の影響が出た場合、ドメイン全体の合計よりも多くのことを語ることがあります。
intersectは2〜10ドメインを対象とし、1回の呼び出しで2クレジットかかります。例えば、自サイトと2つの競合サイトを比較する場合、重複部分は3社が共通してリンクを獲得しているサイトを示します。これはシンプルで低コストな分析手法です。
呼び出し全体に適用されるパラメータ
リストを制御する要素は3つです。page、per、およびsortとorderのペアです。月間を通じてこれらを固定してください。
perは10〜5000を受け付けますが、1回の呼び出しで返されるのは最大1,000行までです。深いページネーションは50,000行で停止します。行数がいくつであっても1回の呼び出しとして課金されるため、1行だけ取得する場合も1,000行取得する場合もコストは同じです。
認証には、クエリにkey=sk_...を指定するか、Authorization: Bearer sk_...ヘッダーを使用します。CORSはオープンですが、ブラウザコードではキーがすべての訪問者に公開されるため、キーはサーバーに保持してください。
順序は重要です。結果をページネーションする際は、おそらく重要なドメインに対してはDR降順でソートし、ロングテールの小規模サイトを検索する場合は昇順でソートします。どちらを選択しても、ファイルの横にその設定を記録してください。
上記の表を地図、保存されたレスポンスを実地（テリトリー）として扱ってください。期待していたフィールドが存在しない場合は、存在するデータに合わせて構築してください。
月次エクスポートの5つのステップ
毎月同じ5つのステップを実行し、比較時に保存されたファイルが整合するようにしてください。
- 1
呼び出しの選択
各ドメインに対して
refdomains、anchors、toppagesを選択してください。OverviewとStatsは無料なので、同じフォルダに追加してください。 - 2
深さの固定
page、per、sort、orderを一度設定し、それ以降変更しないでください。perは最大5000まで設定可能ですが、1回の呼び出しで返されるのは最大1,000行までです。 - 3
レスポンスをそのまま保存
> パース処理の前に、生JSONをディスクに書き込んでください。後でスクリプトが失敗した場合、再実行するのは保存されたコピーです。
- 4
_creditsオブジェクトを確認
認証済みレスポンスには、そのコストと残高が報告されます。両方をログ行にコピーし、ダッシュボードを開かなくても月間の支出を確認できるようにしてください。
- 5
前月と比較
保存されたコピーを差分比較してください。diffレシピには、保持すべき3つの列が記載されています。
クレジット、行制限、および月間請求額
価格リストは短いです。請求額は呼び出し頻度とページネーション方法に依存します。その大部分を決定する習慣が3つあります。
行の数に関わらず1回呼び出しにつき1回課金
各呼び出しは1回だけ課金されるため、同じアクションにおいてper=1000とper=10のコストは同じです。再利用するリストにはフルページが安上がりですが、簡易確認には無駄になります。
例えば、毎月同じ日に1ドメインのrefdomainsを取得する場合、そのコストは月間2クレジット、つまり公開レート1クレジットあたり$0.0001で$0.0002です。
50,000行の上限
深いページネーションは50,000行で停止します。それ以降のページを要求しても新しいデータは得られないため、ループ開始前にページ数を制限してください。
1回あたり1,000行で上限に達するには50回の呼び出しが必要です。1回あたり2クレジットなので、合計100クレジット、つまり$0.01です。安価ですが、スクリプトが適切なタイミングで停止することが前提です。
月間習慣のための小規模な予算
10ドメインを想定し、それぞれにrefdomainsとanchorsを月1回取得するとします。これは月間40クレジット、つまり$0.004です。サインアップ時に付与される$100の無料クレジット（1,000,000クレジット）から差し引かれます。
そのペースであれば無料クレジットは長く持ちますし、支出ログはそのペースが維持されているかを示します。この習慣を維持してください。
レスポンスのトラブルシューティング
| 表示される内容 | 原因 | 解決策 |
|---|---|---|
| HTTP 401 | キーの欠落または誤り | キーとヘッダーのスペルを確認 |
| HTTP 402 | クレジットが枯渇 | アカウントページでUSDT (TRC-20)でチャージ |
| okがfalse | リクエストが拒否されました | ボディ内のメッセージと送信したパラメータを確認 |
| 主要ツールよりも行数が少ない | 異なるインデックスとクローリングタイミング | 合計値ではなくトレンドを比較 |
| 先週作成したリンクが見つからない | インデックスは約月1回で再構築 | 次のサイクルで再確認 |
欠落した行は答えではなく疑問
2つのレスポンス間で行が消失することはよくある驚きです。その意味を判断する前に、考えられるシナリオを分離してください。
1つの欠落行の背後にある3つのシナリオ
リンクがインデックス化されていないか、削除された可能性があります。第3のシナリオはタイミングです：ページがインデックス再構築の前または後にクローリングされ、行は後のサイクルで表示されます。
1回の呼び出しではこれらを区別できません。後で取得した2番目のコピーと、ページ自体の確認によって、候補を絞り込むことができます。
追跡する前に行の重みを評価
アウトリーチを行う前に、ドメインのDRとリンク元のページを確認してください。弱サイトからのリンク消失は計画にほとんど影響しません。読者を惹きつけたページからのリンク消失であれば、所有者への連絡を検討する価値があります。疑わしいテーブルは、欠落した行がより広範な原因の中でどこに位置するかを示しています。
エクスポートを当社の呼び出しに移行する
Ahrefsが提供するのと同じ列をエクスポートできますか？
1対1ではありません。行のフィールドはアクションによって異なるため、保存されたレスポンスを開き、フィールド名を自分でマッピングしてください。上記の表はレポートの各部分に最も近いアクションを特定していますが、フィールド名は異なります。
APIはAhrefsのサブスクリプションより安価ですか？
答えは呼び出し量に依存します。当社の公開価格は、1クレジット呼び出し1,000回あたり$0.10です。Ahrefsはサブスクリプション内にAPIユニットを販売しており、月$129で200,000ユニット（リクエストあたり最低50ユニット）が提供されます。判断する前に呼び出し数をカウントしてください。
古いエクスポートは新しいものと比較できますか？
ソート、深さ、およびソースが一致する場合のみ可能です。異なるツールから異なる週に取得したファイルは異なるサンプルです。古いファイルを保持し、新しいシリーズは明確にラベル付けされたペアから始めてください。
キーをサーバーに保持する必要がありますか？
はい。CORSはオープンなのでブラウザからAPIを呼び出せますが、フロントエンドコードにキーが含まれているとすべての訪問者に公開されます。サーバーからリクエストを送信し、環境変数からキーを読み取ってください。
これらの呼び出しの上にレポートを構築する前に
- アクションごとに1つの保存されたレスポンスを開き、実際に取得される行のフィールド名をメモしてください。
- ファイル名に含める月ラベルを決定してください。
- 月間取得の間で
page、per、sort、orderを同一に保ってください。 - 各認証済みレスポンスから
_creditsオブジェクトをログに記録し、ジョブごとの支出を確認できるようにしてください。 - リストは50,000行で停止するため、スクリプト内で深いページネーションを制限してください。
- 提供されるレポートには、インデックスが約月1回で更新される旨の鮮度に関する注記を追加してください。
レスポンスの構造を読む
すべてのレスポンスにはokが含まれます。認証済みのレスポンスにはさらに_creditsが追加され、ジョブごとの支出をログに記録し、残高を監視できます。
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"Ahrefsはサブスクリプション内にAPIユニットを販売しており、月$129で200,000ユニット（リクエストあたり最低50ユニット）が提供されます。また、キーワード、ラック追跡、より新鮮なクローリングも提供しており、Semrushも同様です。当社は低コストの呼び出しでリンクデータをカバーし、それ以上の機能は提供しません。そのギャップを埋める必要がある場合は月間ランブックを使用してください。スパイクスパイク決定木は、低コストな要約呼び出しの最初の用途として最適です。
