ドメインランクチェッカーAPI：各アクションのコスト

表で使用される定義

クレジットは請求の単位です。1クレジットは$0.0001に相当し、10,000クレジットで正確に1ドルになります。呼び出し（call）は1回のHTTPリクエストを意味します。

行（row）は、返されたリスト内の1つの項目、例えば1つのバックリンクを指します。制限は呼び出しごとに適用されます。ディープページネーションの上限はクエリごとに適用され、その上限に達した場合は、質問を絞り込むことで対応します。

表の読み方

請求の単位は行ではなく呼び出しです。1,000件のバックリンクを取得しても、10件を取得してもコストは同じで、2クレジットです。

最も安いのはbulk_drです。2,000ドメインの取得には$0.0001かかり、これは行単位の価格における1行分の価格に相当します。ディープページネーションは50,000行で上限に達するため、それ以上の深度ではページネーションではなくクエリを絞り込みます。

新規アカウントには$100の無料クレジット（100万クレジット）が付与されます。その後のチャージはアカウントページからTRC-20形式のUSDTで支払い、そこに表示される残高がすべての呼び出しの引き元となります。

質問に答えられる最も安いアクションの選択

多くの質問には複数のアクションが答え得ます。必要な答えを提供しつつ、クレジットコストが最も低いものを選んでください。

最も安いパスはしばしば2つのステップからなります：大量のリストを低コストでスコアリングし、その後、短縮リストに対して詳細を取得するために有料アクションを使用します。

まずスコアリング、次にリスト化

bulk_drは1回の呼び出しで最大2,000ドメインをスコアリングします。完全なリストに対してこれを実行し、その後、短縮リストに対してのみ2クレジットのリスト取得を行います。

40件のドメインからなる短縮リストの参照ドメインリストを取得するには80クレジット（$0.008）かかります。これはスクリーニングステップに比べれば微々たる金額ですが、まず絞り込む理由となります。

短縮リストのルールを記録しておきましょう。そうすれば毎月の実行で同じ基準が適用され、数値の比較可能性が保たれます。

同業他者セットの比較

compareアクションは最大20ドメインを1クレジットで処理します。このサイズの同業他者セットは1回の呼び出しで収まりますが、各競合他社のリストを取得するには呼び出しごとに2クレジットかかります。

小規模なグループに対して並べて比較する回答に使用します。1つのサイトのみが詳細を必要とする場合にのみリスト取得に切り替えてください。

単一ターゲットアクション

top、dr_distribution、tld_breakdownはそれぞれ1クレジットで、1つのターゲットを受け付けます。これらはリスト取得よりも狭い質問に答えるため、コストが低くなります。

アクションを選ぶ前に、自分がどのような質問をしているか確認してください。間違った質問に対する安い答えも、やはり間違った答えです。

実行前の見積もり

見積もりは単位次第です。ここでは単位が呼び出しであるため、呼び出し回数をカウントし、クレジットを乗算し、最後にドルに変換します。

多くの予期せぬコストは、見積もられなかったステップから発生します。フォローアップのリスト取得やリトライは計画に呼び出しを追加し、それぞれにコストがかかります。

各ワークフローを個別に予算化する

各ジョブタイプを別々に見積もってください。スクリーニング実行、月次監査、単発チェックはそれぞれ異なる形状をしており、それらを平均化すると高コストな部分が隠れてしまいます。

例えば、10,000件の見込み客を週次でスクリーニングするのにbulk_dr呼び出しが5回必要だとします。これは5クレジット、つまり$0.0005です。これはフォローアップ作業が始まる前の段階です。

まずクレジットで、次にドルで予算を記録してください。クレジットは各呼び出しのラインと一致するため、実行計画に対して実際の使用状況をチェックする際に計算が明確になります。

リトライを見込む

リトライは呼び出しを追加します。100回の呼び出し計画に対して10回リトライすると、各リトライが安く見えても、合計で10％の増加となります。

失敗した呼び出しが請求されるかどうかは、このエントリでは明記されていません。どちらの回答を信頼する前に、安いアクションで1回テストし、_credits値を確認してください。

増え続けるループを止める

スクリプトやエージェントは、1回呼び出しを追加すれば役に立つと判断することがあります。上限のないループは、計画で想定したよりもはるかに多くのコストを消費する可能性があります。

コードに上限を設定してください：最大呼び出し数、および残高がジョブの残りで必要な金額を下回った場合に停止する条件。

呼び出しごとの簡単なログ行により、早期に逸脱を検知できます。アクション、ドメイン数、_credits値を記録してください。各バッチの終了時に、累計値を計画と比較します。

すでに支払い済みの回答をキャッシュする

繰り返される質問は最も無駄の多い浪費です。キャッシュは結果を1回保存し、次のリクエストをメモリから応答します。

ドメインだけでなく、アクションごとにキャッシュしてください。同じドメインに対するbulk_drスコアとrefdomainsリストは、異なる答えであり異なる価格を持ちます。

更新が有効期限を設定する

インデックスは約1ヶ月ごとに更新されます。同じ月内での繰り返し呼び出しは通常同じスナップショットを返すため、次の更新まで存続するキャッシュはほとんど損失がありません。

各エントリにタイムスタンプを保持してください。日付のないキャッシュ値は、後でレポートで説明するのが困難になります。

更新頻度よりも頻繁に実行されるジョブは、1つのサイクル内で同じスナップショットに対して2回支払うことになります。キャッシュはこの問題を防ぎます。

キャッシュすべきではないもの

失敗した呼び出しは答えではありません。401や402を結果として保存しないでください。キーまたは残高が修正された場合、次の呼び出しが成功する可能性があるためです。

無料アクションは繰り返し実行しても安いため、それらに対するキャッシュはコードの価値がない場合があります。まず測定してください。

キャッシュキーにはアクション名と、答えを形成するパラメータ（perやsortなど）を含めてください。ソートが異なる2つのリストは異なる結果です。

_credits値を呼び出しごとに読み取る

認証済みレスポンスは常に自身のコストを報告します。表の隣でその値を読み取り、各呼び出しは1つのアクションと1つの価格にマッピングされます。

進行中に値をログに記録してください。アクション名がすでに記録されている場合、説明できない合計値は追跡がはるかに容易になります。

各レスポンスが自身の価格を保持している場合、ドメインランクチェッカーのジョブは監査が最も容易になります。値を表と照合すれば、請求書は謎ではなくなります。

各請求をアクションにマッチさせる

2クレジットを報告するレスポンスは、リスト取得などの2クレジットアクションに属すべきです。3クレジットの請求はsearchまたはkeywordアクションに属します。それ以外は注意深く調べる価値があります。

請求が一致しない場合、残高を確認する前に送信したアクション名を確認してください。間違いは通常、アクションパラメータのタイプミスです。

合計値からループを検知する

ループは、同じコストを持つ多数の同一呼び出しとして現れます。あるアクションの合計が他のアクションよりもはるかに速く増加する場合、終了しないリトライやページネーションステップを探してください。

その合計を先月と比較するのではなく、同じジョブの見積もりと比較してください。ジョブのサイズは実行ごとに変わるためです。