検索結果を30件リクエストしたのに、なぜ9件しか返らなかったのか？

この記事は2026年9月7日にIntrix Labが韓国語で公開した記事の翻訳です。

商用SERP APIはnum=30のリクエストを正常に処理したように応答しましたが、実際の結果は9件だけでした。 2026-08-19の実測では、num=10、num=30、num=100のいずれも9件を返し、呼び出しごとに1クレジットがそのまま差し引かれました。次のページを直接リクエストしてさらに10件を取得すると、引用元との重複率は65%から94%に変わりました。

正常な応答なのに、なぜ失敗なのでしょうか？

この事例の問題は、エラーコードがなかったことです。APIはリクエストした結果件数を反映しないまま、正常な応答を返しました。収集プログラムは応答の成功したかどうかだけを確認していたため、結果が不足した状態を完了として記録しました。

1ページ当たりの返却件数は、リクエスト値にかかわらず7〜10件にとどまりました。検索結果の取得範囲は、件数パラメータではなくページパラメータでのみ広がりました。

どのように検証したのでしょうか？

同じクエリで結果件数のパラメータだけを変え、num=10、num=30、num=100を順に呼び出しました。すべての呼び出しについて、organic配列の長さとpositionの最大値を照合しました。リクエスト値は異なりましたが、返却件数はいずれも9件でした。

その後、page=2を送信し、さらに10件を取得しました。件数を増やすリクエストと、次のページへ進むリクエストを分けて再現したものです。

リクエスト	返却結果	確認した状態
num=10	9件	正常な応答、1クレジット消費
num=30	9件	正常な応答、1クレジット消費
num=100	9件	正常な応答、1クレジット消費
page=2	さらに10件	検索結果の取得範囲が拡大

リクエスト文字列だけを残しても、この失敗を再構成することはできません。応答配列の長さとpositionの範囲も記録して初めて、リクエスト値が適用されたかを判定できます。費用が差し引かれた事実も、結果の取得範囲が十分だった根拠にはなりません。

検索結果の取得範囲で、指標はどれほど変わったのでしょうか？

当初は上位30件をリクエストしたと考え、引用元との重複率を65%と計算しました。ページネーションで検索結果の取得範囲を確保してから再計算すると、重複率は94%でした。当初の数値は29%p低かったことになります。

この差は、分析式を変えた結果ではありません。検索結果をリクエストした範囲まで取得できず、分母が変わった結果です。収集漏れを引用元の不一致と誤って解釈しかねない構造でした。

空の結果を、不在の証拠と見なしてよいのでしょうか？

見なせません。この実測で返却件数が少なかったのは、検索結果がなかったからではなく、APIが件数パラメータを反映しなかったからです。空の結果と途中で切られた結果を同じ状態として保存すると、後続の分析でどちらだったのか区別できません。

収集プログラムは何を記録すべきでしょうか？

成功コードだけを信頼せず、リクエストした範囲を実際に取得できたかも確認する必要があります。応答が空の場合と、応答が途中で切られた場合も、異なる状態として扱う必要があります。

無料SEO・GEO診断では、実際のリクエストでサイトの現在の状態を確認し、解釈に用いた母集団と収集範囲を分けて提示します。

この結果はどこまで適用できるのでしょうか？

実測の対象は商用SERP APIの1種類でした。韓国語の地域サービス業に関するクエリ4件と、英語の一般的なクエリ1件を確認しました。他のAPIや他のクエリにも同じ返却制限があると一般化することはできません。

ただし、検証の原則はそのまま適用できます。APIがリクエストを受け付けたことと、リクエストどおりに応答したことは同じではありません。応答のサイズと範囲をログで照合して初めて、エラーを伴わない欠落を検出できます。

よくある質問（FAQ）

Q. num=30を送れば、30件を取得したと考えてよいですか？
いいえ。この実測ではnum=30に正常な応答が返りましたが、organicの結果は9件でした。応答配列の長さとpositionの最大値を別途確認する必要があります。

Q. 結果をさらに取得するには、何を変える必要がありますか？
このAPIでは、結果件数のパラメータではなくページパラメータで取得範囲を確保しました。page=2をリクエストしたところ、さらに10件が返されました。

Q. この欠落は分析結果に実際に影響しましたか？
はい。引用元との重複率はページネーション前の65%から実施後の94%に変わり、当初の数値は29%p低くなっていました。