レスポンスの形式
Every Google engineは同じトップレベル構造を返します。organic_results 内の具体的なフィールドやSERP機能ブロックはエンジンによって異なりますが、外側の構造は同一です。
トップレベルフィールド
Section titled “トップレベルフィールド”| Field | Type | Description |
|---|---|---|
search_metadata | オブジェクト | クエリのエコー、処理時間、リクエストID |
search_parameters | オブジェクト | 送信したすべてのパラメータ |
search_information | オブジェクト | 総結果数、表示されたクエリ |
organic_results | 配列 | ランク付けされたウェブ結果 |
pagination | オブジェクト | 次/前ページのカーソル |
serpapi_pagination | オブジェクト | 正規のページネーションヘルパー |
ページに存在する場合、SERP機能は追加のトップレベルフィールドとして表示されます。
| Field | Engine that returns it |
|---|---|
ads | |
answer_box | |
knowledge_graph | |
related_questions | |
related_searches | google, bing, yandex |
inline_images | |
inline_videos | |
local_results | |
local_map | |
shopping_results | google_shopping |
news_results | google_news |
jobs_results | google_jobs |
events_results | google_events |
places_results | google_maps |
reviews_results | google_maps_reviews |
interest_over_time | google_trends |
search_metadata
Section titled “search_metadata”{ "id": "66f4a7b2e4b00b0001a1b2c3", "status": "Success", "created_at": "2026-02-01T12:34:56.789Z", "processed_at": "2026-02-01T12:34:58.012Z", "google_url": "https://www.google.com/search?q=pizza&...", "raw_html_file": "https://serp.shifter.io/raw_html/...", "total_time_taken": 2.31}organic_results
Section titled “organic_results”{ "organic_results": [ { "position": 1, "title": "Best Pizza in Chicago", "link": "https://example.com/pizza", "displayed_link": "example.com", "snippet": "Chicago's deep dish institution since 1955...", "favicon": "https://example.com/favicon.ico", "sitelinks": { "...": "..." } } ]}pagination
Section titled “pagination”{ "pagination": { "current": 1, "next": "https://serp.shifter.io/v1?engine=google&q=pizza&start=10&...", "other_pages": { "2": "...start=10...", "3": "...start=20..." } }}次のページには start を渡します(10、20、…)。または next のURLを直接たどることもできます。
エラーレスポンス
Section titled “エラーレスポンス”失敗した場合、トップレベルには error と error_code のみが含まれます。
{ "error": "Your API key is invalid", "error_code": 401}