Google Images

engine=google_images

Google Search の結果を構造化 JSON で返します。すべてのエンジンが応答するのと同じエンドポイントからです。

リクエスト

GET

パラメータ

このパラメータを送信	キー	値	説明
認証
	api_key必須		SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'. これは作者自身の SearchApi キーです。登録なしでこのページを実際に実行できるよう、意図的に置いてあります。ご自身のアカウントで実行するには、自分のキーに置き換えてください — この行にあるキーが「ライブ実行」でクレジットを消費するキーであり、上のアドレスとすべてのコードサンプルが運ぶキーでもあります。したがって、ここに貼り付けたキーは共有したリンクにも入ります。隣の「実行」は記録から応答し、何も消費しません。
	api_key_preset	既定	どのデモキーを送るか。動作するキーは記録済みサンプルを、他の 2 つは記録済みの 401 と 429 のエンベロープを返します。エラー状態への道筋が、呼び出す側の実際の道筋になります。
必須
	q必須		Search query; most engines accept native operators and advanced filters.
ターゲティング送信されるのはあなたが設定したものだけです。API 自身の既定値を送り返せば、選んでもいない十数個のパラメータが送られ、選んだものが埋もれてしまいます。
	google_domain	既定	Google domain to query, e.g. google.com, google.de.
	gl	既定	Country of the search (two-letter country code).
	hl	既定	Interface language of the search (two-letter language code).
	location		Geographic origin of the search; canonical names come from the Locations API.
フィルタ
	safe		Adult content filtering level.
期間
	time_period		Restricts results by recency; custom uses time_period_min/max.
	time_period_min		Start date for time_period=custom (MM/DD/YYYY).
	time_period_max		End date for time_period=custom (MM/DD/YYYY).
ページネーション
	page	既定	Page number of the results.
その他このエンジンが受け付ける残りすべてを、カタログの順で。
	uule		Encoded location cookie; alternative to `location` (do not use both).
	image_size		Filter by image size.
	image_type		Filter by image type.
	image_color		Filter by dominant color.
	usage_rights		Filter by license/usage rights.

JSON

まだ何も実行されていません。リクエストを送信すると記録済みレスポンスが表示されます。

「実行」はディスクから返す記録に応答します。実際に API を呼ぶには、下の「ライブ実行」に自分のキーを貼り付けてください。

コード

cURL

curl "https://www.searchapi.io/api/v1/search?engine=google_images&q=coffee&api_key=E5oa7LbhkKN7YUyj4CwXppK8"

送信されるのは必須パラメータとあなたが設定したパラメータだけです — リクエストが API 自身の既定値を API に送り返すことはありません。

エージェントから使う

カタログのすべてのエンジンは、すでに開いているエージェントから利用できます。一度接続すれば、あとは言葉で尋ねるだけです。

接続する

claude mcp add searchapi "<YOUR_MCP_URL>" --transport http

https://www.searchapi.io/integrations/mcp で MCP URL を作成し、プレースホルダーに上書きしてください。接続フローは OAuth なので、API キーがクライアントの設定に入ることはありません。

尋ねる

SearchApi の Google Images エンジンでこの検索を実行し、結果を要約してください: q = "coffee"

上のリクエストに追随します — パラメータを変えれば、これも一緒に変わります。

呼び出す

どちらも上のフォームが組み立てるリクエストを記述しています。

SearchApi の MCP サーバーは 2026-08-11 に確認しました。Streamable HTTP によるリモート、80 以上のツール、OAuth 接続です。そのツール一覧がどのエンジンを含むかは、ここでは検証していません。

パラメータ

15 個のパラメータを、レンダリング時にカタログから読み出しています。

google_images エンジンが受け付けるパラメータ
パラメータ	型	説明
q必須	string	Search query; most engines accept native operators and advanced filters.
google_domain	string	Google domain to query, e.g. google.com, google.de. 既定値: google.com
gl	enum	Country of the search (two-letter country code). us (既定) af al dz as ad ao ai aq ag ar am 他 227 件の値
hl	enum	Interface language of the search (two-letter language code). en (既定) af ak sq am ar hy az eu be bem bn 他 134 件の値
location	string	Geographic origin of the search; canonical names come from the Locations API.
uule	string	Encoded location cookie; alternative to `location` (do not use both).
safe	enum	Adult content filtering level. active off
image_size	enum	Filter by image size. large medium icon
image_type	enum	Filter by image type. face photo clipart lineart animated
image_color	string	Filter by dominant color.
usage_rights	enum	Filter by license/usage rights. creative_commons commercial
time_period	enum	Restricts results by recency; custom uses time_period_min/max. last_hour last_day last_week last_month last_year custom
time_period_min	string	Start date for time_period=custom (MM/DD/YYYY).
time_period_max	string	End date for time_period=custom (MM/DD/YYYY).
page	integer	Page number of the results. 既定値: 1

どのリクエストにも含まれるもの

カタログのすべてのエンジンに共通するパラメータが 3 つあります。呼び出すエンジン、呼び出しを認証するキー、そしてエンタープライズ向けの保持設定です。

すべてのエンジンに共通するパラメータ
パラメータ	型	説明
engine必須	string	Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE keys).
api_key必須	string	SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.
zero_retention	boolean	Enterprise-only: disables all logging and persistent storage of the search. 既定値: false