Google Web Search — API リファレンス
/google/searchSearch
q、言語 hl、国 gl、対応デバイスで Google ウェブ検索を実行します。結果の構成はクエリと取得元の応答によります。
q、言語 hl、国 gl、対応デバイスで Google ウェブ検索を実行します。結果の構成はクエリと取得元の応答によります。
qstring必須
検索クエリ文字列。
hlstring任意
言語コード。デフォルトは en。
glstring任意
国コード。デフォルトは us。
pagenumber任意
1 始まりのページ番号。デフォルトは 1。
device"default" | "pc" | "mobile"任意
Google Search のみ。default は自動ルーティング、pc はデスクトップセッション、mobile はモバイルセッションを使用します。
{
"device": "mobile",
"gl": "us",
"hl": "en",
"q": "coffee shops"
}querystring必須
リクエストから正規化されたクエリ。
pagenumber必須
現在の 1 始まりのページ番号。
organicOrganicResult[]通常検索結果が解析された場合。
通常検索結果。
featured_snippetFeaturedSnippetGoogle が強調スニペットを表示する場合。
通常結果とは別に返す強調スニペットの回答カード。
top_storiesTopStory[]検索結果にトップニュースがある場合。
トップニュースのモジュール。
people_also_askPAA[]関連質問が存在する場合。
質問、回答、出典リンク。
knowledge_graphKnowledgeGraphナレッジパネルが解析された場合。
エンティティのパネルデータ。
related_searchesstring[]関連検索候補が見つかった場合。
関連する検索クエリ。
ranknumber必須
このレスポンス内の 1 始まりの順位。
positionnumber利用可能な場合は rank のエイリアス。
position を期待するクライアント向けの正規化順位。
titlestring必須
結果タイトル。
linkstring必須
parser が返す主リンク。
urlstring結果リンクを正規化できる場合に返ります。
正規化されたターゲット URL。通常は link と同じです。
source_urlstringGoogle のリダイレクト元 URL がある場合のみ返ります。
デバッグと出所確認のために保持される元の Google URL。
display_urlstringGoogle の表示テキストまたはドメインを取得できる場合。
表示 URL またはソースドメイン。
display_linkstringGoogle の表示テキストがある場合。
Google のリンク表示テキストの原文。
snippetstringスニペットが解析された場合。
通常検索結果の要約。
datestringGoogle がスニペットに日付を含める場合。
スニペットから抽出した日付の原文。
published_atstring解析日付があればその別名。
正規化された日付の別名。
iconstringファビコンや画像が公開されている場合。
結果アイコンの URL。
sitelinks{ title, link, url, source_url?, display_url? }[]サイトリンクが存在する場合。
通常結果に属する入れ子のサイトリンク。
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'既存の Google リクエスト例
curl -X POST https://api.serpbase.dev/google/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio",
"hl": "en",
"gl": "us",
"page": 1,
"device": "default"
}'検索 grounding、SEO チェック、回答抽出。
検索結果に対応モジュールがあれば ai_overview、weather、finance、flight、result_stats も返されます。