798.5億件のバックリンクをインデックス済み
自社ダッシュボード向けのドメインバックリンクチェック
参照ドメイン、アンカーテキスト、トップページ、DRをJSONで返すRESTエンドポイント。このエンドポイントを中心にツールを構築し、最初の$100分の呼び出し料は当社負担です。
- 4つのアクションはキー不要
- 1回の呼び出しで最大2,000ドメインをスコアリング
- CORS対応、Bearerトークンまたはクエリ文字列キー
$ curl "https://seomasters.dev/api.php?action=overview&q=nytimes.com&key=sk_live_..."
用途
ドメインバックリンクチェック: 最初に接続する4つのエンドポイント
すべてのアクションはqにターゲットを指定し、okフラグ付きのJSONを返します。聞こえが良いからではなく、画面の要件に合わせて選択してください。
無料の検索、キー不要
domain、overview、stats、suggestは無料です。公開ウィジェットやCIでのスモークテストに使用してください。
ポートフォリオ全体の一括DR
bulk_drは1クレジットで1回あたり最大2,000ドメインをスコアリングします。1回の夜間リクエストで大きなクライアントリストをカバーできます。
参照ドメインとアンカーテキスト
refdomains、anchors、backlinksは1回あたり2クレジット、最大1,000行まで取得可能で、page、per、sort、orderパラメータに対応しています。
ギャップテーブル用のインターセクト
intersectは2〜10ドメインを受け取り、それらにリンクしている共通のドメインをリストします。行数に関係なく2クレジットです。
対象者
JSONの裏側にあるもの
数値は当社の独自クローラーと独自リンクインデックス由来です：181,132,097ドメイン、2,774,625,913ドメイン間リンク、約798.5億のバックリンク。第三者からの再販売は一切行いません。
インデックスは月1回程度更新されます。先週貼られたリンクが欠落している可能性があるため、生データであることを示すのではなく、インデックスの更新日を表示するUIを設計してください。
認証済みレスポンスには、呼び出しコストと残高を示す_creditsオブジェクトが含まれます。これをログに記録してください。経理担当者は支出先を問うでしょうが、その答えはすべてのレスポンスに含まれています。
コードを書く前に2つのページを読む価値があります：DRフィールドリファレンスは0〜100のスコールの意味を説明し、ダッシュボードプロキシガイドではキーの配置場所を示しています。
最初のレンダリングに数値が必要ですか？
ページを読む対象によります。検索エンジンにインデックスさせたい公開検索ページには、HTMLに数値を既に含めるべきです。ログイン後のダッシュボードは読み込み後に行を取得できますが、低速なスマートフォンで空白のテーブルが表示されると壊れているように見えます。
推奨するデフォルトはシンプルです：サーバーがAPIを呼び出し、行をレンダリングし、ブラウザはソートとフィルタリングのみを行います。プロキシガイドでは、Next.jsにおけるその分割方法とルートハンドラーの実装を示しています。
キーの配置場所について、もう一度
キーは訪問者が開けるページには置かないでください。サーバー環境変数に保持し、そのシークレットが存在する環境で実行されるコードから呼び出してください。
キーをバンドルに隠すと約束するツールは、カジュアルな読者からは隠しますが、ネットワークタブを開いている人からは隠せません。
エンドツーエンドで1リクエスト
キーに置き換えてください。qの値は、スキームやパスを含まないドメイン本体です。
curl -s "https://seomasters.dev/api.php?action=refdomains&q=example.com&per=100&sort=dr&order=desc" \
-H "Authorization: Bearer sk_live_..."
# header or ?key= both work
# ok=false or HTTP 401/402 means stop and read the errorチェックリスト
最初の本番デプロイの前に
- キーはサーバー側の環境変数に存在し、ブラウザバンドルには含まれない
- すべてのレスポンスはHTTPステータスだけでなく、
okもチェックされる - HTTP 401と402は自動的に再試行されない
_creditsは各呼び出し時に独自のログに書き込まれる- UIは月次更新を表示するため、データが生データとして読まれない
- ページネーションは50,000行の上限で停止し、無限ループしない
スコープ
リンクデータAPIであり、フル機能のSEOスイートではない
キーワード調査、順位トラッキング、毎日更新されるクロールは、AhrefsまたはSemrushの方が適しています。Ahrefsは月額$129から200,000ユニットのサブスクリプションにAPIユニットが含まれています。このAPIは、リンクデータを呼び出しごとに価格設定します。
- 適した用途：ダッシュボード、監査、一括スコアリング、内部ツール
- 不向きな用途：順位トラッキング、キーワードボリューム、ライブリンクアラート
- データは月次で更新され、ドキュメントの冒頭で明記されています
仕組み
サインインから夜間のジョブまで
FAQ
開発者が最初に尋ねる質問
- APIを介したドメインバックリンクチェックはどのように機能しますか？
qにドメインを指定し、overview、refdomains、またはbacklinksなどのアクションに送信してJSONを読み取ります。無料アクションにはキーは不要です。有料アクションは、行の数に関係なく、1回あたり1〜3クレジットで、bearerヘッダーまたはkey=としてキーを指定する必要があります。- キーをブラウザに配置する必要がありますか？
- いいえ、配置すべきではありません。CORSはオープンなので、ブラウザからAPIを呼び出すことは可能ですが、クライアントコード内のキーはすべての訪問者に公開されます。有料呼び出しはサーバー側で行い、フロントエンドは独自のエンドポイントを介して通信してください。
- クレジットが枯渇した場合はどうなりますか？
- APIはHTTP 402を返します。キーがない場合や誤っている場合はHTTP 401が返されます。これらは再試行するのではなく、停止のシグナルとして扱ってください。アカウントページからUSDT (TRC-20)でチャージし、同じキーは引き続き機能します。
- 1回の呼び出しで何行返されますか？
- 1回の呼び出しで最大1,000行が返され、行の数に関係なく1回の呼び出しとして課金されます。
pageとperでページネーションを行い、深層ページネーションは50,000行に制限されています。より大きなエクスポートには、ソートや異なるアクションを使用してクエリを絞り込んでください。 - DRはAhrefsの数値と同じですか？
- いいえ。ここでのDRは当社の独自指標です：round(100 log(ref_domains + 1) / log(2 10^7))。AhrefsのDRやMozのDAと精神論は似ていますが、独自のインデックスから計算されるため、ツール間で値を比較するのではなく、1つのツール内でトレンドを比較してください。
- リンクデータはどのくらい最新ですか？
- おおよそ1ヶ月です。インデックスは月1回程度再構築されるため、最近のリンクが欠落している可能性があります。製品が新しいリンクの毎日アラートを約束している場合、毎日クローリングを行うベンダーが必要で、このAPIは安価なバルク数値用です。
- 月額料金や最低利用額はありますか？
- サブスクリプションも最低利用額もありません。クレジットは前払い制です：1クレジットは$0.0001で、1,000回の1クレジット呼び出しは$0.10です。新規アカウントにはGoogleサインインのみでカード不要の$100無料クレジットが付与されます。
