Loading Light/Dark Toggle
ブログに戻ります

失敗を隠さずにSERP APIをベンチマークする方法

Alex Johnson
Alex Johnson

Senior Web Scraping Engineer

13-Nov-2026

要約

  • 有用な SERP API ベンチマークは、可用性とレイテンシを合わせて報告する。 発行したすべてのリクエストを可用性の計算に含め、各レイテンシ統計に用いたサブセットの名称を明示する。
  • フィールドのカバレッジには、独自の分母が必要になる。 返ってきた行にタイトルやスニペットが含まれていても、それだけではすべてのクエリが成功したことや、そのテキストが正確であることは証明できない。
  • 再現可能な評価では、クエリ入力・設定・失敗を保持する。 キャッシュの挙動、アカウントのクオータ、タイミング、結果要件の違いによって、比較結果の読み方は変わる。

スピードを測る前に「採用基準」を定義する

SERP API ベンチマークが有用になるのは、その合格条件が、そのデータを利用するアプリケーションの要件と一致しているときだけである。

検索ディスカバリーツールは、オーガニック結果の空ではないリストを必要とするかもしれない。順位モニターは、ターゲット URL を識別できることと、ロケーション設定を比較可能であることも必要になる。引用ワークフローは、遷移先と関連コンテンツの検証を要求する。これらはそれぞれ異なる契約であり、単一の「成功率」パーセンテージですべてを代表させることはできない。

Scrapeless Google Search API を評価する開発者にとって、構造化された JSON インターフェイスは実用的な出発点になる。返ってきたフィールドを検査し、独自の合否ルールを適用しながら基盤となるレスポンスを保持できる。Scraper API ガイド にはリクエストモデルの背景が説明されている。このガイドは、失敗したリクエストを含めて、その評価をレビュー可能にする方法を説明する。

ここでの手法は、2026-08-27 と 2026-10-13 付けの既存レポートの評価基準に基づいている。これは測定手順のガイドであり、新しいベンチマーク実行ではない。公開されたリクエストレベルのデータセットや、独立したベンチマーク結果ページが利用可能である、と主張するものでもない。

1. 転送、検索可用性、タスク成功を分離する

プロトコルステータス、検索結果の可用性、アプリケーションでの受け入れ可否を別々の結果として記録する。

HTTP レスポンスセマンティクスは、プロトコルとしての結果を説明している。ベンチマークでは、これに検索特有のルールを追加する必要がある。基本的なオーガニック検索のルールとしては、レスポンスが完了していること、ビジネスエラーが検出されていないこと、少なくとも 1 件のオーガニックレコードが存在することを要求できる。ワークフローによっては、特定のクエリに対する検証済みの空結果を許容する場合もあるため、その例外は事前に定義し、別枠で報告する。

次の結果を区別できるようにしておくこと:

  • 少なくとも 1 件のオーガニックレコードを含む、利用可能な検索レスポンス。
  • オーガニックレコードを 1 件も含まない、完了したレスポンス。
  • HTTP エラー、またはレスポンス内部のビジネスレベルエラー。
  • クライアント側のネットワークエラー、またはタイムアウト。
  • 最終結果がまだ取得されていない、不完全な非同期タスク。

このシリーズで扱う過去のレポートでは、「利用可能なオーガニック検索」とは HTTP 200、ビジネスエラーなし、オーガニック結果集合が空でないことを意味していた。その歴史的定義は、すべての API モードに対する普遍的なルールではない。Scrapeless クイックスタート では、取得済みデータと、進行中のタスクとを区別している。受理された直後のタスクを、完了した検索として数えるべきではない。

利用可能率は usable requests / all issued requests として計算する。関連性、遷移先リンク、必須フィールドなども検証する場合は、別途アプリケーション側の受け入れ率を保持する。最初の分母を、成功リクエストだけに密かに置き換えてはならない。

2. 固定クエリリストを構築し、設定値を記録する

プロバイダー間で同じクエリ文字列を使い、各プロバイダーが実際に受け取った設定を保持する。

それぞれのクエリに識別子と、ワークロードを反映したカテゴリを割り当てる。記述的クエリ、ブランド検索、アプリケーションが実際に必要とするその他のパターンを含める。再送信したクエリは明示的にマークし、個別に検査できるようにする。クエリを新規に見せかけるためだけに、プロバイダー固有の句読点やランダムなマーカーを追加してはならない。それは比較対象となる入力自体を変えてしまう。

ターゲットとなる国、言語、デバイス、検索モード、結果の深さを記録する。それらの要件を各プロバイダーのドキュメント上のパラメータにマッピングし、合わせられない設定があれば特定する。「US 英語のウェブ検索」は有用なスコープ記述だが、それだけでは、すべてのプロバイダーが同一のデフォルトデバイスや物理的なネットワーク出口を利用したことの証明にはならない。
Scrapeless については、実際の入力仕様を確認する場所として エンドポイントリファレンス を参照してください。機密でないリクエストボディをレスポンスと一緒に保存します。API キーや認可ヘッダーはエビデンスバンドルの外に置いてください。

3. 計測開始点と終了点を明確にしてレイテンシを測る

ベンチマークを実行する前にタイマーを定義し、発行した各リクエストごとに 1 つの継続時間を保持します。

同期呼び出しでは、送信直前から完全なレスポンスを受信するまでを境界として使うと有用です。クライアント側のパースにアプリケーション上の意味がある場合は、それを別途測定します。非同期 API では、主要な指標を初期応答までとするのか、完了結果までとするのかを決め、その指標にラベルを付けてタスクライフサイクルをそれに応じて記録します。

経過時間には、Python の perf_counter のようなモノトニックなパフォーマンスクロックを使用します。壁時計時刻はリクエストがいつ実行されたかを特定するのに有用ですが、経過時間の測定は時計の補正に依存させるべきではありません。

平均、p50、p95 の横にサンプル数を公開します。レイテンシが使用可能なリクエストのみを含む場合は、その旨を値の横に明記します。失敗したリクエストの継続時間は別の分布として保持します。失敗したリクエストに架空の成功継続時間を割り当てたり、リクエスト数から密かに除外したりしないでください。

分位点のアルゴリズムを明示します。最近接順位 (nearest-rank) 計算では、p95 はソート済みの位置 ceil(0.95 × n) を選択します。サンプルが小さいと、p95 が観測された最大値に位置する場合があります。百分位推定手法 は異なるため、ラベルのない p95 は、他はよく似たレポート同士を食い違わせる原因になりえます。

Scrapeless ではじめるスクレイピング

Scrapeless で Web スクレイピングと自動化ワークフローを強化しましょう。
今すぐサインアップして 5 ドル分の無料クレジット を入手 — クレジットカードは不要 です。

今すぐ Scrapeless ダッシュボード で無料クレジットを請求してください。

4. フィールドのカバレッジとリンク品質は別々に測定する

返されたレコードに対するフィールド存在を測定し、フィールドの正しさは別のタスクとして評価します。

スニペットのカバレッジについては、空でないスニペットを持つオーガニック行を数え、返されたすべてのオーガニック行で割ります。集計前に、空白だけの文字列、null 値、欠落したキーをどのように扱うかを決めておきます。分母として用いる行数を保持します。失敗したクエリは返される行を生まないため、高いカバレッジ率が多数の失敗クエリと両立しうる点に注意してください。

同じ区別はリンクにも当てはまります。値が入っているリンクフィールドには、中間の URL が含まれている場合があります。その値が直接の遷移先なのか、リダイレクト先のアドレスなのか、それとも未解決なのかを記録します。一意なリンク文字列であっても、一意なターゲットページを必ずしも識別しません。

Google Search API 概要 では、これらのチェックを構築するために利用可能な構造化出力について説明しています。最も多くのオプションキーにスコアを与えるのではなく、ワークフローが必要とするフィールドを評価します。アプリケーションが引用可能な遷移先を必要とするのであれば、実際にそれらを検証してください。フィールドが存在するという事実だけでは、その性質を確立できません。

5. キャッシュ、同時実行性、クォータ条件を記録する

アカウントおよび実行設定は測定対象システムの一部であり、結果と一緒に記録する必要があります。

キャッシュオプションが有効化されていたか、無効化されていたか、未対応か、不明かを記録します。繰り返しクエリの結果は初回送信とは区別して保持します。繰り返しリクエストが速かったとしても、それだけでキャッシュヒットを証明することにはなりません。プロバイダレベルの検索キャッシュと HTTP レスポンスキャッシュ は異なるレイヤーで動作しうるため、一方についての主張にはそのレイヤーに関するエビデンスが必要です。

また、同時実行数、設定済みタイムアウト、アカウント制限、および実際に送信されたリクエスト数も記録します。アカウントがクォータの境界で停止した場合は、完了した件数とクォータの結果を報告します。発行されなかったリクエストについて、計画されたワークロードサイズを分母として用いてはいけません。

単一試行による評価と、失敗したクエリを再送信するワークフローを区別します。本番ワークフローが追加の試行を行う場合は、その時間とコストを明示的に記録します。再試行によって、初回の可用性測定が別の指標に密かに置き換わってしまわないよう、元の結果を可視のまま維持してください。
コスト比較を行う場合は、実行に紐づく課金を取得し、該当する提供アウトカムで割ってください。クレジット、ドル建て課金、成功した検索は、それぞれ異なる単位です。定価だけでは、完了した評価の実際のコストは確定しません。計画の際には最新の Scrapeless 料金を使用し、そのうえで実行ごとに課金を照合してください。

6. 要約を再計算できるだけの証拠をパッケージ化する

レビュー可能な証拠バンドルがあれば、別のエンジニアが各要約を個々のレコードまで追跡できます。

クエリ一覧、プロバイダ設定、実行環境、および発行されたリクエストごとに 1 件のレコードを保持します。各レコードには、プロバイダ、クエリ、タイムスタンプ、経過時間、HTTP ステータス、ビジネスステータス、エラー種別、オーガニック件数、最終的に利用可能と判断した結果を記録してください。関連するレスポンスへの参照も保持し、認証情報は削除します。

集約コードとそのバージョンをデータと並べて保存します。ページネーションについては、要求したオフセット、1 ページあたりの件数、URL 正規化に用いたルールを含めてください。レスポンスを保持または共有できない場合は、その要約が独立に再現可能であると示唆するのではなく、その制約を説明してください。

結果を公開する前に、発行したリクエストを、利用可能、空、失敗、不完全といったアウトカムに照合します。レイテンシのサンプル数が、文書化されたサブセットと一致していること、およびすべてのパーセンテージに見える分母があることを確認します。過去の要約だけに基づくレポートである場合は、その要約が独立に再計算されていないことを明記すべきです。

結論

明確な SERP API ベンチマークは、開発者がスピードと提供データの両方を評価するための十分な情報を与えます。Scrapeless の構造化検索インターフェースにより、アプリケーションが実際に利用するフィールドを中心にチェックを構築することが現実的になります。固定クエリリストから始め、すべてのアウトカムを保存し、プロバイダ選定の結論を出す前に、可用性をレイテンシと並べて公開してください。

自分のクエリで Scrapeless を評価する

Discord や Telegram でコミュニティと検索データのワークフローについて議論しましょう。

Scrapeless アカウントを作成し、あなたのアプリケーションが実際に必要とする検索結果を評価してください。

よくある質問(FAQ)

Q: 失敗したリクエストはレイテンシ統計から除外すべきですか?

サブセットにラベルを付け、そのサンプル数を示すのであれば、成功したリクエストのレイテンシを報告してもかまいません。失敗リクエストは全体の可用性の分母に残し、その所要時間は別途保持してください。

Q: HTTP 200 レスポンスは成功した検索といえますか?

それだけでは不十分です。ビジネスエラーと期待される結果データを確認し、そのうえで検索タスクに定義された利用可能性ルールを適用してください。

Q: スニペットカバレッジが高ければ検索結果の正確さを証明できますか?

いいえ。スニペットカバレッジは、返された行におけるフィールドの存在を測定する指標です。正確性、関連性、リクエストの可用性、リンク先の有効性は、それぞれ別のチェックが必要です。

Q: 元のログがない過去のレポートは利用できますか?

レポートの所見について、出典を明確にした説明には利用できます。ただし、数値が独立に再計算されていないことを開示し、その記事を新たに再現されたベンチマークや公開された生データの提供として表現するのは避けてください。

Q: Scrapeless の評価では何を保存すべきですか?

クエリ入力、実際のパラメータ、タイムスタンプ、完了したレスポンス、エラーアウトカム、経過時間、および利用可能な結果にラベルを付けるために使用したルールを保存してください。共有する証拠からは認証情報を除外してください。

Scrapelessでは、適用される法律、規制、およびWebサイトのプライバシーポリシーを厳密に遵守しながら、公開されているデータのみにアクセスします。 このブログのコンテンツは、デモンストレーションのみを目的としており、違法または侵害の活動は含まれません。 このブログまたはサードパーティのリンクからの情報の使用に対するすべての責任を保証せず、放棄します。 スクレイピング活動に従事する前に、法律顧問に相談し、ターゲットウェブサイトの利用規約を確認するか、必要な許可を取得してください。

最も人気のある記事

カタログ