コンテンツへスキップ
SEOCheck$100無料クレジットを取得

ドキュメント

エンドポイントリファレンスと料金

1つのURL、複数のアクション。これがAPIの全機能です。

SEOCheckリサーチチーム ·

霧のかかった谷を横断する丈夫な石橋、信頼性の高いAPIエンドポイントを表す

アクションとコスト

アクションクレジット返されるデータ
domain無料1ドメインの基本レコードとDR
overview無料ドメインのリンクプロファイルの概要
stats無料インデックス全体の統計
suggest無料入力中のドメイン候補
bulk_dr1最大2,000ドメインのDR
compare1最大20ドメインの並列比較
top1上位ドメイン
dr_distribution1リンク元ドメインのDR分布
tld_breakdown1トップレベルドメイン別のリンク
refdomains2参照ドメイン
backlinks2個別バックリンク
anchors2アンカーテキスト
toppages2最多リンクページ
anchor_cloud2アンカー重み
intersect22〜10ドメインの共通リンク元
search3アンカー、タイトル、URLの全文検索
keyword3正確なアンカーでリンクされているサイト

認証と形式

ベース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 で順序を指定します。

bash
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から始まるプランと比較すると、請求書の形状は異なります。その理由については比較をご覧ください。

異なるエラータイプを表す2つの異なる重りをつり合わせる、ヴィンテージの真鍮の天秤

エラーと_creditsフィールドの読み方

レスポンスは2つの異なる方法で失敗する可能性があり、コードではこれらを区別して処理する必要があります。これらは異なる問題です。キーが無効な場合は設定の問題であり、残高が空の場合は課金の問題です。両方を1つの汎用エラーとして処理すると、必要な修正がわかりにくくなります。

まずokフィールドを読み、次に_creditsブロックを読み、その後に行を確認してください。呼び出しのコストが既に分かっている場合、結果が不足している場合や短い場合の説明は容易になります。

401と402を個別に処理する

HTTP 401はキーが不足しているか間違っていることを意味します。ジョブを停止し、キーを修正してください。HTTP 402は残高が尽きたことを意味します。アカウントページからチャージし、続行してください。401で再試行しても効果はなく、チャージせずに402で再試行しても効果はありません。

実行前後の残高をログに記録する

実行の開始時と終了時に_creditsの残高を記録してください。差分は、実行した呼び出しから予想されるコストと一致すべきです。差分が大きすぎる場合は、ループが意図したよりも多く実行されたことを意味します。

素早いチェックには、呼び出し数をクレジットコストで掛けます。答えが40で、残高が4,000減少した場合は、価格リストではなくスクリプトに問題があります。

リクエストした行を確認する

行数が期待より少ない成功レスポンスは、自動的にエラーではありません。小さなドメインにはリンクが少ないだけかもしれません。行数を送信したper値と比較し、ギャップを隠すべき欠陥ではなく、解くべき質問として扱ってください。

低コストの呼び出しからテストする

ジョブに呼び出しを組み込む前に、手動で最小限のオプションで1回実行してください。レスポンス、フィールド名、_credits値を確認してください。2行目で失敗するジョブよりも、最初の試行で失敗した呼び出しの方がデバッグが容易です。

APIとの最初のセッション

理解している呼び出しから順に4つの呼び出しを行います。最初の呼び出しのみが無料ですが、これは意図的なものです。

01

既知のドメインでランオーバービューを実行する

これは無料であり、キーは不要です。サマリーをサーチコンソールとサイト自体で確認し、通常のレスポンスがどのようなものか把握してください。

02

1クレジットの呼び出しでキーをテストする

あなたのドメインと1つの競合他社でcompareを送信します。okフィールドがtrueであり、_creditsに1クレジットのコストが表示されることを確認してください。

03

小さなperで2クレジットのリストを取得する

refdomainsをper=50およびsort=drでリクエストします。行数とクレジットコストが上記のテーブルと一致することを確認してください。

04

コストをログに記録する

前後の残高を記録してください。これ以降、作成するすべてのスクリプトはこの習慣から始め、予期せぬ請求は謎ではなくログの1行になります。

料金体系

前払いクレジット。1クレジットは$0.0001です。サブスクリプションや月間の最低利用額はありません。

無料アクション

$0

  • domain、overview、stats、suggest
  • キー不要
  • ウェブチェッカーを駆動
チェッカーを開く

従量課金

$0.101,000回の1クレジット呼び出しあたり

  • サインアップ時に$100の無料クレジット
  • カード不要
  • USDT (TRC-20)でチャージ
  • 行数ではなく1回呼び出しごとに課金
$100無料獲得

知っておくべき制限

インデックスは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サインイン後のダッシュボードにあります。