SerpBase

Google News Search — Referencia de API

POST
Disponible
/google/news/search

Noticias

Busca Google News por tema o palabras clave. Los artículos y editores dependen del origen.

type
news
result
news
Facturacion
1 credits

Busca Google News por tema o palabras clave. Los artículos y editores dependen del origen.

Parametros
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: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
Abrir en Playground
Campos de respuesta
query
requerido
string

requerido

Consulta normalizada de la solicitud.

page
requerido
number

requerido

Numero de pagina actual desde 1.

news
opcional
NewsResult[]

Cuando se analizan noticias.

Resultados de Google Noticias.

NewsResult Schema de item
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.

source
opcional
string

Cuando se analiza el editor.

Etiqueta de editor u origen.

time
opcional
string

Cuando Google expone texto de tiempo.

Texto original de publicación.

published_at
opcional
string

Alias del tiempo analizado, si existe.

Alias del tiempo de publicación normalizado.

snippet
opcional
string

Cuando se analiza un fragmento.

Fragmento de resumen del artículo.

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.

Ejemplos de código y respuesta
bash
curl -X POST 'https://api.serpbase.dev/google/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
Ejemplo existente de Google
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
Notas

Monitoreo de marca, tendencias y medios.

Origen y tiempo se analizan de metadatos compactos de Google; ambos son opcionales.