Google Web Search — Referencia de API

POST

Disponible

/google/search

Search

Busca Google con q, idioma hl, país gl y dispositivo admitido. Las secciones dependen de la consulta y del origen.

type

result

organic

Facturacion

1 credits

Busca Google con q, idioma hl, país gl y dispositivo admitido. Las secciones dependen de la consulta y del origen.

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.

device

opcional

"default" | "pc" | "mobile"

opcional

Solo para Google Search. default usa enrutamiento automatico, pc usa sesiones de escritorio y mobile usa sesiones moviles.

json

{
  "device": "mobile",
  "gl": "us",
  "hl": "en",
  "q": "coffee shops"
}

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.

organic

opcional

OrganicResult[]

Cuando se analizan resultados orgánicos.

Resultados orgánicos.

featured_snippet

opcional

FeaturedSnippet

Cuando Google muestra un fragmento destacado.

Tarjeta de respuesta destacada, separada de resultados orgánicos.

top_stories

opcional

TopStory[]

Cuando hay noticias destacadas en los resultados.

Módulo de noticias destacadas.

people_also_ask

opcional

PAA[]

Cuando hay preguntas relacionadas.

Pregunta, respuesta y enlaces de origen.

knowledge_graph

opcional

KnowledgeGraph

Cuando se analiza un panel de conocimiento.

Datos del panel de entidad.

related_searches

opcional

string[]

Cuando hay sugerencias relacionadas.

Consultas relacionadas.

OrganicResult 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

requerido

string

requerido

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.

display_link

opcional

string

Cuando hay texto visible de Google.

Texto original del enlace mostrado por Google.

snippet

opcional

string

Cuando se analiza un fragmento.

Resumen del resultado orgánico.

date

opcional

string

Cuando Google incluye fecha en el fragmento.

Texto de fecha original del fragmento.

published_at

opcional

string

Alias de fecha analizada, si existe.

Alias de fecha normalizada.

icon

opcional

string

Cuando se expone un favicon o imagen.

URL del icono del resultado.

sitelinks

opcional

{ title, link, url, source_url?, display_url? }[]

Cuando hay enlaces de sitio.

Enlaces de sitio anidados del resultado.

Ejemplos de código y respuesta

bash

curl -X POST 'https://api.serpbase.dev/google/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'

Ejemplo existente de Google

bash

curl -X POST https://api.serpbase.dev/google/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio",
    "hl": "en",
    "gl": "us",
    "page": 1,
    "device": "default"
  }'

Notas

Grounding, SEO y extraccion de respuestas.

También puede devolver ai_overview, weather, finance, flight y result_stats si aparecen en los resultados.