SerpBase

Google Images Search — Referência da API

POST
Disponível
/google/image/search

Imagens

Busque imagens e links de origem no Google. Os links não concedem direitos de uso.

type
images
result
images
Cobranca
1 credits

Busque imagens e links de origem no Google. Os links não concedem direitos de uso.

Parametros
q
obrigatorio
string

obrigatorio

Texto da busca.

hl
opcional
string

opcional

Codigo de idioma. Padrao: en.

gl
opcional
string

opcional

Codigo do pais. Padrao: us.

page
opcional
number

opcional

Numero da pagina a partir de 1. Padrao: 1.

query
exemplo
string

Exemplo do catálogo; a API valida campos obrigatórios.

exemplo: "red pandas"

json
{
  "query": "red pandas"
}
Abrir no Playground
Campos da resposta
query
obrigatorio
string

obrigatorio

Consulta normalizada da requisicao.

page
obrigatorio
number

obrigatorio

Numero da pagina atual a partir de 1.

images
opcional
ImageResult[]

Quando imagens são analisadas.

Resultados do Google Imagens.

ImageResult Schema do item
rank
obrigatorio
number

obrigatorio

Posicao no ranking a partir de 1 nesta resposta.

position
opcional
number

Alias de rank quando disponivel.

Alias normalizado para clientes que esperam position.

title
opcional
string

Quando titulo ou alt da imagem e analisado.

Titulo do resultado.

link
obrigatorio
string

obrigatorio

Link principal retornado pelo parser.

url
opcional
string

Presente quando o link pode ser normalizado.

URL canonica de destino, normalmente igual a link.

source_url
opcional
string

Somente quando uma URL fonte do Google e observada.

URL original do Google para depuracao e procedencia.

display_url
opcional
string

Quando texto visivel ou dominio pode ser derivado.

URL visivel ou dominio de origem.

image_url
obrigatorio
string

obrigatorio

URL da imagem completa.

thumbnail_url
opcional
string

Quando o Google expoe uma miniatura.

URL da miniatura.

thumbnail
opcional
string

Alias de thumbnail_url quando disponivel.

Alias normalizado da miniatura.

source
opcional
string

Quando texto de origem é analisado.

Rótulo de origem da imagem.

domain
opcional
string

Quando é possível obter o domínio de origem.

Domínio da página de origem.

Exemplos de código e resposta
bash
curl -X POST 'https://api.serpbase.dev/google/image/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"red pandas"}'
Exemplo existente do Google
bash
curl -X POST https://api.serpbase.dev/google/image/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "iphone 15 pro blue",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
Notas

Busca visual, monitoramento de produtos e fontes.

Alguns formatos expõem apenas rank/link, não todos os aliases. Trate url, display_url, source_url, position e thumbnail como opcionais.