リファレンス
リファレンス: 各アクション、コスト、エラー発生時の挙動
監査スクリプトを作成している間はこれを開いておいてください。アクション、価格、ページネーションの制限、そして遭遇する可能性のある 2 つのエラーを一覧にしています。
表の前に知っておくべき基本事項
エンドポイントは https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_... です。キーは Bearer ヘッダーとして送信することもできます。CORS は開放されているため、ブラウザスクリプトでも動作します。
すべてのレスポンスには ok フラグが含まれます。認証済みのレスポンスには _credits も含まれ、コストと残高が示されます。これにより、予算の追跡が容易になります。
Moz API バックリンクの価格と比較すると、構造が異なります。Ahrefs は月額 $129 から始まり 200,000 ユニットが含まれるサブスクリプション内でユニットを販売していますが、ここではプリペイド残高から呼び出しごとに課金されます。
サブスクリプションのティアを上げる必要も、月額の最小利用量もありません。プリペイド残高方式のため、過剰利用料金の請求もありません。すべてのケースに同じルールが適用されます。月に 1 回実行するスクリプトも、クライアントオンボーディングのたびに実行するスクリプトも、同じルールで課金されます。新規登録者は無料クレジットとして $100 で開始し、これは約 500,000 回の 2クレジット呼び出しに相当します。
予期せぬ事態を避けて最初のスクリプトを書く
小さく始めてください。API を呼び出すスクリプトは作成が簡単ですが、簡単にコストが膨れ上がります。以下のルールにより、最初のバージョンを正確に保つことができます。
最初の実行では 1 ドメインに限定してください。出力が正しければ、リストを段階的に広げ、各ステップの間に残高を確認してください。
ページがコストの単位です
1 回の呼び出しは、返される行数に関係なく 1 回として課金されます。フェッチするページは別の呼び出しとなるため、大きなリストをページネーションすると、ページごとに 1 回の課金が発生します。
あるサイトに 2,500 件の参照ドメインがあり、それらすべてを取得したいとします。選択したページサイズでは、これは数回の呼び出しとなり、それぞれに独自のコストがかかります。ループを開始する前にページ数を数えてください。質問に合うページサイズを選択してください。短いリストなら 1 回の呼び出しで済みますが、長いリストではすべてのページで同じ注意が必要です。
すべてのレスポンスでクレジットを確認する
認証済みのレスポンスには _credits が含まれ、その呼び出しのコストと残高が示されます。頭の中で見積もった数字ではなく、このフィールドをログに記録してください。
残高を出力に書き込むスクリプトにより、長時間の実行がアカウントを使い切る前に停止できます。チェックをシンプルかつ視覚的に分かりやすく保ってください。
無料呼び出しでプランをテストする
domain、overview、stats、suggest はキーが不要で無料です。有料呼び出しを実行する前に、ドメインのスペルとデータの基本的な構造を確認するためにこれらを使用してください。
その後、同じドメインに対して有料呼び出しを 1 回ずつ追加してください。無料呼び出しで捕捉されたミスにはコストがかかりません。無料の出力は、有料の出力と同じ日付のフォルダに保管してください。
無料および 1クレジットアクション
| アクション | コスト | 用途 |
|---|---|---|
| domain | 無料 | 素早い DR 検索、ホームページのチェッカーの背後にある呼び出し |
| overview | 無料 | ドメインの主要な数値 |
| stats | 無料 | インデックス自体に関する数値 |
| suggest | 無料 | ドメインのオートコンプリート形式の検索 |
| bulk_dr | 1クレジット | 1 回の呼び出しで最大 2,000 ドメイン、domains= による GET または POST ボディ |
| compare | 1クレジット | 最大 20 ドメインの並列比較 |
| top | 1クレジット | インデックスからのランキングリスト |
| dr_distribution | 1クレジット | セット全体での DR の分布 |
| tld_breakdown | 1クレジット | TLD 別にグループ化された参照元 |
2クレジットおよび 3クレジットアクション
| アクション | コスト | 用途 |
|---|---|---|
| refdomains | 2クレジット | ターゲットにリンクするドメイン |
| backlinks | 2クレジット | 個別のリンク |
| anchors | 2クレジット | アンカーテキストリスト |
| toppages | 2クレジット | リンクを集めるページ |
| anchor_cloud | 2クレジット | 使用頻度で重み付けされたアンカー単語 |
| intersect | 2クレジット | 2〜10 ドメインに同時にリンクするサイト、置換リンクの探索用 |
| search | 3クレジット | アンカー、タイトル、URL 全体での全文検索 |
| keyword | 3クレジット | 正確なアンカーでリンクされているサイト |
1 回の呼び出しは行数に関係なく 1 回として課金され、呼び出しごとに最大 1,000 行までです。結果をたどるには page と per（10-5000）を使用し、sort と order=asc|desc でソートします。深いページネーションは 50,000 で停止します。
発生する可能性のあるエラー
| HTTP コード | 意味 | 対処法 |
|---|---|---|
| 401 | キーの欠落または無効 | key パラメータまたはヘッダーを確認 |
| 402 | クレジットが枯渇 | アカウントページで USDT (TRC-20) でチャージ |
呼び出しが失敗したときの、最初に確認すべき事項
実際の失敗の大部分は 2 つのエラーでカバーされます。それぞれに異なる修正方法があるため、他の変更を行う前にコードを読んでください。
失敗した呼び出しでも何らかの情報が得られます。キーを除去した状態で、リクエスト URL、時刻、レスポンスボディをログに保持してください。
401 はキーが受け入れられないことを意味します
401 レスポンスは、キーが欠落しているか無効であることを示します。修正はデータではなくリクエストにあります。key パラメータまたは Bearer ヘッダーを確認し、値が完全にコピーされていることを確認してください。デバッグ中はキーを出力しないでください。
スクリプトがローカルでは動作し、サーバーで失敗する場合を考えます。サーバーでの 401 は、そのマシンに環境変数が設定されていないことを意味することがよくあります。
402 は残高が枯渇したことを意味します
402 レスポンスはクレジットが消費されたことを意味します。データに誤りはなく、同じ呼び出しを再試行しても、チャージするまで同じ方法で失敗します。
チャージはアカウントページから TRC-20 ネットワーク上の USDT で行われます。長時間の実行の前に残高を確認し、スクリプトがリストの途中で停止しないようにしてください。警告閾値も設定してください。早期警告は、監査の停止よりもはるかに安価です。
無駄のないリトライ
タイムアウトなど、変更可能なエラーのみを再試行してください。401 または 402 をループで再試行すると、ログにノイズが加わり、監査にはデータが追加されません。
試行の間に一時停止し、失敗したドメインを別のリストに保持してください。これにより、偶然ではなく意図的に再実行できます。スクリプトの上部にリトライルールをコメントとして書き込み、次の編集者がそれを維持できるようにしてください。
どの回復質問にどのアクションを使うか
持っている質問に、それに応える最も安い呼び出しを一致させてください。
被害の規模はどのくらいか？
overview から始めます。これは無料です。次に refdomains を 1 回実行し、先月保存したファイルと比較します。月次ルーチン が差分表示を示しています。
ジャンクリンクはどのような見た目か？
anchors と anchor_cloud を使用してください。多くのドメインにわたって繰り返される奇妙な単語は、disavow myths を開く前に捕捉すべきパターンです。
どのドナーを追跡する価値があるか？
intersect は 2〜10 のドメインを取り、それらのいくつかすべてにリンクするサイトを返します。競合他社を入力し、あなたをスキップするドナーを探し、bulk_dr でリストをスコアリングしてください。
移行でリンクが漏れたか？
旧ドメインと新ドメインの toppages は、リンクがどこに到達するかを示します。移行ウォークスルー はそれを使用してステップバイステップで説明しています。
4 回の呼び出しでの単発監査
この順序により、有料呼び出しを少なく保ち、それぞれを質問に結びつけます。ドメインごとに 1 回実行し、その後同じ設定で有料呼び出しを毎月繰り返します。
無料呼び出しを実行する
overview と domain から始めます。どちらも無料であり、それらの出力は続くすべての有料呼び出しの規模を設定します。
参照ドメインを取得する
refdomains を 1 回あたり 2クレジットで使用します。まずページ数を数え、その後必要な数を決定してください。
アンカーのミックスを確認する
anchors または anchor_cloud をそれぞれ 2クレジットで実行します。多くのドメインにわたって繰り返される奇妙な単語を探してください。
候補リストをスコアリングする
疑わしいドメインを bulk_dr に渡し、1 回あたり 1クレジットで最大 2,000 ドメインを処理します。スコアを参照ドメインと同じファイルに保持してください。
注釈付きの 1 回のページネーション呼び出し
アクション後のすべてのパラメータはオプションです。
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsMoz API バックリンク代替との公平な比較
公平な比較は同じ単位から始まります。価格表は単位を隠していることが多いため、合計を比較する前に、各回答に対して実際に支払う金額を記録してください。
Ahrefs では、ユニットはサブスクリプション内にあり、月額 $129 から始まり 200,000 ユニットを購入できます。各リクエストには少なくとも 50 ユニットが使用されます。これが鍵です。これを呼び出しごとの価格の横に設定して初めて、比較が意味を持ちます。
同等のテスト
既知のサイズの 5 ドメインを選択し、両方のサービスで同じ質問を実行してください。憧れの機能ではなく、必要な回答を比較してください。
あるサービスが 1 回の呼び出しで参照ドメインを返し、別のサービスが 3 回必要だとします。その場合、回答あたりのコストがリスト価格よりも重要です。
同じ単位での価格設定
すべてを回答あたりのコストに変換してください。私たちの呼び出しはクレジットで価格設定されており、1クレジットあたり $0.0001 です。したがって、2クレジットの呼び出しは $0.0002 で、無料の呼び出しは無料です。月次の実行で 7クレジットを使用すると仮定します。それは $0.0007 で、1 セントの 10 分の 1 以下です。
失敗した呼び出し後の再実行など、無駄のコストを含めてください。頻繁に失敗する安い呼び出しは、最初に成功する高価な呼び出しよりも高くなる可能性があります。
フルスイートがまだ勝る場所
キーワードリサーチ、ランキング追跡、毎日クロールはこの API の外にあります。それらがあなたの質問であれば、フルスイートがより良く答え、比較にはそう記すべきです。
リンクプロファイルがどのように移動したか、およびどのドナーをより詳しく調べる価値があるかという質問に答えるために、レジャーを使用してください。ノートに「ここではキーワードデータがない」などのギャップを明記し、次の読者がレジャーがそれをカバーしていると誤解しないようにしてください。
