API パラメータ
Google Search API は以下のパラメータによって動作します。これらはリクエストの input オブジェクト内で渡されます(Getting Started を参照)。必須なのは q のみです。他のすべてのパラメータは任意であり、場所、言語、ページネーション、または結果のタイプを絞り込むために使用されます。
| パラメータ | 必須 | 説明 |
|---|---|---|
url | false | Google Search の完全なアクセスリンク。他のすべてのパラメータと相互に排他です。 このパラメータが入力されている場合、他のリクエストパラメータを渡す必要はなく、渡されたとしても自動的に無視されます。 |
q | true | 検索したいクエリを定義します。通常の Google 検索で使用できるもの(例: inurl:、site:、intitle:)なら何でも使用できます。as_dt や as_eq などの高度な検索クエリパラメータもサポートされています。 |
location | false | 検索の発信元となる場所を定義します。複数の場所が一致する場合は、最も人気のあるものが使用されます。location と uule は同時に使用できません。実際のユーザーの検索をシミュレートするには、市区町村レベルで location を指定することをお勧めします。省略した場合、検索はプロキシの場所を反映する可能性があります。 |
uule | false | 検索に使用する Google エンコード済みの場所。uule と location は同時に使用できません。 |
ludocid | false | スクレイピングしたい Google My Business リストの ID (CID) を定義します。Google Place ID とも呼ばれます。 |
lsig | false | ナレッジグラフのマップビューを強制的に表示するために使用する場合がある ID。lsig ID は、Local Pack API または Google Local API、および Google My Business 内で Google が使用するリダイレクトを通じて取得できます。 |
kgmid | false | スクレイピングしたい Google ナレッジグラフ リストの ID (KGMID) を定義します。kgmid を使用した検索は、元の暗号化された検索パラメータの結果を返します。一部の検索では、kgmid が start と num を除く他のすべてのパラメータを上書きする場合があります。 |
si | false | スクレイピングしたい Google 検索のキャッシュされた検索パラメータを定義します。si を使用した検索は、元の暗号化された検索パラメータの結果を返します。一部の検索では、si が start と num を除く他のすべてのパラメータを上書きする場合があります。si は Google ナレッジグラフのタブをスクレイピングするために使用できます。 |
ibp | false | 一部の要素のレイアウトと展開のレンダリングを担当します(例: ludocid を使用した検索を拡張ナレッジグラフ用に展開する gwp;0,7)。 |
uds | false | 検索のフィルタリングを有効にします。Google がフィルタとして提供する文字列です。uds の値は「filters」セクションで提供され、各フィルタに対して uds、q、および serpapi_link の値が提供されます。 |
google_domain | false | 使用する Google ドメインを定義します。デフォルトは google.com です。サポートされているドメインの完全なリストについては、Google ドメインのページを参照してください。 |
gl | false | Google 検索に使用する国を定義します。2 文字の国コードです(例: 米国は us、英国は uk、フランスは fr)。 |
hl | false | Google 検索に使用する言語を定義します。2 文字の言語コードです(例: 英語は en、スペイン語は es、フランス語は fr)。 |
cr | false | 検索を制限する 1 つまたは複数の国を定義します。country{2 文字の大文字の国コード} と | を区切り文字として使用します(例: countryFR|countryDE はフランス語とドイツ語のページのみを検索します)。 |
lr | false | 検索を制限する 1 つまたは複数の言語を定義します。lang_{2 文字の言語コード} と | を区切り文字として使用します(例: lang_fr|lang_de はフランス語とドイツ語のページのみを検索します)。 |
tbs | false | (検索対象)通常のクエリフィールドでは不可能な高度な検索パラメータを定義します(例: 特許、日付、ニュース、動画、画像、アプリ、またはテキストコンテンツの高度な検索)。 |
safe | false | 成人向けコンテンツのフィルタリングレベルを定義します。active または off に設定できます。デフォルトでは、Google は露骨なコンテンツをぼかします。 |
nfpr | false | 元のクエリのスペルが間違っている場合、自動修正されたクエリからの結果を除外します。これらの結果を除外する場合は 1 に、含める場合は 0(デフォルト)に設定します。他の結果が利用できない場合、自動修正された結果を常に防止できるわけではありません。 |
filter | false | 「類似の結果」と「省略された結果」のフィルタをオンにするかオフにするかを定義します。有効にする場合は 1(デフォルト)、無効にする場合は 0 に設定します。 |
tbm | false | (一致対象)検索のタイプを定義します。設定可能な値: (tbm なし)通常の Google 検索、isch: Google Images API、lcl: Google Local API、vid: Google Videos API、nws: Google News API、shop: Google Shopping API、pts: Google Patents API、またはその他の Google サービス。 |
start | false | ページネーションの結果オフセットを定義します(例: 0(デフォルト)は 1 ページ目、10 は 2 ページ目、20 は 3 ページ目)。Google ローカル検索結果は 20 の倍数のみを受け入れます。 |
device | false | 結果を取得するために使用するデバイスを定義します。現在、デスクトップ版のみをサポートしています。 |
完全なリファレンス: Scrapeless API ドキュメントの API パラメータ。