ドキュメント
エンドポイントリファレンスと料金
1つのURL、複数のアクション。これがAPIの全機能です。
SEOCheckリサーチチーム ·

アクションとコスト
| アクション | クレジット | 返されるデータ |
|---|---|---|
| domain | 無料 | 1ドメインの基本レコードとDR |
| overview | 無料 | ドメインのリンクプロファイルの概要 |
| stats | 無料 | インデックス全体の統計 |
| suggest | 無料 | 入力中のドメイン候補 |
| bulk_dr | 1 | 最大2,000ドメインのDR |
| compare | 1 | 最大20ドメインの並列比較 |
| top | 1 | 上位ドメイン |
| dr_distribution | 1 | リンク元ドメインのDR分布 |
| tld_breakdown | 1 | トップレベルドメイン別のリンク |
| refdomains | 2 | 参照ドメイン |
| backlinks | 2 | 個別バックリンク |
| anchors | 2 | アンカーテキスト |
| toppages | 2 | 最多リンクページ |
| anchor_cloud | 2 | アンカー重み |
| intersect | 2 | 2〜10ドメインの共通リンク元 |
| search | 3 | アンカー、タイトル、URLの全文検索 |
| keyword | 3 | 正確なアンカーでリンクされているサイト |
認証と形式
ベースURL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_...。ヘッダーを優先しますか?その場合は代わりに Authorization: Bearer sk_... を送信してください。
このバックリンク分析APIはJSON形式で応答し、クロスオリジン呼び出しを許可するため、ブラウザから直接アクセス可能です。すべての応答には ok フィールドが含まれます。認証済み応答には _credits も含まれ、そこにはその呼び出しのコストと残高が保持されます。
エラーは簡潔です。HTTP 401はキーが不足しているか誤っていることを意味します。HTTP 402は残高が枯渇したことを意味します。どちらも処理が容易で、ループで再試行すべきではありません。
最初の有料呼び出しの前に
- 既知のドメインで
overviewを実行します。これは無料です。 compareなどの1クレジットの呼び出しでキーが機能することを確認します。- 応答の
_creditsを読み、コストが上記のテーブルと一致することを確認します。 - HTTP 402の時にスクリプトアラームを設定し、残高枯渇による静かな失敗を防ぎます。
ページネーションとソート
1回の呼び出しで返される行数は最大1,000です。per で10〜5000の範囲で行数を指定し、page で移動し、sort と order で順序を指定します。
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
回答を変更するパラメータ
すべてのアクションは同じ2つの基本パラメータ action と q を取り、その後短いオプションのセットを取ります。まずそれらを読んでください。多くのミスは、オプションが任意に見えるがコストや行の形状を変更するためです。フォーラムやブログから呼び出しをコピーする前にオプションを確認してください。
以下の例は key パラメータにキーが含まれていることを前提としています。プレースホルダーを自分のキーに置き換えてください。キーはコミットされるファイルではなく環境変数に保持してください。このバックリンク分析APIリファレンスのすべての例は同じベースURLを使用します。
page と per によるページネーション
per オプションは10〜5000の範囲で返される行数を設定します。page オプションはセット内を移動します。500行を要求して次に page 2 を呼び出すと、同じ行の次のプルではなく、次のブロックが返されます。
深いページネーションは50,000行で停止します。それ以上のデータが必要な場合は、sort でクエリを絞り込むか、ドメインごとに作業を分割し、すべての呼び出しが制限内に収まるようにします。
sortとorderによるソート
スクリプト内ではなくサーバー側でソートしてください。sort=dr&order=descを指定すると、リンク元のドメインが強い順に返されるため、注目すべき行が最初のページに表示されます。全データをダウンロードしてからフィルタリングすると、時間とクレジットの両方が無駄になります。
弱い行を確認したい場合(例えばリンクが薄いリンクやプロファイルの急な減少を発見したい場合など)は、order=ascを使用してください。
リスト: bulk_dr、compare、intersect
リストアクションは1回の呼び出しで複数のドメインを処理します。bulk_drはGETクエリ文字列またはPOSTボディで最大2,000件のドメインを1クレジットで受け付けます。compareは最大20件のドメインを、intersectは2〜10件のドメインを受け付けます。
価格が行数に依存しないため、1回の呼び出しで長いリストを処理する方が、短い呼び出しを多数行うよりも安価です。例えば、月曜日に1,500件の見込みサイトをチェックする場合、それは1,500回の呼び出しではなく、1回の呼び出しで済みます。
検索とキーワード呼び出しは高コスト
searchアクションはアンカー、タイトル、URLに対して全文検索を実行します。keywordアクションは、特定のアンカーテキストでリンクされているサイトを特定します。どちらも1回あたり3クレジットかかるため、ブラウジング用ではなく、特定の質問に答えるために使用してください。
初回取得におけるperとpageの選択
新しいドメインを初めて確認する際は、perを50などの小さな値から始めてください。短いレスポンスで、行の構成、フィールド名、コストを確認できます。行が期待どおりであることが分かってから、perの値を上げてください。この習慣は、上記のテーブルにあるすべてのアクションに適用できます。
よくあるミスは、最初の試行で5000行をリクエストし、その大部分を破棄することです。レスポンスが大きくなり、待機時間も長くなりますが、期待していた節約効果は得られません。
クレジットメーターの読み方
認証済みのレスポンスの末尾には_creditsが含まれており、その呼び出しのコストとそれ以降の残高が示されます。これをログに記録してください。月末に加算すれば、セント単位での実際の請求額がわかります。
大まかな予算計画が役立ちます。1,000回のrefdomains呼び出しには2,000クレジット($0.20)かかります。1,000回のsearch呼び出しには3,000クレジット($0.30)かかります。2,000件のドメインリストに対する毎日のbulk_dr実行は1クレジット(月約$0.003)です。
Ahrefsが掲載しているように、200,000 APIユニットで月$129から始まるプランと比較すると、請求書の形状は異なります。その理由については比較をご覧ください。

エラーと_creditsフィールドの読み方
レスポンスは2つの異なる方法で失敗する可能性があり、コードではこれらを区別して処理する必要があります。これらは異なる問題です。キーが無効な場合は設定の問題であり、残高が空の場合は課金の問題です。両方を1つの汎用エラーとして処理すると、必要な修正がわかりにくくなります。
まずokフィールドを読み、次に_creditsブロックを読み、その後に行を確認してください。呼び出しのコストが既に分かっている場合、結果が不足している場合や短い場合の説明は容易になります。
401と402を個別に処理する
HTTP 401はキーが不足しているか間違っていることを意味します。ジョブを停止し、キーを修正してください。HTTP 402は残高が尽きたことを意味します。アカウントページからチャージし、続行してください。401で再試行しても効果はなく、チャージせずに402で再試行しても効果はありません。
実行前後の残高をログに記録する
実行の開始時と終了時に_creditsの残高を記録してください。差分は、実行した呼び出しから予想されるコストと一致すべきです。差分が大きすぎる場合は、ループが意図したよりも多く実行されたことを意味します。
素早いチェックには、呼び出し数をクレジットコストで掛けます。答えが40で、残高が4,000減少した場合は、価格リストではなくスクリプトに問題があります。
リクエストした行を確認する
行数が期待より少ない成功レスポンスは、自動的にエラーではありません。小さなドメインにはリンクが少ないだけかもしれません。行数を送信したper値と比較し、ギャップを隠すべき欠陥ではなく、解くべき質問として扱ってください。
低コストの呼び出しからテストする
ジョブに呼び出しを組み込む前に、手動で最小限のオプションで1回実行してください。レスポンス、フィールド名、_credits値を確認してください。2行目で失敗するジョブよりも、最初の試行で失敗した呼び出しの方がデバッグが容易です。
APIとの最初のセッション
理解している呼び出しから順に4つの呼び出しを行います。最初の呼び出しのみが無料ですが、これは意図的なものです。
既知のドメインでランオーバービューを実行する
これは無料であり、キーは不要です。サマリーをサーチコンソールとサイト自体で確認し、通常のレスポンスがどのようなものか把握してください。
1クレジットの呼び出しでキーをテストする
あなたのドメインと1つの競合他社でcompareを送信します。okフィールドがtrueであり、_creditsに1クレジットのコストが表示されることを確認してください。
小さなperで2クレジットのリストを取得する
refdomainsをper=50およびsort=drでリクエストします。行数とクレジットコストが上記のテーブルと一致することを確認してください。
コストをログに記録する
前後の残高を記録してください。これ以降、作成するすべてのスクリプトはこの習慣から始め、予期せぬ請求は謎ではなくログの1行になります。
料金体系
前払いクレジット。1クレジットは$0.0001です。サブスクリプションや月間の最低利用額はありません。
知っておくべき制限
インデックスは181,132,097件のドメインと2,774,625,913件のドメインリンクをカバーしています。おおよそ月1回のペースで更新されます。これは日次クローリングよりも低速です。
ディープページネーションは50,000行で停止します。より大きなデータ取得には、sortでクエリを絞り込むか、ドメインごとに分割してください。
サインインはGoogleのみ、チャージはUSDTです。DRチェッカーで始め、競合ガイドで競合監査を試すか、純粋なリンク作業のためにAhrefs APIを離れる理由を読んでください。
よくある質問
行数ごとに支払いますか?
いいえ。10行返しても1,000行返しても、呼び出しは1回として課金されます。
クレジットが尽きたらどうなりますか?
APIはHTTP 402を返します。アカウントページからUSDT (TRC-20)でチャージし、続行してください。
キーはどこで確認できますか?
Googleサインイン後のダッシュボードにあります。