被リンクAPI：保存した応答を、不明な値を捏造せずに調べる

インデックスのデータと注文を区別する

被リンクデータAPIは提供者のインデックスにある観察を構造化して返します。注文APIは商取引の注文を作成・取得する別の機能です。データ取得はリンクを公開せず、注文の受領書も全ウェブの発見結果ではありません。どちらの仕事かを決めてから認証や料金を検討します。ここではDataForSEO v3 Backlinks Liveの公開形式を例にしています。画面の検査は保存した応答をローカル処理し、認証情報を求めたり有料APIを呼んだりしません。予約済み例示ドメインを用いた架空データであり、実際のスキャンや発信者についての主張ではありません。

行より先に応答全体を確認する

エンドポイントの仕様は応答状態、タスク状態、要求データ、結果を分けています。この読み込み機能は指定先の成功タスク一つと結果一つを要求します。応答やタスクの失敗を被リンクゼロに変換せず、提供者のエラー定義を確認してください。HTTPの成功だけではアプリケーションの成功は分かりません。対象、集約方法、フィルターを各記録と保存します。ドメイン、単一ページ、ドメインごと一件では異なる質問になります。提供者は同じ参照元ページの複数の参照を集約できるため、返された一行が物理的な全アンカー一つずつに対応するとは限りません。

四つの架空の観察として読む

例は合計九件と宣言しながら四件だけを含みます。五件はこのファイルに未収録であり、失われたと証明されたのではありません。行には通常のfollowフラグ、sponsoredとnofollow、提供者による消失フラグ、不明な値があります。最終発見日は提供者の過去の観察で、このページが行った最新検査ではありません。検査機能はfalse、ゼロ、欠測を区別し、同じ参照元と対象の組が繰り返されても勝手に統合しません。表は六つの判断を示します。API風JSONは誰でも作成できるため、構造検証は出所の認証や内容の真実性を証明しない点も確認してください。

有料取得の前に範囲と予算を定義する

実際の連携にはサーバー側の秘密情報、承認済み予算、要求パラメーターの記録が必要です。最新料金と制限を調べ、変換前の応答を保存します。続きの取得では同じ問い合わせ条件を維持し、実際の取得件数と提供者の総数を比較し、指定された継続規則に従います。結果が不明な有料要求を無料であるかのように自動再試行しないでください。消失フラグは提供者の観察であり、今日の削除確認ではありません。followの真偽値だけでは全関係属性やページ指示も残せません。Search Console APIにはリンクレポートのメソッドがなく、検索流入行を代用することもできません。

ローカルで読み込み原本を残す

例を読み込むか、対応する応答を貼り付けるか、UTF-8のJSONファイルを選びます。総数、実際の行数、部分結果の警告、要求条件を確認して、表計算用CSVと型を保持するJSONを出力します。欠測と空文字はCSVではどちらも空欄ですが、JSONでは別です。式に見える文字列にはCSVで保護用アポストロフィが付くため、正確な元値は原本で保持します。オフラインではモジュール、コマンド用ファイル、言語別の例を同じフォルダーへ保存してください。下記Node.jsコマンドはローカルファイルのみを読み、通信しません。記入済みと空欄のCSVは解釈用の記録であり、JSON読み込み機能への入力ではありません。

記入済みAPI確認表をダウンロード · 空欄のAPI確認表をダウンロード

node backlink-api-cli.mjs backlink-api-example-ja.json > backlink-api-records.csv
node backlink-api-cli.mjs backlink-api-example-ja.json --json > backlink-api-projection.json

出力の限界を確認する

受け付けるのは一タスク、一結果、最大1,000項目、512 KiBです。選択された要求メタデータには2,000文字の制限があります。全提供者フィールドは出力しないため原本が必要です。日時は渡されたまま保存し、公開日に変えません。参照元へのアクセス、複数ページの結合、アカウント認証も行いません。正しい空の応答も、その要求範囲についての結果にすぎません。出力を調査の入力にし、現在のページの証拠は必要に応じて別途集めます。掲載状態、アクセス、提供者の履歴、検索エンジン登録、順位成果を混同しないでください。小さな再現可能な連携例であり、完全な発見サービスや本番SDKではありません。