Google Images

engine=google_images

Retorna resultados de Google Search como JSON estruturado, a partir do mesmo endpoint que atende cada motor.

Requisição

GET

Parâmetros

Enviar este parâmetro	Chave	Valor	Descrição
Autorização
	api_keyobrigatório		SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'. Esta é a chave do SearchApi do próprio autor, deixada aqui de propósito para que você possa executar esta página de verdade sem se cadastrar. Substitua pela sua para executar na sua própria conta — a chave que estiver nesta linha é a que gasta créditos ao executar ao vivo, e a que o endereço acima e cada amostra de código carregam, então uma chave colada aqui também viaja em um link que você compartilhe. Executar, ao lado, responde a partir de uma gravação e não gasta nada.
	api_key_preset	padrão	Qual chave de demonstração enviar. A chave funcional resolve a amostra gravada; as outras duas resolvem os envelopes 401 e 429 gravados, então o caminho até um estado de erro é o caminho real de quem chama.
Obrigatório
	qobrigatório		Search query; most engines accept native operators and advanced filters.
Segmentação Só o que você define é enviado. Devolver à API os próprios padrões dela despacharia uma dúzia de parâmetros que você nunca escolheu e enterraria os que escolheu.
	google_domain	padrão	Google domain to query, e.g. google.com, google.de.
	gl	padrão	Country of the search (two-letter country code).
	hl	padrão	Interface language of the search (two-letter language code).
	location		Geographic origin of the search; canonical names come from the Locations API.
Filtros
	safe		Adult content filtering level.
Tempo
	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).
Paginação
	page	padrão	Page number of the results.
Mais Todo o resto que este motor aceita, na ordem do catálogo.
	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

Nada foi executado ainda. Envie a requisição para ver a resposta gravada.

Executar responde a partir de uma gravação servida do disco. Para chamar a API de verdade, cole sua própria chave na execução ao vivo abaixo.

Código

cURL

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

Apenas os parâmetros obrigatórios e os que você define são enviados — a requisição nunca repete para a API os padrões dela mesma.

Use a partir de um agente

Todos os motores do catálogo são alcançáveis a partir de um agente que você já tem aberto. Conecte uma vez e depois pergunte com palavras.

Conectar

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

Crie sua MCP URL em https://www.searchapi.io/integrations/mcp e cole por cima do espaço reservado. O fluxo de conexão é OAuth, então sua chave de API nunca entra na configuração do seu cliente.

Perguntar

Usando o motor Google Images da SearchApi, execute esta busca e resuma os resultados: q = "coffee"

Acompanha a requisição acima — mude um parâmetro e isto muda junto.

Chamar

Ambos descrevem a requisição que o formulário acima monta.

O servidor MCP da SearchApi foi lido em 2026-08-11: remoto sobre Streamable HTTP, mais de 80 ferramentas, conexão OAuth. Quais motores a lista de ferramentas dele cobre não foi verificado aqui.

Parâmetros

15 parâmetros, lidos do catálogo no momento da renderização.

Parâmetros aceitos pelo motor google_images
Parâmetro	Tipo	Descrição
qobrigatório	string	Search query; most engines accept native operators and advanced filters.
google_domain	string	Google domain to query, e.g. google.com, google.de. padrão: google.com
gl	enum	Country of the search (two-letter country code). us (padrão) af al dz as ad ao ai aq ag ar am mais 227 valores
hl	enum	Interface language of the search (two-letter language code). en (padrão) af ak sq am ar hy az eu be bem bn mais 134 valores
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. padrão: 1

Toda requisição também carrega

Três parâmetros estão em todos os motores do catálogo: o motor chamado, a chave que autentica a chamada e a opção de retenção enterprise.

Parâmetros comuns a todos os motores
Parâmetro	Tipo	Descrição
engineobrigatório	string	Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE keys).
api_keyobrigatório	string	SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.
zero_retention	boolean	Enterprise-only: disables all logging and persistent storage of the search. padrão: false