Google Images Search — Referencia de API

POST

Disponible

/google/image/search

Imagenes

Busca imágenes y enlaces de origen en Google. Los enlaces no otorgan derechos de uso.

type

images

result

images

Facturacion

1 credits

Busca imágenes y enlaces de origen en Google. Los enlaces no otorgan derechos de uso.

Parametros

CampoTipoDisponibilidadDescripcion

q

requerido

string

requerido

Texto de busqueda.

hl

opcional

string

opcional

Codigo de idioma. Predeterminado: en.

gl

opcional

string

opcional

Codigo de pais. Predeterminado: us.

page

opcional

number

opcional

Numero de pagina desde 1. Predeterminado: 1.

query

ejemplo

string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "red pandas"

json

{
  "query": "red pandas"
}

Abrir en Playground

Campos de respuesta

CampoTipoDisponibilidadDescripcion

query

requerido

string

requerido

Consulta normalizada de la solicitud.

page

requerido

number

requerido

Numero de pagina actual desde 1.

images

opcional

ImageResult[]

Cuando se analizan imágenes.

Resultados de Google Imágenes.

ImageResult Schema de item

CampoTipoDisponibilidadDescripcion

rank

requerido

number

requerido

Posicion de ranking desde 1 en esta respuesta.

position

opcional

number

Alias de rank cuando esta disponible.

Alias normalizado para clientes que esperan position.

title

opcional

string

Cuando se parsea titulo o alt de la imagen.

Titulo del resultado.

link

requerido

string

requerido

Enlace principal devuelto por el parser.

url

opcional

string

Presente cuando el enlace se puede normalizar.

URL canonica de destino, normalmente igual a link.

source_url

opcional

string

Solo cuando se observa una URL fuente de Google.

URL original de Google para depuracion y procedencia.

display_url

opcional

string

Cuando se deriva texto visible o dominio.

URL visible o dominio fuente.

image_url

requerido

string

requerido

URL de imagen completa.

thumbnail_url

opcional

string

Cuando Google expone una miniatura.

URL de miniatura.

thumbnail

opcional

string

Alias de thumbnail_url cuando esta disponible.

Alias normalizado de miniatura.

source

opcional

string

Cuando se analiza texto de origen.

Etiqueta de origen de imagen.

domain

opcional

string

Cuando se puede obtener el dominio de origen.

Dominio de la página de origen.

Ejemplos de código y respuesta

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"}'

Ejemplo existente de 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

Busqueda visual, monitoreo de productos y fuentes.

Algunos formatos solo exponen rank/link, no todos los alias. Trata url, display_url, source_url, position y thumbnail como opcionales.