Google Documentação e Diretório de Endpoints da API de Imagens do Google Pesquisar API

prod-global

GET

/api/v1/google/images/search

Status de saúde da API

Saudável Disponível Limitado Quase indisponível Sem dados

Carregando status...

Obtenha dados de pesquisa de imagens do Google, incluindo URLs de imagens e metadados, para descoberta filtrada de imagens em fluxos de trabalho de pesquisa e monitoramento.

Tags: Imagens do Google

Parâmetros

Nome	Obrigatório	Tipo	Padrão	Descrição
query	Sim	string		A consulta de pesquisa para imagens (ex.: 'paisagem de montanha', 'carros de luxo').
html	Não	boolean	false	Defina como true para retornar o HTML bruto da página de resultados de pesquisa do Google junto com os dados estruturados.
page	Não	integer	0	O número da página de resultados. Use 0 para a primeira página, 1 para a segunda e assim por diante.
domain	Não	string	google.com	O domínio do Google a ser usado para a pesquisa (ex.: 'google.com', 'google.co.uk'). Veja Domínios do Google.
country	Não	string	us	Defina o código do país de destino (ex.: 'us', 'uk') para localizar os resultados. Veja Países do Google.
cr	Não	string		Limita os resultados a resultados de pesquisa de países específicos. Formato: 'countryXX'. Veja Países CR do Google.
language	Não	string	en	Defina o idioma dos resultados usando seu código de duas letras (ex.: 'en' para inglês, 'fr' para francês). Veja Idioma do Google.
lr	Não	string		Restrinja os resultados a um ou mais idiomas usando o formato 'lang_{código_do_idioma}' (ex.: 'lang_en'). Consulte Google LR Language.
uule	Não	string		String de localização codificada (UULE) usada para localizar precisamente os resultados da pesquisa do Google. Este é um parâmetro avançado/técnico — se você não estiver familiarizado com ele, pode deixá-lo vazio e omiti-lo.
period_unit	Não	string		Unidade de tempo para resultados de imagens recentes. Valores disponíveis: - SECOND: Segundo. O valor legado s também é aceito. - MINUTE: Minuto. O valor legado n também é aceito. - HOUR: Hora. O valor legado h também é aceito. - DAY: Dia. O valor legado d também é aceito. - WEEK: Semana. O valor legado w também é aceito. - MONTH: Mês. O valor legado m também é aceito. - YEAR: Ano. O valor legado y também é aceito.
period_value	Não	string		Valor de duração de tempo usado com 'period_unit' (ex.: 15 para 15 dias). Padrão: 1.
start_date	Não	string		Data de início para restringir imagens a um intervalo de tempo. Formato: 'YYYYMMDD' (ex.: '20241201').
end_date	Não	string		Data final para restringir imagens a um intervalo de tempo. Formato: 'YYYYMMDD' (ex.: '20241231').
chips	Não	string		Termos de pesquisa sugeridos adicionais (chips) para filtrar imagens. Os valores são obtidos de respostas anteriores.
tbs	Não	string		Parâmetro de filtro de pesquisa avançada (tbs) usado para aplicar filtros de resultados do Google (ex.: intervalo de tempo). Este é um parâmetro avançado — se você não estiver familiarizado com ele, pode deixá-lo vazio.
imgar	Não	string		Filtrar por proporção de aspecto da imagem. Valores disponíveis: - SQUARE: Imagens quadradas. O valor legado s também é aceito. - TALL: Imagens altas. O valor legado t também é aceito. - WIDE: Imagens largas. O valor legado w também é aceito. - PANORAMIC: Imagens panorâmicas. O valor legado xw também é aceito.
imgsz	Não	string		Filtrar por tamanho da imagem. Valores disponíveis: - LARGE: Imagens grandes. O valor legado l também é aceito. - MEDIUM: Imagens médias. O valor legado m também é aceito. - ICON: Imagens do tamanho de ícone. O valor legado i também é aceito.
image_color	Não	string		Filtrar imagens por uma cor dominante (ex.: 'red', 'blue', 'bw' para preto e branco, 'trans' para transparente).
image_type	Não	string		Filtrar por tipo de imagem. Valores suportados: 'face', 'photo', 'clipart', 'lineart', 'animated'.
licenses	Não	string		Filtrar por direitos de uso e licenças. Valores disponíveis: - FREE_TO_USE: Livre para uso. O valor legado f também é aceito. - COMMERCIAL_USE: Uso comercial. O valor legado fc também é aceito. - CREATIVE_COMMONS: Creative Commons. O valor legado cl também é aceito.
safe	Não	string	OFF	Configuração do filtro SafeSearch. Valores disponíveis: - ACTIVE: Filtrar conteúdo adulto. O valor legado active também é aceito. - OFF: Desabilitar a filtragem do SafeSearch. O valor legado off também é aceito.
nfpr	Não	string	INCLUDE_CORRECTED_RESULTS	Controla a autocorreção do Google. Valores disponíveis: - INCLUDE_CORRECTED_RESULTS: Incluir resultados corrigidos. O valor legado 0 também é aceito. - EXCLUDE_CORRECTED_RESULTS: Excluir resultados corrigidos. O valor legado 1 também é aceito.
filter	Não	string		Alternar filtragem de resultados semelhantes e omitidos. Valores disponíveis: - DISABLED: Desabilitar filtragem de resultados semelhantes e omitidos. O valor legado 0 também é aceito. - ENABLED: Habilitar filtragem de resultados semelhantes e omitidos. O valor legado 1 também é aceito.

Copiar requisição

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/images/search?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/images/search?query=coffee", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://api.justserpapi.com/api/v1/google/images/search"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

PHP

<?php
$url = "https://api.justserpapi.com/api/v1/google/images/search?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/images/search?query=coffee", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Resposta

Carregando o exemplo de resposta mais recente...