リファレンス
バックリンクAPIリファレンス:アクション、コスト、エラー
モニターが知るべき事実を1ページにまとめました:各アクションのコスト、ページネーションの仕組み、APIのエラー発生時の挙動。

クレジットコスト別のアクション
| コスト | アクション | 備考 |
|---|---|---|
| 無料、キー不要 | domain、overview、stats、suggest | ダッシュボードやDRチェッカーに最適 |
| 1クレジット | bulk_dr、compare、top、dr_distribution、tld_breakdown | bulk_drは最大2,000ドメイン(GET domains= または POST body)に対応;compareは最大20 |
| 2クレジット | refdomains、backlinks、anchors、toppages、anchor_cloud、intersect | intersectは2〜10ドメインに対応 |
| 3クレジット | search、keyword | アンカー、タイトル、URLの全文検索;keywordは特定のアンカーテキストでリンクされているサイトを検索 |
認証とステータスコード
キーは key= またはベアラーヘッダーとして渡してください。ボディを解析する前にHTTPコードを確認してください。
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacパラメータとエラー
| 項目 | 値 | 意味 |
|---|---|---|
q | ドメイン | 検索対象 |
page、per | per は 10 から 5000 | ページネーション;1回の呼び出しあたりの行数は最大1,000行、ディープページネーションは最大50,000行まで |
sort、order | order=asc または desc | 返却される行のソート順 |
ok | すべてのレスポンスに含まれる | 呼び出しが成功したかどうか |
_credits | 認証済みレスポンスのみ | 呼び出しのコストと残高 |
| HTTP 401 | キーの不足または誤り | キーまたはヘッダーを確認 |
| HTTP 402 | クレジットが枯渇 | USDT (TRC-20) でチャージ |

スケジューリング前に呼び出しを設計する
APIの問題の多くはリクエストに起因し、レスポンスにはありません。SEOバックリンクAPIの統合は、最初の呼び出し前に下す小さな意思決定の集合です。まずキー、ページサイズ、ソート順を決定してください。
スクリプト内にキーを直接記述しない
キーは環境変数またはシークレットストアに保存し、コミットされるファイルには含めないでください。key パラメータまたはベアラーヘッダーとして渡してください。ヘッダーを使用すると、キーがログに記録されやすいURLに含まれるのを防げます。
本番環境のキーをチケットやチャットに貼り付けないでください。共有ログに表示されたキーは漏洩したものとみなしてください。
意図的にページサイズを選択する
per パラメータは 10 から 5000 の範囲ですが、1回の呼び出しあたり最大1,000行までが1回課金されるため、ページサイズを大きくすると課金回数が減ります。例えば3,400行が必要な場合、10行ずつで340回呼び出すのではなく、1,000行ずつで4回呼び出せば済みます。
実行ごとにページサイズを統一し、ファイルの整合性を保ってください。
ソート順を固定する
sortとorderを明示的に設定し、デフォルトに頼らないようにしてください。パラメータが同一であれば、週ごとの出力が比較可能になり、差分は行の並べ替えではなく、実際の変化を示します。
順序の変更は、誤報を引き起こす簡単な方法です。
数値の読み方
このデータは当社の独自リンクグラフです:181,132,097ドメイン、2,774,625,913ドメイン間リンク、約798.5億のバックリンクが含まれています。これは月1回程度更新されます。それより新しいデータは含まれないため、seo backlinks apiは週1回のポーリングが最適です。
DRはround(100 · log(ref_domains+1) / log(2·10^7))で計算されます。これは対数です。そのため、100の参照ドメインは27、1,000は41、10,000は55というスコアになり、リンク数を倍増させてもポイントの増加はわずかです。DRはサイトのランキング比較に、アラートには生のカウントを使用してください。これはseverity tableが示す通りです。
料金は前払い制です。サブスクリプションも最小利用額もありません。サインアップクレジットは$100で、これは1,000,000クレジットに相当します。これをAhrefs APIのユニットと比較してみましょう。Ahrefsのプランは月$129から200,000ユニットが提供され、リクエストあたり最低50ユニットが必要です。
コスト計画は単純な乗算で可能です。1サイト分の週次refdomains呼び出しは、2クレジット×4回で月8クレジット、つまり$0.0008です。10サイトの場合、その10倍の費用がかかります。lost-link recipeとcompetitor jobは、いずれも上記の表にあるアクションのみを使用します。
推測せずエラーを読む
エラーコードは誰が行動すべきかを示します。そのように読み解きましょう。レスポンスは謎ではなく、ルーティングの判断材料になります。モニターにおいて最も重要なのは401と402の2つのコードです。
401と402は異なる問題です
401はキーが不足しているか間違っていることを意味し、誰かがそれを修正するまで成功しません。402はアカウントのクレジットが不足していることを意味し、チャージで解決します。異なる担当者に振り分けることで、適切な人がメッセージを確認できるようにしましょう。
両方を人物に送信してください。静かに失敗するモニターは、一度も実行されなかったモニターよりも悪いです。
本文よりステータスを先に確認
okフィールドより先にHTTPステータスを読み取ってください。レスポンスはJSONとして解析可能でも、失敗を伴う場合があります。チェックが完了するのは、両方が成功したときだけです。成功時であっても、すべての実行でステータスをログに記録してください。
回復可能なもののみ再試行する
401の再試行はAPIコールの無駄遣いになり、ログには同じ失敗が記録されます。ネットワークタイムアウトとは異なります。再試行する場合は、数回に留め、試行の間に待機時間を設け、その後停止してください。
失敗を隠蔽して延々と再試行を続けるループよりも、停止してアラートを発する実行の方が有用です。
毎回の実行でステータスをログに記録する
成功した実行も含め、毎回の実行でHTTPステータスと残高をログに書き込んでください。3週間後に実行が失敗した際、その行こそが最初に見たい情報になります。
domain、overview、stats、suggestはキー不要で無料です。有料アクションにクレジットを使う前に、ドメイン名の妥当性確認、正確なスペル、またはおおよその規模を確認するためにこれらを活用してください。
cronにコマンドを追加する前に
- アクションのコストは事前に把握でき、月間実行回数で乗算されます。
- 終了コードとHTTPステータスの両方がチェックされます。
- 402エラーは人間へのアラートを送信します。
- レスポンスはソート済みで保存されるため、差分は明確に保たれます。
- 更新頻度は月次リフレッシュに合わせています。

ページネーションに関する注記
順序は重要です。スナップショットには per=1000 を使用し、毎週同じ sort と order を維持してください。実行間で順序が変更されると、差分にノイズが混入します。これが誤警報の典型的な原因です。
規模の大きなサイトの場合、参照ドメイン数が1,000件を超えるサイトでは、page=1、page=2 といったようにページネーションを進めてください。各ページは個別に課金されます。深いページネーションは50,000行までで制限されており、これはほぼすべての一般的なサイトに対応しています。
リファレンスに関する質問
- ドメインの概要が不明な場合、最初にどのアクションを呼び出すべきですか?
overviewまたはdomainから始めてください。これらは無料でAPIキーも不要で、データの概規模と基本的な構造を示します。その後に、refdomainsやanchorsのクレジットを使用してください。- 1つのドメインを完全にチェックするにはどのくらいのコストがかかりますか?
- 各アクションのクレジット数を合計し、実行頻度を掛けます。例えば、1つのドメインに対して
refdomains、anchors、tld_breakdownの呼び出しを週1回実行する場合を考えます。1回の実行で 2 + 2 + 1 = 5クレジット、つまり $0.0005 かかります。4週間では約 $0.002 になります。 - 同じドメインの2つのカウントが一致しない理由は何ですか?
- 同じアクション、同じパラメータ、同じ更新期間で比較してください。異なるアクションからのカウントは互換性がなく、更新途中に取得したカウントは1週間後に取得したものと異なる場合があります。
- クレジットを使わずにcronジョブをテストするにはどうすればよいですか?
- まず無料アクションを実行して、配線、ステータス処理、出力形式を確認してください。次に、数値を確認するために有料呼び出しを1回実行し、テスト中はジョブを1回の実行に制限してください。
- 1,000件以上の参照ドメインを持つサイトでもページネーションは機能しますか?
- はい。
pageとperを使用してください。各ページは個別に課金される呼び出しとなり、深いページネーションは50,000行に制限されますが、これはほとんどの一般的なサイトに対応しています。
悪い週を乗り越えるモニター
何事も順調でない数週間にわたって、モニターは信頼性を築きます。最初の実行前に、応答の遅延、残高の変化、部分的な結果を想定してください。これらは通常の出来事です。それぞれはログに明確な行を残すべきです。
タイムアウトと部分的な取得
すべての呼び出しにタイムアウトを設定し、1つの応答が遅延してもジョブ全体がブロックされないようにします。マルチページ取得で1ページが失敗した場合、どのページが失敗したかを記録し、そのページから再開します。これにより、すでに取得済みの行に対して二重に課金されるのを避けることができます。
部分的なファイルは通常のスナップショットとして保存するのではなく、部分的なファイルとしてマークします。さもないと、次の差分では実際には発生していないデータ消失が表示されてしまいます。
残高チェック
認証済みレスポンスのたびに _credits を読み取り、残高をログに記録します。小さなスクリプトで、設定した下限額と比較し、次の実行前に警告を送信することができます。
下限額を500クレジットと設定した場合、週次実行で40クレジット消費であれば、夜中に402エラーが発生する前にチャージする余裕が生まれます。
ジョブを単調に保つ
各ジョブには1つのファイルと1つのスケジュールを割り当てます。1つのcronジョブで3つのことを実行すると、3つの方法で失敗する可能性があり、ログではどの失敗が発生したかが必ずしも明確ではありません。2つの小さなジョブの方が、1つの複雑なジョブよりも信頼しやすくなります。
スケジュールを更新頻度に合わせる
ジョブのスケジュールを時計の刻ではなく、月次更新に合わせてください。毎日実行すると、多くの日で同じファイルが返され、コストとノイズが増加するだけで情報は追加されません。通常、週次で十分です。